Quick checklist (new users)
- Click Deploy on Railway (below).
- Add a Volume mounted at
/data. - Set the required Variables (at least
FLUFFBUZZ_GATEWAY_PORTandFLUFFBUZZ_GATEWAY_TOKEN). - Enable HTTP Proxy on port
8080. - Open
https://<your-railway-domain>/fluffbuzzand connect using yourFLUFFBUZZ_GATEWAY_TOKEN.
One-click deploy
Deploy on Railway After deploy, find your public URL in Railway → your service → Settings → Domains. Railway will either:- give you a generated domain (often
https://<something>.up.railway.app), or - use your custom domain if you attached one.
https://<your-railway-domain>/fluffbuzz— Control UI
What you get
- Hosted FluffBuzz Gateway + Control UI
- Persistent storage via Railway Volume (
/data) so config/credentials/workspace survive redeploys
Required Railway settings
Public Networking
Enable HTTP Proxy for the service.- Port:
8080
Volume (required)
Attach a volume mounted at:/data
Variables
Set these variables on the service:FLUFFBUZZ_GATEWAY_PORT=8080(required — must match the port in Public Networking)FLUFFBUZZ_GATEWAY_TOKEN(required; treat as an admin secret)FLUFFBUZZ_STATE_DIR=/data/.fluffbuzz(recommended)FLUFFBUZZ_WORKSPACE_DIR=/data/workspace(recommended)
Connect a channel
Use the Control UI at/fluffbuzz or run fluffbuzz onboard via Railway’s shell for channel setup instructions:
- Telegram (fastest — just a bot token)
- Discord
- All channels
Backups & migration
Export your configuration and workspace:Next steps
- Set up messaging channels: Channels
- Configure the Gateway: Gateway configuration
- Keep FluffBuzz up to date: Updating