TGDrive 2.0.0 — Your Telegram. Your cloud drive.

TGDrive v2 turns a private Telegram channel into a drive you can browse, organize, stream and share from your browser. Run it on your computer, or on a server for access while your laptop is off.

Telegram holds the files; MongoDB keeps their index, folders and settings. You provide the accounts and infrastructure.

A familiar home for your files

Browse in grid or list view, create folders, search filenames and star favorites. Rename, move or select several items, and restore accidental removals from Trash. Light, dark and system appearance options work across desktop and narrow screens.

Upload large files without splitting them yourself

Upload files or whole folders with their relative structure intact. Larger files are automatically split into Telegram-sized documents and presented as one file for downloads and playback. The default limit is 16 GiB per file, subject to temporary server space.

Follow device transfer, Telegram upload and publication in Transfers. Keep the tab open until You can close this tab, and keep originals until Completed. Reselect matching originals to resume interrupted uploads. You can also import direct URLs or send and forward files to the configured Telegram bot.

Watch, read and preview in the browser

Play supported video and audio with available subtitles, audio tracks and chapters. Open images, PDFs and text, or read EPUB books and CBZ/CBR comics with navigation and display controls. Download Original remains available when you prefer another app or a format cannot be previewed.

Share selected content and keep control

Create read-only file or folder links, add labels, set expiry dates and revoke access from Shared Links. Recipients need no owner password. Anyone holding a link can use it; revocation cannot recall downloaded copies.

Prepare for repeat visits and recovery

Preload files into the server cache before watching or sharing. Retained bytes can serve later reads without another Telegram download. Performance and preload pages show traffic, resources and cached coverage.

Encrypted database backups preserve the catalog and settings; an optional independent Telegram channel protects confirmed file copies. Save matching keys outside the server and retain external originals. A database backup cannot recreate missing Telegram file bytes.

Set up TGDrive · User guide · Screenshots and walkthroughs

Starting with v2: Use a fresh MongoDB replica-set database and dedicated private Telegram channel; v1 catalogs are not imported. Preserve existing v2 data, secrets and volumes. Clone v2.0.0 or use its source archive below.

Validation, compatibility and release record

Recorded PR checks and merged-main checks passed. Exact-release container/source-archive verification and live checks were not completed. Automated checks and demo screenshots do not certify every device, codec, network or recovery scenario.

Released through PR #12 at 4302887. Operations · Recovery.