Cloudreve

Last reviewed Sep 13, 2026 · 771 words

Cloudreve does not sync anything. It is a web drive: you upload through the browser, organise folders, hand out share links, and mount it over WebDAV. There is no desktop client watching a folder, and if the mental model you arrived with is Dropbox, that is the first thing to unlearn. The mental model that fits is Google Drive's web interface, backed by whatever storage you already pay for, running from a single Go binary that idles in a fraction of its 512 MB rating.

Storage policies are the reason to choose it

Every other feature is table stakes. Storage policies are the differentiator: an admin defines where files physically go, and each user group is assigned a policy. Local disk is the default. S3 and compatible object stores, OneDrive, and several Chinese cloud providers are built in, and a "remote" policy lets a second Cloudreve node hold the files while the main one serves the interface. For the cloud backends, uploads and downloads can go straight between the browser and the provider using signed URLs, so a 2 GB video does not pass through your 100 Mbps VPS at all. That is the design that lets a small server front terabytes of cheap object storage, and it is the reason people pick Cloudreve over the heavier alternatives.

First boot prints the password you need

services:
  cloudreve:
    image: cloudreve/cloudreve:latest
    ports:
      - "5212:5212"
    volumes:
      - ./data:/cloudreve/data
    restart: unless-stopped

Start it, then read the logs: the initial admin account is [email protected] and the generated password appears once in the container output. Copy it before you do anything else, log in on port 5212, change it, and only then start creating storage policies and user groups. SQLite is the default database and it is fine for a household; switch to Postgres or MySQL if you expect dozens of active users. Put the whole thing behind a reverse proxy with TLS, because share links and WebDAV credentials over plain HTTP are a bad idea.

Sharing is the polished part

Share links carry an optional password, an expiry, a download limit, and a preview for images, PDFs, video, and Office documents. Users get quotas per group, an upload throttle, and a per-group list of allowed storage policies. The interface is quick and looks like a commercial product, which matters more than it sounds when the users are family who did not ask for self-hosting. WebDAV gives you a mount point on any OS, and the mobile experience is a responsive web app rather than a native one. Aria2 integration lets you paste a torrent or a URL and have the server fetch it into your drive.

Two things to know before committing

Documentation is partly in Chinese, with the English pages complete for installation and thin for the finer points of storage policies; the community forums are where the details live. And the project has a Pro edition. The GPL-3.0 core is genuinely usable, but some features in the current line are gated behind it, and the boundary has moved with major versions. Check the feature comparison on the official site for the version you install, and do not assume a feature you saw in a screenshot is in the free build.

Where a bigger project is the safer choice

For a household that wants desktop and phone sync, calendars, and a plugin ecosystem, Nextcloud is the default for a reason, and the making Nextcloud fast guide fixes its one real weakness. If sync is the whole requirement and you do not need a web drive, Syncthing has no server and no web UI to secure. Seafile sits between them with a proper sync client and a library model. Cloudreve wins the specific case of "a fast, good-looking web drive over object storage for a few users", and the rest of the file sync category covers the other shapes of the problem.

What I'd do

Run Cloudreve when the storage is an S3 bucket or an OneDrive quota you already have and the users need share links more than sync. One container, SQLite, reverse proxy, the admin password rotated on day one, and a nightly backup of the data directory, which holds the database and any locally stored files. If I wanted a full Google Drive replacement with sync clients for the family, I would not stretch Cloudreve to do it; I would install Nextcloud and accept the extra RAM. The Google Drive alternatives page lays out that trade in more detail.