alice.The music bot
field guide
Screenshot guide

Deploy Alice on Railway.

From the deploy button to your first Telegram song. Follow the screenshots, fill your values, and let Railway install Alice.

This walkthrough uses the Alice Music Bot template and a real deployment tested on 20 November 2026. Your project name and account balance will differ.

Before you begin

Sign in to Railway and have your Telegram and MongoDB values ready. This page covers deployment only.

For the assistant session, use @elite_session_maker_bot and choose Pyrogram v2. Use the resulting string for STRING_SESSION.

1. Open the deploy button

On the Alice GitHub repository, scroll to Free Deploy and select Deploy on Railway.

Select Deploy on Railway in the README
Select Deploy on Railway in the README · Tap to enlarge.

2. Choose Deploy Now

Check that the template is Alice Music Bot, then select Deploy Now.

Open Alice Railway template ↗

Alice Music Bot Railway template
Alice Music Bot Railway template · Tap to enlarge.

3. Configure Alice

Choose New Project and select Configure on the Alice Music Bot card. The template already includes the repository, variable names and persistent storage.

Open Configure to enter your values
Open Configure to enter your values · Tap to enlarge.

4. Fill the variable values

Enter your own values in the existing fields. Paste values without surrounding quotation marks, spaces or line breaks.

FieldValue to enter
API_IDYour numeric Telegram API ID.
API_HASHThe matching Telegram API hash.
BOT_TOKENYour bot token from BotFather.
OWNER_IDYour personal numeric Telegram user ID.
MONGO_URLYour MongoDB connection URI.
STRING_SESSIONYour assistant’s Pyrogram v2 session string.
LOG_GROUP_IDYour log group ID, including the minus sign, or 0 to disable log messages.

Keep SESSION_DIR=/data and ALICE_MANAGED_DEPLOYMENT=1 unchanged. Keep the template’s /data volume. Save the configuration; when the card is ready, select Deploy. Do not paste credentials into GitHub or public screenshots.

5. Wait for the build

Open the Alice Music Bot service and its deployment. Railway installs the dependencies and starts the container automatically. You do not need to run setup commands or expose a public web domain.

Railway builds the Alice service
Railway builds the Alice service · Tap to enlarge.

6. Confirm startup in Deploy Logs

Open Deploy Logs. Look for Bot connected, Assistant connected and All systems ready. An Online label alone does not confirm Telegram login.

Alice startup logs after deployment
Alice startup logs after deployment · Tap to enlarge.

If you configured a log group and the bot can send messages there, Alice also sends a startup confirmation.

Telegram startup confirmation: bot and assistant connected, voice engine ready
Telegram startup confirmation: bot and assistant connected, voice engine ready · Tap to enlarge.

7. Play your first song

  1. Add your deployed bot to a Telegram group and make it an admin with permission to manage voice chats and invite users.
  2. Start a group voice chat. The assistant must be able to join and speak.
  3. Send /play dilbar and join the call to listen.
  4. Check the Alice player card. Try Pause, Resume and Stop.

The example below shows the user’s Telegram test and Alice’s Dilbar player card. Other music bots were also present in this test group; use your own deployed bot when testing.

Alice Dilbar player card during the Telegram test
Alice Dilbar player card during the Telegram test · Tap to enlarge.

If something fails

  • Missing variables: check the Alice service’s Variables tab. Project Shared Variables must be linked to the service before it can use them.
  • Telegram login fails: check the API pair, bot token and Pyrogram v2 session.
  • Database connection fails: check the URI, database user and Atlas network access settings.
  • No audio: check the assistant’s group membership and speaking permission, then read Deploy Logs.

For updates, redeploy through Railway. The bot’s in-chat updater does not replace a Railway deployment.

KEEP GOINGExplore Alice commands
Search the field guide · ↓ to select · Enter to open · Esc to close