Skip to content
Klutch.sh Docs

Deploying RSS-Bridge

Introduction

RSS-Bridge is a powerful, self-hosted tool that generates RSS and Atom feeds for websites that don’t offer native feed support. With over 300 built-in “bridges,” RSS-Bridge can create feeds from social media platforms, news sites, e-commerce sites, and virtually any web page with structured content.

Key features of RSS-Bridge include:

  • 300+ Bridges: Pre-built connectors for popular websites
  • Multiple Output Formats: RSS, Atom, JSON, and HTML output
  • Custom Bridges: Create your own bridges for specific sites
  • No API Keys Required: Most bridges work without authentication
  • Privacy Friendly: Access content without logging into platforms
  • Lightweight: Minimal resource requirements
  • Easy Integration: Works with any RSS reader
  • Active Development: Regular updates and new bridges

This guide walks through deploying RSS-Bridge on Klutch.sh using Docker and configuring feeds for your favorite websites.

Prerequisites

Before deploying RSS-Bridge on Klutch.sh, ensure you have:

Deploying RSS-Bridge on Klutch.sh

    Create Your Dockerfile

    Create a Dockerfile in your repository:

    FROM rssbridge/rss-bridge:latest
    

    # Enable all bridges (optional - remove for restricted access)
    ENV RSSBRIDGE_ENABLE_BRIDGE_WHITELIST=false
    

    # Set timezone
    ENV TZ=Etc/UTC
    

    # Expose the web interface
    EXPOSE 80

    Create Configuration File (Optional)

    For custom configuration, create a config.ini.php:

    [system]
    ; Enable or disable caching
    enable_cache = true
    

    ; Cache type (file or sqlite)
    cache_type = file
    

    ; Enable debug mode
    enable_debug = false
    

    [admin]
    ; Enable or disable bridge access restrictions
    enable_whitelist = false
    

    [http]
    ; HTTP request timeout
    timeout = 60
    

    ; User agent string
    user_agent = RSS-Bridge

    Push Your Repository to GitHub

    Commit and push your files to your GitHub repository.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project named “rss-bridge”.

    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 80

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    TZYour timezone (e.g., America/New_York)
    RSSBRIDGE_ENABLE_BRIDGE_WHITELISTfalse (or true for restricted access)

    Attach Persistent Volumes

    Add persistent storage for caching:

    Mount PathRecommended SizePurpose
    /app/cache5 GBFeed cache storage

    Deploy Your Application

    Click Deploy to build and start your RSS-Bridge instance.

    Access RSS-Bridge

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

Using RSS-Bridge

Some commonly used bridges include:

  • YouTube: Channel and playlist feeds
  • Twitter/X: User timeline feeds (may require configuration)
  • Reddit: Subreddit and user feeds
  • Instagram: User feeds
  • GitHub: Repository releases and activity
  • Bandcamp: Artist and album releases
  • Twitch: Channel activity

Generating a Feed

  1. Access your RSS-Bridge instance
  2. Select a bridge from the list
  3. Fill in the required parameters (username, URL, etc.)
  4. Choose the output format (RSS, Atom, JSON)
  5. Click “Generate Feed” to get the feed URL
  6. Add the URL to your RSS reader

Additional Resources

Conclusion

Deploying RSS-Bridge on Klutch.sh provides a powerful tool for generating RSS feeds from virtually any website. Take back control of your content consumption by creating feeds for social media, news sites, and more, all accessible through your preferred RSS reader.