Skip to content
Klutch.sh Docs

Deploying Redlib

Introduction

Redlib is a private, lightweight Reddit frontend that allows you to browse Reddit without tracking, advertisements, or JavaScript. As a spiritual successor to Libreddit, Redlib provides a clean, fast interface for reading Reddit content while respecting your privacy.

Key features of Redlib include:

  • Privacy First: No tracking, ads, or JavaScript required
  • Fast Performance: Lightweight and responsive
  • Clean Interface: Distraction-free reading experience
  • No Reddit Account Needed: Browse without logging in
  • Subreddit Support: Access all public subreddits
  • User Pages: View user profiles and history
  • Comment Threads: Full discussion support
  • Dark Mode: Built-in theme options
  • Search: Search Reddit content
  • RSS Feeds: Generate feeds for subreddits

This guide walks through deploying Redlib on Klutch.sh using Docker and setting up your private Reddit frontend.

Prerequisites

Before deploying Redlib on Klutch.sh, ensure you have:

Deploying Redlib on Klutch.sh

    Create Your Dockerfile

    Create a Dockerfile in your repository:

    FROM quay.io/redlib/redlib:latest
    

    # Environment configuration
    ENV REDLIB_DEFAULT_THEME=dark
    ENV REDLIB_DEFAULT_FRONT_PAGE=popular
    ENV REDLIB_DEFAULT_LAYOUT=card
    ENV REDLIB_DEFAULT_SHOW_NSFW=off
    

    # Expose the web interface
    EXPOSE 8080

    Push Your Repository to GitHub

    Commit and push your Dockerfile to your GitHub repository.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project named “redlib”.

    Create a New App

    Create a new app within your project and connect your GitHub repository.

    Configure HTTP Traffic

    In the deployment settings:

    • Select HTTP as the traffic type
    • Set the internal port to 8080

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    REDLIB_DEFAULT_THEMEdark or light
    REDLIB_DEFAULT_FRONT_PAGEpopular, all, or subreddit name
    REDLIB_DEFAULT_LAYOUTcard, clean, or compact
    REDLIB_DEFAULT_SHOW_NSFWon or off
    REDLIB_ROBOTS_DISABLE_INDEXINGon (recommended)

    Deploy Your Application

    Click Deploy to build and start your Redlib instance.

    Access Redlib

    Once deployment completes, access your instance at https://your-app-name.klutch.sh.

Using Redlib

Browsing Reddit

Access subreddits by adding the subreddit name to your URL:

  • Homepage: https://your-app-name.klutch.sh
  • Subreddit: https://your-app-name.klutch.sh/r/subreddit
  • User: https://your-app-name.klutch.sh/user/username
  • Post: https://your-app-name.klutch.sh/r/subreddit/comments/...

Browser Extension

Redirect Reddit links automatically:

  1. Install a redirect extension like “Redirector”
  2. Add a rule to redirect reddit.com to your Redlib instance
  3. All Reddit links now open in Redlib

RSS Feeds

Generate RSS feeds for subreddits:

  • Add .rss to any subreddit URL
  • Example: https://your-app-name.klutch.sh/r/technology.rss

Customization

User Preferences

Set preferences via URL parameters or cookies:

  • Theme: ?theme=dark or ?theme=light
  • Layout: ?layout=card or ?layout=compact
  • NSFW: ?show_nsfw=on or ?show_nsfw=off

Additional Resources

Conclusion

Deploying Redlib on Klutch.sh provides a privacy-focused Reddit frontend with automatic builds and secure HTTPS access. Browse Reddit content without tracking, ads, or JavaScript while maintaining complete control over your browsing experience.