Skip to content
TechShreyashPublic

About

Turn Telegram into your personal cloud drive: resumable uploads, media streaming, document and ebook previews, expiring share links, and encrypted database backups. Self-host with Docker Compose and MongoDB.

Topics

Resources

Stars

92 stars

Watchers

3 watching

Forks

Repository files navigation

TGDrive

Your Telegram files, organized like a cloud drive. Run TGDrive on your computer or server to upload files and folders, stream media, read documents and share links from your browser. Files live in your private Telegram channel; TGDrive adds the file browser and handles large-file splitting.

Try the demo · Set up TGDrive · Explore screenshots and videos

TGDrive file browser with a current sample collection

Features

  • Upload and resume. Upload files or folders, keep their structure and resume interrupted device uploads by reselecting the originals. Large files split automatically.
  • Import torrents and magnet links. Bring in whole torrent folders with their nested structure. Direct file URLs and your configured Telegram upload bot are supported too.
  • Create ZIPs and extract archives. Bundle files/folders into a ZIP, or unpack ZIP, 7z, RAR, TAR and compressed files. Follow background jobs in Transfers.
  • Watch where you left off. Stream supported video and audio. For videos, choose Continue from a position saved in this browser; use track/subtitle menus, chapters and seek previews when available.
  • Read and browse. Open photos, PDFs, text, EPUB ebooks and CBZ/CBR comics. Search, star favorites, manage folders and restore from Trash.
  • Share and embed. Create read-only file or folder links with expiry and revocation, or embed a viewer in your website.
  • Prepare and monitor. Preload files for later access; follow transfers, history and server activity.
  • One file for recovery. Save an encrypted recovery file and its separate key. Restore the database using surviving Telegram files, or rebuild a lost channel from an optional independent copy.

TGDrive has no fixed total-storage quota. File-size limits, server resources and Telegram availability still apply. Learn the essentials →

Try the public demo

Open the live demo · Password: password12345

Explore Demo Files, or upload a disposable sample to My Files. The demo is shared: other visitors can change or delete unprotected files. Use only non-private samples. Demo guide →

See it in action

Watch the 62-second feature tour — torrent imports, ZIP jobs, extraction, video Continue, player settings and the recovery form.

Watch the tour Your drive on mobile
Video Continue in the current player; open the feature tour Current TGDrive file browser in an emulated phone viewport

Captured 28 October 2026. The silent tour uses edited cuts; its recovery screen is a local demo. The phone viewport is emulated. Gallery and video chapters · Capture notes

Make it yours

TGDrive is free and open source, with every feature included. You provide a Telegram channel, bot and MongoDB database. Hosting and database resources may have their own costs.

Where to run it Get started
Your computer Local setup for use while your computer is on
Your own server Server deployment for access while your laptop is off

Keep TGDrive running for website access, share links and background work. Keep separate copies of important files: TGDrive does not add end-to-end encryption or guarantee permanent storage. Privacy and backup basics.

Find your guide

What you want to do Where to go
Understand how your drive works TGDrive basics
Upload, organize, preview and share User guide
Back up your drive or recover after a failure Backup & recovery
Change settings, maintain the app or fix a problem Configuration · Operations
Find technical details or contributor resources Documentation home

Updates and support

Follow the updates channel for announcements, or join the support group for help with self-hosting, setup and discussion.

Contribute

Report a bug or request a feature, or use the development guide and contributor guidance. Include your version and reproduction steps; remove credentials and private links.

MIT License

About

Turn Telegram into your personal cloud drive: resumable uploads, media streaming, document and ebook previews, expiring share links, and encrypted database backups. Self-host with Docker Compose and MongoDB.

Topics

Resources

Stars

92 stars

Watchers

3 watching

Forks

Releases

Used by

Contributors

Languages