Giter VIP home page Giter VIP logo

teldrive's Introduction

Telegram Drive

Telegram Drive is a powerful utility that enables you to create your own cloud storage service using Telegram as the backend.

Discord

Click on icon to join Discord Server for better support

Read Wiki for FAQ.

Table of Contents
  1. Setting up things

Features

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

Demo

demo

UI Repo

Deploy using docker-compose

First clone the repository

git clone https://github.com/divyam234/teldrive
cd teldrive
touch teldrive.db

Follow Below Steps

  • Create the teldrive.env file with your variables and start your container.
docker compose up -d
  • Go to http://localhost:8080

  • Uploads from UI will be slower due to limitations of browser use Rclone for faster uploads.Make sure to use Multi Bots mode if you are using uploader.

  • If you intend to share download links with others, ensure that you enable multi bots mode with bots.

Use without docker

Follow Below Steps

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

  • Add same env file as above.

  • Now, run the Teldrive executable binary directly.

Setting up things

If you're locally or remotely hosting, create a file named teldrive.env in the root directory and add all the variables there. An example of teldrive.env file:

APP_ID=1234
APP_HASH=abc
JWT_SECRET=abc
DATABASE_URL=postgres://<db username>:<db password>@<db host>/<db name>

When used with docker-compose.postgres.yml:

DATABASE_URL=postgres://teldrive:secret@db/teldrive

Warning Default Channel can be selected through UI make sure to set it from account settings on first login.
Use strong JWT secret instead of pure guessable string.You can use openssl to generate it.

$ openssl rand -hex 32

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.

Note What it multi bots feature and what it does?
This feature shares the Telegram API requests between other bots to avoid getting floodwaited (A kind of rate limiting that Telegram does in the backend to avoid flooding their servers) and to make the server handle more requests.

To enable multi bots, generate new bot tokens from BotFather and add it through UI on first login.

Mandatory Vars

Before running the bot, you will need to set up the following mandatory variables:

  • APP_ID : This is the API ID for your Telegram account, which can be obtained from my.telegram.org.

  • APP_HASH : This is the API HASH for your Telegram account, which can be obtained from my.telegram.org.

  • JWT_SECRET : Used for signing jwt tokens

  • DATABASE_URL : Connection String obtained from Postgres DB (you can use Neon db as free alternative fro postgres)

Optional Vars

In addition to the mandatory variables, you can also set the following optional variables:

  • HTTPS : Only needed when frontend is on other domain (Default false).

  • PORT : Change listen port default is 8080

  • ALLOWED_USERS : Allow certain telegram usernames including yours to access the app.Enter comma seperated telegram usernames here.Its needed when your instance is on public cloud and you want to restrict other people to access you app.

  • COOKIE_SAME_SITE : Only needed when frontend is on other domain (Default true).

  • LAZY_STREAM_BOTS : If set to true start Bot session and close immediately when stream or download request is over otherwise run bots forever till server stops (Default false).

  • BG_BOTS_LIMIT : If LAZY_STREAM_BOTS is set to false it start atmost BG_BOTS_LIMIT no of bots in background to prevent connection recreation on every request (Default 5).

  • UPLOAD_RETENTION : No of days to keep incomplete uploads parts in channel afterwards these parts are deleted (Default 15).

For making use of Multi Bots support

Warning Bots will be auto added as admin in channel if you set them from UI if it fails somehow add it manually.

FAQ

  • How to get Postgres DB url ?

    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.

Contributing

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

Donate

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

teldrive's People

Contributors

divyam234 avatar dependabot[bot] avatar joseavilasg avatar kzshantonu avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.