RSS-Bridge

Access

• Open your browser and visit: https://<SERVER_IP>
• A browser SSL warning is expected (self-signed certificate)
• Authentication is required (Basic Auth popup)
• Authentication method: HTTP Basic Auth
• Credentials are stored securely in: /root/.cloudzy-creds

Important Files & Directories

• Install Path: /root/rss-bridge
• Compose File: /root/rss-bridge/docker-compose.yml
• Config Directory: /root/rss-bridge/config
• Credentials File: /root/.rss-bridge-creds
• Nginx Config: /etc/nginx/sites-available/rss-bridge
• Basic Auth File: /etc/nginx/.rss-bridge.htpasswd
• SSL Certificate: /etc/nginx/ssl/rss-bridge.crt
• SSL Key: /etc/nginx/ssl/rss-bridge.key

Notes

• You can put custom config.ini.php and bridges into /root/rss-bridge/config.
• Only Nginx listens on public ports.
• Access is protected via Basic Auth.
• TLS uses a self-signed certificate.
• Credentials are stored with restrictive permissions.

Docker Management

Check containers:

docker ps

View logs:

docker logs -f rss-bridge

Restart services:

cd /root/rss-bridge
docker compose restart

Stop services:

cd /root/rss-bridge
docker compose down

Start services:

cd /root/rss-bridge
docker compose up -d

Enabling SSL with a Domain

1. Point your domain to the server IP.

2. Edit Nginx config and replace both server_name _; with your domain (server_name <yourdomain.com>) for both HTTP (port 80) and HTTPS (port 443) blocks:

vim /etc/nginx/sites-available/rss-bridge

3. Install Certbot:

apt install -y certbot python3-certbot-nginx

4. Run the following command to generate a valid Let's Encrypt certificate:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Replace SSL paths in Nginx config:

vim /etc/nginx/sites-available/rss-bridge
# Before:
    # ssl_certificate     /etc/nginx/ssl/rss-bridge.crt;
    # ssl_certificate_key /etc/nginx/ssl/rss-bridge.key;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Reload Nginx to apply the changes:

systemctl reload nginx

7. Open your browser and visit: https://yourdomain.com