Skip to content

Installation

Joseph Shenton edited this page Sep 22, 2026 · 1 revision

Installation

Three ways to run SchröDrive. Pick one.

1. Docker (recommended)

docker run -d --name schrodrive \
  -p 8978:8978 -p 8282:8282 -p 9120:9120 \
  -e PROWLARR_URL=http://prowlarr:9696 \
  -e PROWLARR_API_KEY=your_key \
  -e TORBOX_API_KEY=tb_your_key \
  -e RD_ACCESS_TOKEN=your_rd_token \
  -e PROVIDERS=torbox,realdebrid \
  ghcr.io/moderniselife/schrodrive:latest

Images are multi-arch (linux/amd64 + linux/arm64) from release.yml.

2. Docker Compose (full stack)

git clone https://github.com/moderniselife/SchroDrive.git
cd SchroDrive
cp .env.example .env   # fill Prowlarr, provider keys, etc.
docker-compose up -d

Compose includes the mount base at /mnt/schrodrive (Linux) / /Volumes/SchroDrive (macOS). See docker-compose.yml for Radarr/Sonarr example.

3. Bare Metal (Bun)

Requires bun >=1.2.0 and rclone only if RUN_MOUNT=true.

git clone https://github.com/moderniselife/SchroDrive.git
cd SchroDrive
bun install          # also sets core.hooksPath → .githooks/
bun run build        # tsc → dist/
bun dist/index.js serve
# or dev:
bun --watch src/index.ts serve

Verify

curl -s http://localhost:8978/health | jq
# {"ok": true, "service": "api", ...}

# *arr bridge (if ARR_BRIDGE_ENABLED=true)
curl -s http://localhost:8282/health | jq

# WebDAV bridges
curl -s http://localhost:9115/health  # RealDebrid
curl -s http://localhost:9116/health  # TorBox

Logs stream at GET /api/logs/stream (SSE) and the dashboard at :3000 if RUN_WEB_GUI=true.

Next Steps

  • Fill PROVIDERS and provider keys — see Configuration and Providers.
  • Choose ADD_STRATEGY=all|failover|single.
  • Enable the services you need via RUN_* toggles in Configuration.

Clone this wiki locally