Cloudreve

File management and sharing system that supports several storage providers.

Replaces

Paid cloud file storage services, such as Dropbox.

All open-source alternatives to Dropbox

Difficulty

Difficulty: Medium

3 services (2 database or broker: postgres, redis), 3 volume mounts, no env values to set, no elevated host access. Heuristic score 4 of 11: medium.

Stack

Go (language), PostgreSQL (database), Redis (database)

Deployment

docker_compose

Requirements

Not stated.

License

GPL-3.0 (OSI-approved open source)

Read from github.com/cloudreve/cloudreve/blob/9f1e0b8/LICENSE

Business model

Unknown

The README at the pinned commit does not state a business model, so it stays unknown.

Source: github.com/cloudreve/cloudreve/blob/9f1e0b8/README.md, read on 2026-10-22.

Repository

cloudreve/cloudreve

GitHub stats

Stars: 28,867
Forks: 3,923
Open issues and pull requests: 149
Last push: 2026-10-20
Latest release: 4.19.1
Released: 2026-09-18

From the GitHub API on 2026-10-22. These numbers are a snapshot, not live. GitHub detected the license as GPL-3.0.

Compose file

Config check passed docker compose config exited 0 on this exact file on 2026-10-22.

docker-compose.yml Version 1

services:
  cloudreve:
    image: cloudreve/cloudreve:latest
    container_name: cloudreve-backend
    depends_on:
      - postgresql
      - redis
    restart: unless-stopped
    ports:
      - 5212:5212
      - 6888:6888
      - 6888:6888/udp
    environment:
      - CR_CONF_Database.Type=postgres
      - CR_CONF_Database.Host=postgresql
      - CR_CONF_Database.User=cloudreve
      - CR_CONF_Database.Name=cloudreve
      - CR_CONF_Database.Port=5432
      - CR_CONF_Redis.Server=redis:6379
    volumes:
      - backend_data:/cloudreve/data

  postgresql:
    # Best practice: Pin to major version. 
    # NOTE: For major version jumps:
    # backup & consult https://www.postgresql.org/docs/current/pgupgrade.html 
    image: postgres:17    
    container_name: postgresql
    restart: unless-stopped
    environment:
      - POSTGRES_USER=cloudreve
      - POSTGRES_DB=cloudreve
      - POSTGRES_HOST_AUTH_METHOD=trust
    volumes:
      - database_postgres:/var/lib/postgresql/data

  redis:
    image: redis:latest
    container_name: redis
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  backend_data:
  database_postgres:
  redis_data:

From the app's own repository: github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml.

Compose file from the app repository.

Install

Docker with the Compose plugin (github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml)
A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
Save the compose file as docker-compose.yml (github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml)
Use the compose file shown above.
Start it (github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml)
```
docker compose up -d
```
Open the app (github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml)
Open http://localhost:5212. The compose file publishes host port 5212 for the cloudreve service.

Compose file check: config_ok on 2026-10-22.

Gotchas and maintenance

Gotchas

Some images use the latest tag or no tag. Images without a pinned version: cloudreve: cloudreve/cloudreve:latest, redis: redis:latest. A later pull can get a different version. (github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml, checked 2026-10-22)
The compose file publishes host ports. Host ports: 5212 (cloudreve), 6888 (cloudreve), 6888/udp (cloudreve). A port without a host address listens on all host network interfaces. (github.com/cloudreve/cloudreve/blob/9f1e0b8/docker-compose.yml, checked 2026-10-22)

Signals

Open issues and pull requests: 149
Last push: 2026-10-20 (1 days before this page was built)
Latest release: 4.19.1 on 2026-09-18 (33 days before this page was built)