Telegram Drive is a powerful utility that enables you to organise your telegram files and much more.

Click on icon to join Discord Server

• UI: Based on Material You to create nice looking UI themes.
• Secure: Your data is secured using robust encryption.
• Flexible Deployment: Use Docker Compose or deploy without Docker.

• Exceptional Speed: Teldrive stands out among similar tools, thanks to its implementation in Go, a language known for its efficiency. Its performance surpasses alternatives written in Python and other languages, with the exception of Rust.

• Enhanced Management Capabilities: Teldrive not only excels in speed but also offers an intuitive user interface for efficient file interaction which other tool lacks. Its compatibility with Rclone further enhances file management.

UI Repo

version: "3.8"

services:
  server:
    image: ghcr.io/divyam234/teldrive
    restart: always
    container_name: teldrive
    volumes:
      - ./session.db:/session.db:rw
      - ./config.toml:/config.toml
    ports:
      - 8080:8080

People Who want to use local Postgres instance

version: "3.8"

services:
  server:
    image: ghcr.io/divyam234/teldrive
    restart: always
    container_name: teldrive
    volumes:
      - ./session.db:/session.db:rw
      - ./config.toml:/config.toml
    ports:
      - 8080:8080
    depends_on:
      db:
        condition: service_healthy
  db:
    image: postgres:15
    container_name: teldrive_db
    restart: always
    environment:
      - POSTGRES_USER=teldrive
      - POSTGRES_PASSWORD=secret
    volumes:
      - ./postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "teldrive"]
      interval: 10s
      start_period: 30s

Follow Below Steps

• Create the config.toml file with your values and start your container. See how to fill file below.

[db]
data-source = "postgres://<db username>:<db password>@<db host>/<db name>"

[jwt]
secret = "abcd"

[tg]
app-id = 
app-hash = "fwfwfwf"

Only these values are mandatory however you can change or tweak your config see more in advanced configurations below.

touch session.db
docker compose up -d

• Go to http://localhost:8080

Follow Below Steps

• Download the release binary of Teldrive from the releases section.

• Add same config file as above.

• Now, run the Teldrive executable binary directly.

• You can also set up without config file.

One line installer for linux

curl -s https://sh-install.vercel.app/divyam234/teldrive | bash # install in current directory

curl -s https://sh-install.vercel.app/divyam234/teldrive! | bash # install in /usr/local/bin

teldrive run --tg-app-id="" --tg-app-hash="" --jwt-secret="" --db-data-source=""

Generate JWT

$ openssl rand -hex 32

You can generate secret from here.

• You can set up a local Postgres instance, but it's not recommended due to backup and data transfer hassles. The recommended approach is to use a free cloud-based Postgres DB like Neon DB.
• Default Channel can be selected through UI. Make sure to set it from account settings on first login.
• Multi Bots Mode is recommended to avoid flood errors and enable maximum download speed, especially if you are using downloaders like IDM and aria2c, which use multiple connections for downloads.
• To enable multi bots, generate new bot tokens from BotFather and add them through UI on first login.
• Uploads from UI will be slower due to limitations of the browser. Use modified Rclone version for teldrive.
• Teldrive supports image thumbnail resizing on the fly. To enable this, you have to deploy a separate image resize service from here.
• After deploying this service, add its URL in Teldrive UI settings in the Resize Host field.
• Files are deleted at regular interval of one hour through cron job from tg channel after its deleted from teldrive this is done so that person can recover files if he/she accidently deletes them.

cli options

teldrive run --help

You Can also set config values through env varibles.

• For example tg-session-file will become TELDRIVE_TG_SESSION_FILE same for all possible flags.

• See config.sample.toml in repo if you want to setup advanced configurations through toml file.

[teldrive]
type = teldrive
api_host = http://localhost:8080 # default host
access_token = #session token obtained from cookies
chunk_size = 500M
upload_concurrency = 4
encrypt_files = false # Enable this to encrypt files make sure ENCRYPTION_KEY env variable is not empty in teldrive instance.

See all options in rclone config command

Read Wiki for FAQ.

• Follow Limits: Adhere to the limits imposed by Telegram servers to avoid account bans and automatic deletion of your channel.

• Data Hoarding: Avoid excessive data hoarding, as it not only violates Telegram's terms but also leads to unnecessary wastage of storage space.

• Responsible Storage: Be mindful of the content you store on Telegram. Utilize storage efficiently and only keep data that serves a purpose.

• Respect Terms of Service: Familiarize yourself with and adhere to the terms of service provided by Telegram to ensure a positive and sustainable usage experience.

By following these guidelines, you contribute to the responsible and effective use of Telegram, maintaining a fair and equitable environment for all users.

Feel free to contribute to this project if you have any further ideas.

If you like this project small contribution would be appreciated Paypal.