Skip to content

Rclone WebUI ​

Rclone Web UI is a web interface for managing rclone from your browser: configure remotes (Google Drive, S3…), browse files, and monitor transfers and bandwidth. This guide runs Rclone Web UI in the background with Supervisor, listening only inside the server, and then accesses it through a domain with SSL.

Prerequisites ​

  • A connected server and a domain (or subdomain) whose DNS points to the server's IP, for example rclone.domain.com

Step 1: Install Rclone ​

Go to the server management page, click the Apps menu, select the Not Installed tab, find Rclone, then click Install. See Applications for details.

Step 2: Run Rclone Web UI with Supervisor ​

  1. Go to the server management page, click the Supervisor menu, then click the Create button
  2. In the New Supervisor dialog, fill in:
    • Description (Optional): e.g., Rclone Web UI
    • Command:
      bash
      rclone rcd --rc-web-gui --rc-web-gui-no-open-browser --rc-user admin --rc-pass password --rc-addr 127.0.0.1:5572
    • User: select root (the rclone configuration is set up for the root user)
    • Keep the other fields unchanged
  3. Click Save

Replace admin and password with the username and password you want to use (use a strong password, since Rclone Web UI has full access to your configured remotes).

TIP

--rc-addr 127.0.0.1:5572 makes Rclone Web UI listen only inside the server. You access it through the website in step 3, and port 5572 is not exposed to the Internet.

Step 3: Access Through a Domain ​

  1. Go to the server management page, click the Sites menu in the sidebar, then click the New Site button
  2. Enter the Domain Name (e.g., rclone.domain.com)
  3. Enter the Proxy Port: 5572
  4. Click Create Site
  5. On the new website's management page, click the SSL menu and install an SSL certificate so your login password is encrypted in transit

Verify the Result ​

Visit https://rclone.domain.com and log in with the username and password you set in step 2. The Dashboard screen shows the connection status to rclone.

Access Without a Domain ​

If you do not want to create a website, you can access Rclone Web UI through an SSH tunnel (first add an SSH Key to the server). On your computer, run:

bash
ssh -N -L 5572:127.0.0.1:5572 root@SERVER_IP

Keep this terminal window open, then visit http://localhost:5572 in your browser.

WARNING

Avoid changing --rc-addr to :5572 and opening port 5572 in the firewall: Rclone Web UI would then be reachable directly from the Internet over unencrypted HTTP, and your login password could leak.

Troubleshooting ​

  • 502 Bad Gateway: on the Supervisor page, check that the process is running; open the process's action menu and choose Show Log to see the error
  • Blank page on first run: on its first start, rclone downloads the web interface from GitHub, which takes a few seconds. Wait a moment, then reload the page