A modern web UI for rTorrent with a Node.js backend and React frontend.
JavaScript CSS
Latest commit 390b118 Jan 20, 2017 @jfurrow committed on GitHub Merge pull request #226 from jfurrow/john/bug/firefox-context-menu
Check which mouse button triggers context menu dismissal for Firefox



Talk about Flood on Slack

Flood is another web interface for rtorrent. It implements a Node.js server for communicating with the rTorrent API, storing historical data, and serving the web UI.

It's a work-in-progress, and it might not have all of the features you want (yet). However, new features are added frequently. Feel free to file an issue and I'll try to prioritize your feature requests.


If you have a specific issue or bug, please file a Github issue. If you want to participate in discussions about Flood's future, please join the Flood Slack team (get an instant invite first).



  1. rTorrent needs to be installed with XMLRPC configuration. If you are currently using a web UI for rTorrent, you've already done this.
  2. Install NodeJS version 6.9.x:
    • I recommend managing different Node versions with nvm or n.


  1. Copy config.template.js to config.js. This is required.
  2. Set your rTorrent SCGI hostname and port in config.js. Defaults are localhost and 5000.
    • If you want to use a socket, change socket to true and set socketPath to the absolute file path of your rTorrent socket. Make sure Flood has read/write access. Specify the socket path in .rtorrent.rc. Example: scgi_local = /Users/flood/rtorrent.sock
    • If you wish to access an rTorrent instance running on a separate host from Flood (or in a Docker container), allow for incoming connections from external IPs by setting the host in scgi_port to in .rtorrent.rc. Example: scgi_port =
  3. Create a long, unique secret (used to sign JWT auth tokens) in config.js.

Starting the Server

  1. Run npm install --production.
  2. Run npm start.
  3. Access the UI in your browser. Defaults to localhost:3000.
    • You may change the default port in config.js.
  4. Upon loading the UI the first time, you will be prompted to create a user account.


  1. To update, run git pull in this repository's directory.
  2. Check config.template.js for configuration changes that you may wish to incoporate in your config.js.
  3. Kill the running Node server.
  4. Run npm install --production to update dependencies.
  5. Restart it with npm start.


  • I run the web server with screen to keep the web server running independently of the terminal session.
  • Ubuntu users will need to install nodejs-legacy (sudo apt-get install nodejs-legacy) for dependencies to install successfully. You can read more on this Stack Overflow post.

Local Development

  1. Run npm install.
  2. Run npm start:development and npm run start:watch in separate terminal instances.
    • npm start:development uses nodemon to watch for changes to the server-side JavaScript.
    • npm run start:watch watches for changes in the client-side source.
  3. Access the UI through the browser-sync proxy at localhost:4200.