Skip to content

Repository files navigation

📂 FilesLink

Secure file sharing powered by Telegram cloud storage

FilesLink is a Telegram bot that transforms your private channel into unlimited cloud storage. Upload files, get instant download links, no local disk required.

DockerLicenseRust

Features

  • 📤 Instant Upload - Send files to bot, receive download links
  • ☁️ Telegram Storage - Up to 2GB per file, unlimited storage
  • FastTelethon - Bypass 20MB bot API limit with MTProto (also 10-30 MB/s speeds)
  • 🔗 URL Download - Fetch external files directly
  • 🔒 Access Control - Granular per-chat permissions
  • 🚀 Fast Streaming - Direct downloads from Telegram
  • 🐳 Docker Ready - One-command deployment

Quick Start

git clone https://github.com/bytetrix/fileslink.git
cd fileslink
cp .env.example .env # Add your credentials
docker compose up -d

Access:http://localhost:8080

Documentation

GuideDescription
📦 InstallationDocker, local, and production setup
⚙️ ConfigurationAll environment variables explained
📱 Telegram SetupConfigure your storage channel
⚡ FastTelethon SetupEnable large file support (>20MB)
🎯 UsageHow to use the bot
🛡️ PermissionsAccess control configuration
🔧 CLICommand-line interface
🌐 Render DeploymentDeploy to Render.com (free tier)
❓ FAQCommon questions and troubleshooting
🏗️ ArchitectureTechnical details

Requirements

Required:

Optional:

  • Docker (recommended)
  • Rust 1.90+ (for local development)

Environment Setup

BOT_TOKEN=123456789:ABC-DEF...
STORAGE_CHANNEL_ID=-1001234567890
APP_FILE_DOMAIN=https://yourdomain.com/files

See Configuration Guide for all options.

Cloud Deployment

Deploy to free hosting in minutes:

  • Render - 100% free with Cloudflare keep-alive (no sleep!)
  • Railway - easiest setup
  • Fly.io - Global edge deployment
  • VPS - Full control

See Deployment Guide for details.

Use Cases

  • Team file sharing
  • Cloud backup solution
  • URL-to-file conversion
  • Personal file hosting
  • Telegram file manager

Tech Stack

  • Backend: Rust (Tokio, Axum)
  • Bot: Teloxide
  • Storage: Telegram Cloud (2GB per file)
  • Large Files: FastTelethon (Python MTProto client for files >20MB)
  • Deployment: Docker

License

MIT © Bytetrix


Need help? Check the FAQ or open an issue.

About

Self Hosted Files Storage in Telegram and Get Direct Download Link, WebUI and Telegram Bot Support.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages