Google Drive

Prerequisites

A Google Cloud project with the Google Drive API enabled.

Step 1: Create OAuth Credentials

1. Go to Google Cloud Console → APIs & Services → Credentials
2. Click Create Credentials → OAuth client ID
3. Application type: Web application
4. Add Authorized redirect URI:
   • Local: http://localhost:47100/proxy/api/storage/gdrive/callback
   • Remote server: the installer prints the exact URI — e.g. http://192-168-1-100.sslip.io:47100/proxy/api/storage/gdrive/callback
5. Copy the Client ID and Client Secret

Step 2: Connect Your Account

1. In TorrenCloud, go to Storage → Google Drive
2. Enter the Client ID and Client Secret from the previous step
3. Click Connect Google Account
4. Complete the OAuth flow in your browser
5. Select which Drive folder to sync to

Google credentials are saved securely within TorrenCloud during configuration — no environment variables needed.

Step 3: Configure Auto-Sync

After connecting, set up sync rules:

• Target folder: where files land in your Drive
• Auto-sync: toggle to automatically sync completed downloads

Data Privacy

• OAuth tokens are stored encrypted in the PostgreSQL database inside your container
• Files are uploaded directly from your server to Google Drive — no intermediary
• To revoke access: visit myaccount.google.com/permissions and remove TorrenCloud

Troubleshooting

"Redirect URI mismatch" — The redirect URI must exactly match what TorrenCloud shows in the storage settings form. It follows the pattern http://<your-host>:47100/proxy/api/storage/gdrive/callback. If you installed via the one-command installer, the exact URI was printed at the end of installation.

"Access denied" — Make sure the Google Drive API is enabled in your Cloud Console project.