Skip to content

Setting Up Teldrive with Rclone ​

Teldrive integrates with rclone, allowing you to use your Telegram storage with familiar rclone commands and features.

Installation ​

Install the Teldrive rclone remote using one of these methods:

sh
curl -sSL instl.vercel.app/rclone | bash
powershell
powershell -c "irm https://instl.vercel.app/rclone?platform=windows|iex"

Feature Compatibility ​

FeatureSupported
PurgeYes
CopyYes
MoveYes
DirMoveYes
CleanUpYes
ListRNo
StreamUploadNo
MultithreadUploadYes
LinkSharingYes
AboutYes
EmptyDirYes

For more information about rclone commands and features, visit the official rclone documentation.

Configuration Options ​

Configure rclone under the [teldrive] section in your rclone config file:

OptionDescription
typeMust be "teldrive"
api_hostHost address of TelDrive API (default: "http://localhost:8080")
access_tokenSession token from cookies for authentication
chunk_sizeMaximum size for file chunks (default: "500M", max: "2GB")
upload_concurrencyNumber of concurrent uploads (default: 4)
encrypt_filesEnable file encryption (default: false)
random_chunk_nameUse random names for file chunks (default: true)
channel_idTelegram Channel ID (default: selected automatically if not mentioned)

Example Configuration ​

toml
[teldrive]
type = "teldrive"
api_host = "http://localhost:8080"
access_token = "your_session_token_here"
chunk_size = "500M"
upload_concurrency = 4
encrypt_files = false
random_chunk_name = true

IMPORTANT

To obtain your session token easily:

  1. Install the Cookie Editor extension for Chrome or Firefox
  2. Visit your Teldrive website
  3. Open the extension and copy the value from the cookie named access_token
  4. Alternatively, find the token in your browser's developer tools in the cookies section

Released under the MIT License.