Teldock

Chunked Uploads

Large files are split into bounded parts of about 18 MB and streamed to your channel, removing the practical per-file size ceiling without buffering files on the server.

Streaming Downloads

Parts are reassembled on the fly with backpressure handling and HTTP Range support, so downloads can be resumed and media can be seeked.

Multi-Bot Pool

Register several bot tokens per account and distribute parts across them with round-robin selection for higher throughput and resilience against per-bot rate limits.

Version History

Overwriting a file snapshots the previous contents automatically, and any earlier version can be listed and restored.

Secure Sharing

Publish a file behind a signed public link with an optional expiry, a download limit, and password protection.

WebDAV Mount

Mount Teldock as an ordinary drive on your desktop through the Rclone-compatible WebDAV endpoint, using your existing account credentials.

Overview

Teldock turns a Telegram bot and a private channel into a personal cloud drive. Your server keeps only metadata in a relational database and proxies file content to and from Telegram on demand, so the raw bytes never persist on local disk. Each account connects its own bot and storage channel, which keeps users isolated even when they share a single self-hosted instance.

How it works

A user connects their own Telegram bot token and private storage channel in Settings.

On upload, the file is split into bounded parts of roughly 18 MB to stay within the Bot API limits.

Parts are streamed to that user's channel through their bot pool.

The database stores only metadata — filenames, part references, sizes, and encryption parameters.

On download, parts are reassembled in order and streamed back with Range support.

Documentation

Installation — get a local instance running in a few minutes.

Using Teldock — upload, organize, preview, and share files.

API Reference — every endpoint, with request and response examples.

Deployment — put Teldock into production behind Nginx and HTTPS.

Read before you rely on it

Teldock is a non-commercial, open-source educational project. Using Telegram's Bot API as general-purpose storage is not an intended use of the platform and may violate Telegram's Terms of Service. Keep independent backups of anything important.

TeldockYour files, stored on Telegram