Installation
Containers
Run Teldrive with Docker or Podman.
Official images:
ghcr.io/tgdrive/teldrive:<tag>Use Quick start for PostgreSQL + Teldrive Compose.
Minimal container
With PostgreSQL already available:
docker run --rm \
-p 127.0.0.1:8080:8080 \
-e TELDRIVE_HTTP_ADDRESS=0.0.0.0:8080 \
-e TELDRIVE_DATABASE_URL='postgres://teldrive:password@db.example:5432/teldrive?sslmode=require' \
-e TELDRIVE_SECURITY_SIGNING_KEY='YOUR_SIGNING_KEY' \
-e TELDRIVE_SECURITY_DATA_KEY='YOUR_DATA_KEY' \
ghcr.io/tgdrive/teldrive:2Podman uses the same settings with podman run.
Pin releases
image: ghcr.io/tgdrive/teldrive:X.Y.ZUse :2 to follow major-version updates, or an exact version for controlled upgrades/rollbacks. Releases do not publish latest.
Local imports
See Uploads and events for allowed paths and read-only container mounts.
Validate
docker compose run --rm teldrive check
docker compose logs --tail=200 teldriveSee Upgrading.