# TorrentDrive

> TorrentDrive is an open-source, ISP-blind, self-hosted torrent-to-Google Drive and S3 cloud downloader. Offload BitTorrent swarms to a remote Docker container with MSE/PE RC4 encryption and stream completed files directly to Google Drive or S3 over HTTPS.

TorrentDrive is an open-source, self-hosted torrent-to-Google Drive and S3 cloud downloader.
It runs on your remote VPS, Dokploy, or Coolify server so your home ISP never sees BitTorrent
peer connections or tracker announces. It enforces MSE/PE RC4 stream encryption, strict BEP 27
private-tracker isolation, selective batch file picking, and automatic storage failover across
Google Drive and S3-compatible providers (AWS S3, Cloudflare R2, Backblaze B2, Wasabi, MinIO).

## Key Facts & Architecture

- **Category**: Self-Hosted Cloud Torrent Downloader / ISP-Blind Seedbox to Google Drive & S3
- **Pricing**: 100% Free & Open-Source (MIT License) with unlimited torrents and zero subscriptions
- **Stack**: .NET 9 (ASP.NET Core API, Hangfire Orchestrator, MonoTorrent Engine, Google Drive & S3 Workers), Next.js App Router UI, PostgreSQL 15, Redis 7, Prometheus & Grafana
- **Default Web Port**: `47100` (same-origin API proxy; internal admin ports `47200`, `47500`, `47600` bind to `127.0.0.1`)
- **Container Image**: `ghcr.io/torrentdrive/torrentdrive:latest`
- **License**: MIT

## Install in One Command

Linux / macOS:
```bash
curl -fsSL https://raw.githubusercontent.com/TorrentDrive/backend/main/install.sh | bash
```

Docker Compose (Zero `.env` Required):
```bash
curl -fsSL https://raw.githubusercontent.com/TorrentDrive/backend/main/docker-compose.yml -o docker-compose.yml && docker compose up -d
```

Windows PowerShell:
```powershell
irm https://raw.githubusercontent.com/TorrentDrive/backend/main/install.ps1 | iex
```

## Documentation

- [Overview](https://tc.gitnasr.com/docs): TorrentDrive is a self-hosted torrent-to-cloud platform. One Docker container, one command, no configuration files.
- [Getting Started](https://tc.gitnasr.com/docs/getting-started): Install TorrentDrive with one command, Docker Compose, or a 1-click PaaS template.
- [First-Run Setup](https://tc.gitnasr.com/docs/first-run): The setup wizard, creating your account, and connecting Google Drive or S3.
- [Deploying on a PaaS](https://tc.gitnasr.com/docs/paas): Run TorrentDrive on Dokploy, Coolify, Railway or Render — and the one setting that decides whether your data survives.
- [Dokploy](https://tc.gitnasr.com/docs/paas/dokploy): Deploy TorrentDrive on Dokploy in one click using the native template or Docker Compose.
- [Coolify](https://tc.gitnasr.com/docs/paas/coolify): Deploy TorrentDrive on Coolify with zero manual configuration using magic domain variables.
- [Railway](https://tc.gitnasr.com/docs/paas/railway): Deploy TorrentDrive on Railway, and why the volume is not optional.
- [Render](https://tc.gitnasr.com/docs/paas/render): Deploy TorrentDrive on Render with a Blueprint and a persistent disk.
- [Google Drive](https://tc.gitnasr.com/docs/providers/google-drive): Connect TorrentDrive to your Google Drive using your own OAuth 2.0 credentials.
- [AWS S3](https://tc.gitnasr.com/docs/providers/s3): Upload completed downloads to Amazon S3 or any S3-compatible object storage.
- [S3-Compatible Storage](https://tc.gitnasr.com/docs/providers/s3-compatible): Connect to Backblaze B2, MinIO, or any S3-compatible provider.
- [Usage Guide](https://tc.gitnasr.com/docs/usage): Upload and analyze .torrent batches, pick individual files, filter and search jobs, and control cloud storage failover.
- [Configuration](https://tc.gitnasr.com/docs/configuration): Every setting in the app, every environment override, and which one wins.
- [Updating](https://tc.gitnasr.com/docs/updating): Upgrades, backups, rolling back, and pinning a version.
- [Grafana Monitoring](https://tc.gitnasr.com/docs/grafana): Monitor your TorrentDrive instance with pre-provisioned Grafana and Prometheus dashboards.
- [Security](https://tc.gitnasr.com/docs/security): Where secrets live, what each port exposes, and what to do before putting an instance on the internet.
- [Troubleshooting](https://tc.gitnasr.com/docs/troubleshooting): What to check when the container will not start, storage will not connect, or jobs will not move.
- [Architecture](https://tc.gitnasr.com/docs/architecture): What runs inside the container, how the transfer pipeline and BitTorrent engine work, and how the codebase is structured.
- [FAQ](https://tc.gitnasr.com/docs/faq): Frequently asked questions about TorrentDrive, ISP-blind torrenting to Google Drive, and self-hosted deployment.

## Optional

- [Pricing & Specifications](https://tc.gitnasr.com/pricing.md): machine-readable tier limits, license, and storage provider compatibility
- [Full documentation as one file](https://tc.gitnasr.com/llms-full.txt): every page above, concatenated
- [RSS Feed](https://tc.gitnasr.com/feed.xml): syndication feed for newly added documentation
- [Source on GitHub](https://github.com/TorrentDrive): backend, frontend and website repositories