PS-LinkVault

Deployment guide for the Docker-based Telegram bot. Run one prebuilt image on Koyeb, Render, or Railway, add eight environment variables, then send /start.

Docker image ghcr.io/ps-updates/ps-linkvault:latest

Docker gives every platform the same build with its dependencies bundled. To update, pull the latest image and redeploy.

Environment variables

Add all eight to your host. They are the same on every platform.

Essential variables (must add)

Paste into your host's environment settings
BOT_TOKEN=YOUR_BOT_TOKEN
API_ID=YOUR_API_ID
API_HASH=YOUR_API_HASH
OWNER_ID=YOUR_TELEGRAM_ID
CHANNEL_ID=YOUR_CHANNEL_ID
DATABASE_URL=YOUR_MONGODB_URL
ADMINS=123456789 987654321
DATABASE_NAME=Cluster0
Where each value comes from
VariableHow to get it
BOT_TOKENYOUR_BOT_TOKEN Get from @BotFather.
API_IDYOUR_API_ID Get from my.telegram.org.
API_HASHYOUR_API_HASH Get from my.telegram.org, next to your API ID.
OWNER_IDYOUR_TELEGRAM_ID Get from @MissRose_bot.
CHANNEL_IDYOUR_CHANNEL_ID Get from @MissRose_bot. It starts with -100.
DATABASE_URLYOUR_MONGODB_URL MongoDB connection string from MongoDB Atlas.
ADMINS123456789 987654321 Telegram user IDs separated by spaces. The owner ID is included automatically.
DATABASE_NAMECluster0 The database name. The example uses Cluster0.

Need more options? Force Subscribe, custom messages, auto-delete, shortlinks and more are covered in the GitHub README.

Common environment variable issues

Invalid BOT_TOKEN. Copy the entire token from BotFather, with no extra spaces or newlines.

DATABASE_URL not working. Make sure your MongoDB Atlas IP whitelist includes 0.0.0.0/0 for cloud deployments.

CHANNEL_ID format. Channel IDs start with -100, for example -1001234567890. Forward a message from your channel to @MissRose_bot, then reply with /id to get the correct ID.

Deploy

All three platforms run the same image. Pick one, then follow its steps.

Platform comparison
Platform Free tier Always on Best for
Koyeb Yes Yes 24/7 availability, beginners
Render Yes (750 hrs) No, sleeps after 15 min Easy setup, good docs
Railway $5 credit per month Yes Fast deployment, great developer experience

Deploy on Koyeb

  1. Open the Koyeb dashboard.
  2. Click Create App.
  3. Choose Docker as the deployment method.
  4. Paste the image URL:
  5. Add all required environment variables from above.
  6. Choose a region. Closer to you means faster responses.
  7. Click Deploy and wait for the deployment to finish.

Tip: Koyeb's free tier offers always-on instances, which suits a bot that must answer 24/7.

Deployment troubleshooting

Bot not responding. Check the logs and verify your environment variables.

Database failed. The MongoDB Atlas whitelist should include 0.0.0.0/0 for cloud hosts.

Wrong image. It must be exactly ghcr.io/ps-updates/ps-linkvault:latest.

Render sleeps. Use UptimeRobot, or upgrade.

Verify your deployment

  1. Test the bot response. Open Telegram and send /start to confirm it responds.
  2. Check the logs. Review the platform logs for errors or warnings.
  3. Test link storage. Send a test link to confirm MongoDB storage is working.

Accounts and help

You need an account on the platform you chose.

Prefer video? Search YouTube for "Koyeb deployment tutorial" or "Deploy Docker on Render".