Telegram File Stream Bot

Deployment Options ​

If you don't want to run TG-FileStreamBot on your own computer, you can easily host it on a cloud server. Here are the simplest ways to get your bot online 24/7.

Koyeb ​

Koyeb is a developer-friendly platform that makes deploying Docker containers incredibly simple.

Quick Deploy Button ​

Click the button below to instantly deploy to Koyeb using our provided template. You will be prompted to enter your credentials along the way.

Deploy to Koyeb

Manual Setup on Koyeb ​

If you prefer to set it up manually:

  1. Create a new app on Koyeb.
  2. Select Docker as the deployment type and use the image ghcr.io/everythingsuckz/fsb:latest.
  3. Add your required environment variables (API_ID, API_HASH, BOT_TOKEN, LOG_CHANNEL).
  4. Set the PORT variable to 8038.
  5. Set the HOST variable to https://{YOUR_APP_NAME}.koyeb.app.
  6. Deploy your application.

Heroku ​

If you prefer Heroku, we have you covered as well.

Quick Deploy Button ​

Note that you must fork the main repository to deploy to Heroku first. Once you have done that, click the button below.

Deploy to Heroku

VPS or Dedicated Server ​

Follow the same steps mentioned in the Installation Guide.

Setting Up a Systemd Service ​

To keep the bot running permanently in the background, we recommend creating a systemd service.

  1. Ensure the binary is accessible in your PATH. If you downloaded it manually, move it: sudo cp fsb /usr/local/bin/fsb.
  2. Create a new service file at /etc/systemd/system/fsb.service.
ini
[Unit]
Description=TG-FileStreamBot
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/fsb
ExecStart=/usr/local/bin/fsb run
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
  1. Enable and start the service:
bash
sudo systemctl enable fsb
sudo systemctl start fsb

A Note on Ports and SSL ​

The default port is 8080, but you can change this using the PORT environment variable. When deploying to cloud platforms, make sure you expose the correct port.

Platforms like Koyeb and Heroku handle SSL automatically, so your stream links will use HTTPS. If you are self-hosting on a VPS, you will want to set up a reverse proxy like Nginx or Caddy with Let's Encrypt to handle HTTPS.

🟢 NOTE

This section will be updated soon with more detailed guides. If you would like to contribute, please press the "Edit this page" button at the bottom of the page and submit a pull request with your improvements.

Next Steps ​

Now that you are installed and deployed, let's explore all the ways you can tune the bot. Check out the Configuration Guide.