This guide is for people who want to run RSS Bridge using Docker. If you want to run it a simple PHP Webhost environment, see Installation instead.


Create the container

docker create \
--name=rss-bridge \
--volume </local/custom/path>:/config \
--publish 3000:80 \

Run it

docker start rss-bridge

And access it using http://IP_Address:3000. If you’d like to run a specific version, you can run it by:

docker create \
--name=rss-bridge \
--volume </local/custom/path>:/config \
--publish 3000:80 \

Where you can get the versions published to Docker Hub at The server runs on port 80 internally, and you can publish it on a different port (change 3000 to your choice).

You can run it using a docker-compose.yml as well:

version: '2'
    image: rssbridge/rss-bridge:latest
      - </local/custom/path>:/config
      - 3000:80
    restart: unless-stopped

Container access and information

Function Command
Shell access (live container) docker exec -it rss-bridge /bin/sh
Realtime container logs docker logs -f rss-bridge

Adding custom bridges and configurations

If you want to add a bridge that is not part of /bridges, you can specify an additional folder to copy necessary files to the rss-bridge container.

Here root is folder where docker-compose.yml resides.

  1. Create custom folder in root.
  2. Copy your bridges files to the custom folder. You can also add your custom whitelist.txt file and your custom config.ini.php to this folder.
  3. Run docker-compose up to recreate service.