Deploy and Host Discord.py Bot on Railway

A one-service discord.py 2.7 worker with slash commands, a pinned Python 3.12 image, a uv lockfile, and a /health endpoint used only for Railway healthchecks. Set DISCORD_TOKEN and deploy.

This listing replaces rotting marketplace clones frozen on discord.py 2.1.0 (Jan 2023) with no lockfile and no healthcheck.

About Hosting Discord.py Bot

The bot is a worker, not a website. It opens a Discord gateway session and serves GET /health on $PORT so Railway can healthcheck the replica. There is no public homepage.

Create a bot token at the Discord Developer Portal → your application → Bot → Reset Token. Invite the bot with the bot and applications.commands scopes.

Slash commands (/ping, /info) work with default intents. Privileged intents stay off unless you opt in.

Common Use Cases

Host a small moderation, utility, or community bot 24/7.
Start a slash-command bot without a dummy Flask homepage.
Keep a pinned discord.py 2.x worker that actually passes Railway healthchecks.

Dependencies for Discord.py Bot Hosting

Python 3.12.14 (digest-pinned python:3.12.14-slim-bookworm).
discord.py 2.7.1 locked in uv.lock.
A Discord application bot token (DISCORD_TOKEN).
No database and no volume. Stateless gateway worker.

Deployment Dependencies

Source: https://github.com/leoisadev1/railway-template-discord-py-bot
discord.py docs: https://discordpy.readthedocs.io/en/stable/
Discord Developer Portal: https://discord.com/developers/applications
Privileged intents: https://discord.com/developers/docs/events/gateway#privileged-intents

Why Deploy Discord.py Bot on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Discord.py Bot on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

Variables

Variable	Required	Default	Notes
`DISCORD_TOKEN`	yes	none	Bot token from the Developer Portal. User-provided. Never baked in.
`PORT`	no	`8080`	Injected by Railway. Healthcheck listen port.
`DISCORD_GUILD_ID`	no	unset	If set, slash commands sync instantly to that guild. Omit for global sync (can take up to an hour).
`MESSAGE_CONTENT_INTENT`	no	`false`	Privileged. Set `true` only after enabling Message Content Intent in the portal.
`MEMBERS_INTENT`	no	`false`	Privileged. Set `true` only after enabling Server Members Intent.
`PRESENCES_INTENT`	no	`false`	Privileged. Set `true` only after enabling Presence Intent.

No generated secrets. No dummy token.

Privileged intents

Slash commands work with default intents. Enable privileged intents in the Developer Portal and with the matching env flags. If they disagree, discord.py raises PrivilegedIntentsRequired and the process keeps /health up so you can fix the config without a crash loop.

Ports

Port	Purpose
`$PORT` (HTTP)	Railway healthcheck only: `GET /health` → `{"status":"ok"}`. Not a website. No public homepage.

You do not need a public domain for the bot to talk to Discord. Railway uses /health internally.

Volumes

None. This is a stateless gateway worker. Add a volume later if you persist your own data.

Login / invite

Developer Portal → OAuth2 → URL Generator.
Scopes: bot + applications.commands.
Grant the permissions your commands need (Send Messages is enough for /ping).
Open the generated URL, pick a server, authorize.
In Discord, type /ping.

Included commands

/ping — round-trip latency
/info — discord.py version and bot user

Edit bot.py and redeploy to add commands.

Why this is healthier than the old marketplace clones

	This template	Typical rotting clone
Python	3.12.14-slim-bookworm digest-pinned	Unpinned / 3.10 era
discord.py	2.7.1 in `uv.lock`	`discord.py==2.1.0` (Jan 2023)
Commands	Slash (`app_commands`)	Prefix `!` only
Healthcheck	`GET /health` on `$PORT`	None (health 0)
Token	Required, empty default	Sometimes a dummy
Shape	One worker service	Dummy Flask homepage

Local run

uv sync --frozen
export DISCORD_TOKEN=your-token
export PORT=8080
uv run python bot.py

curl -fsS http://127.0.0.1:8080/health should return {"status":"ok"}.