# Cloudreve

File management and sharing system that supports several storage providers.

- Replaces: [Dropbox](https://openlogs.fyi/alternatives/dropbox)
- Summary: Paid cloud file storage services, such as Dropbox.
- Stack: Go (language), PostgreSQL (database), Redis (database)
- Deployment: docker_compose
- License: GPL-3.0 (osi) [source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/LICENSE)
- Business model: unknown. The README at the pinned commit does not state a business model, so it stays unknown. ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/README.md), read 2026-10-22)
- 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.
- Requirements: not stated
- Repository: [cloudreve/cloudreve](https://github.com/cloudreve/cloudreve)

## Install

1. Docker with the Compose plugin ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml))

   ```text
   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
   ```

2. Save the compose file as docker-compose.yml ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml))

   ```yaml
   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:
   ```

3. Start it ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml))

   ```bash
   docker compose up -d
   ```

4. Open the app ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml))

   ```text
   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. ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/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. ([source](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 149
- Stars: 28867, forks: 3923
- Last push: 2026-10-20 (1 days ago)
- Latest release: 4.19.1 on 2026-09-18 (33 days ago)

## Sources

- [Repository: https://github.com/cloudreve/cloudreve](https://github.com/cloudreve/cloudreve)
- [License: https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/LICENSE](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/LICENSE)
- [Business model: https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/README.md](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/README.md)
- [Compose file: https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml](https://github.com/cloudreve/cloudreve/blob/9f1e0b8333f5c7304a09e1dcb3f9c170dddd63f3/docker-compose.yml)

---
Canonical: https://openlogs.fyi/tools/cloudreve  
Last updated: 2026-10-22