rclone-serve

Overview

A fully self-contained rclone appliance: rclone's own official web GUI for guided remote setup (OAuth flows for OneDrive/Google Drive/Dropbox/etc. included) plus `rclone serve` to expose a configured remote over a protocol other tools already speak - most usefully restic's own REST backend - so restic can talk to a cloud provider it has no native driver for directly, without a separate scheduled sync job in between. Owns its own config entirely; no dependency on any other rclone install.

Requirements

Nothing pre-existing - point Config Path at an empty directory and configure your first remote through the web GUI after starting the container.

Related apps

Explore more like this

Explore all

Utilities apps

Links

Projectgit.home.hudsonstreet.co.nz Docker Hubhub.docker.com Templateraw.githubusercontent.com

Details

Repository

mcjoppy/rclone-serve

Registry

https://hub.docker.com/repository/docker/mcjoppy/rclone-serve

Last Updated2026-09-25

First Seen2026-09-23

Runtime arguments

Web UI: http://[IP]:[PORT:5572]
Network: bridge
Shell: sh
Privileged: false

Template configuration

GUI PortPorttcp

Port for rclone's own web GUI (guided remote setup)

Target: 5572
Default: 5572
Value: 5572

Serve PortPorttcp

Port rclone serve listens on

Target: 8080
Default: 8080
Value: 8080

Config PathPathrw

Where this container's own rclone.conf and settings are stored - independent of any other rclone install

Target: /config
Default: /mnt/user/appdata/rclone-serve
Value: /mnt/user/appdata/rclone-serve

GUI UserVariable

Basic auth username for the config GUI - this is full control over your remotes' credentials

Target: RCLONE_GUI_USER

GUI PasswordVariable

Basic auth password for the config GUI

Target: RCLONE_GUI_PASS

RemoteVariable

The remote:path to serve, e.g. onedrive:backups - doesn't need to exist yet, just needs to be created eventually via the GUI

Target: RCLONE_REMOTE

Serve UserVariable

Basic auth username for the serve endpoint

Target: RCLONE_SERVE_USER

Serve PasswordVariable

Basic auth password for the serve endpoint

Target: RCLONE_SERVE_PASS

Serve ProtocolVariable

restic, http, webdav, or sftp only - other rclone serve modes lack a compatible auth model and are rejected

Target: RCLONE_SERVE_PROTOCOL
Default: restic
Value: restic

Extra ArgsVariable

Extra flags passed straight through to rclone serve

Target: RCLONE_SERVE_EXTRA_ARGS

Library

Curated

Categories