Usage Guide

Adding Torrents

Upload a .torrent file

1. Navigate to the Torrents page from the sidebar
2. Click Upload .torrent
3. Select your .torrent file — the download job starts immediately

Monitoring Downloads

The Dashboard shows:

• Active jobs with real-time progress bars
• Download speed and estimated time remaining
• Upload progress percentage for cloud sync jobs
• Job status progression: Queued → Downloading → Pending Upload → Uploading → Completed

Managing Jobs

Jobs can be retried or cancelled from the job detail view. The job queue is powered by Hangfire with Redis as the backing store — it survives container restarts.

Visit the Hangfire Dashboard at http://localhost:47200/hangfire to see raw queue state, active workers, and retry history.

Configuring Cloud Storage

Cloud storage is managed under Storage in the sidebar:

• Google Drive Setup
• AWS S3 Setup
• S3-Compatible (Backblaze B2, MinIO)

Common Operations

View logs

docker logs -f torrencloud

Stop the application

docker stop torrencloud

Start again (data persists)

docker start torrencloud

Access downloaded files

docker exec -it torrencloud ls /data/downloads

Or mount a local directory instead of a Docker volume:

docker run -d --name torrencloud \
  -p 47100:47100 -p 47200:47200 \
  -v torrencloud-pgdata:/data/postgres \
  -v torrencloud-redis:/data/redis \
  -v /path/to/your/downloads:/data/downloads \
  --env-file .env \
  ghcr.io/torrenclou/torrentclou:latest

Updating

docker pull ghcr.io/torrenclou/torrentclou:latest
docker stop torrencloud && docker rm torrencloud
./run.sh

Data persists in Docker volumes across container re-creations.