Connect Telegram Files to Telegram Seed

Telegram Files can connect to Telegram Seed and act as a sharing/download node.

1. Enable sharing

Add these settings to your .env:

SHARE_ENABLED=true
SEED_PLATFORM_URL=https://tele-seed.com
SECRET_STORE_MASTER_KEY=your-secret-key

Generate a secret key with:

openssl rand -base64 32

Then restart Telegram Files.

2. Configure qBittorrent

If you want to download or seed resources through P2P, configure qBittorrent:

QBITTORRENT_URL=http://qbittorrent:8080
QBITTORRENT_USERNAME=telegram-files
QBITTORRENT_PASSWORD=your-password

SHARED_ROOT=/app/data/shared
QBITTORRENT_SHARED_ROOT=/downloads/shared

PEER_LISTEN_PORT=51413

SHARED_ROOT and QBITTORRENT_SHARED_ROOT must point to the same directory on the host.

3. Connect your node

Open:

Telegram Files → Sharing

or:

https://your-telegram-files-host/share

Enter a node name and click:

Start authorization

Telegram Files will show:

• a QR code
• a user code
• an approval link

Scan the QR code or open the approval link, then approve the node in Telegram Seed.

After approval, the status will change to:

Bound

4. Share files

Once the node is connected, eligible downloaded files can be shared to Telegram Seed directly from the file list.

Telegram Files will automatically sync sharing rules from Telegram Seed, including:

• allowed file types
• file size limits
• categories
• allow/deny rules

5. Download and seed

Resources downloaded from Telegram Seed are stored in the shared directory and handled by qBittorrent for P2P downloading and seeding.

Avoid moving or renaming files inside the shared directory while they are being seeded.

Troubleshooting

Sharing page is missing

Make sure:

SHARE_ENABLED=true

and restart Telegram Files.

Authorization stays pending

Open the approval link or scan the QR code and approve the node in Telegram Seed.

If the authorization expires, start a new authorization request.

qBittorrent cannot find files

Make sure SHARED_ROOT and QBITTORRENT_SHARED_ROOT are mapped to the same host directory.

Node is bound but offline

Check that Telegram Files can access:

https://tele-seed.com

and review the Telegram Files logs for heartbeat or network errors.