Building
Self-hosting
Run your bots on your own Linux server instead of the managed Bottly infrastructure.
Before you install
Use a Linux server you administer, with root access and outgoing internet. The installer manages the Bottly agent/runtime; do not run an unfamiliar command on a machine whose other workloads you cannot interrupt. Keep at least the documented 1 GB memory and 5 GB free disk available, with more for other services.
Pair the server
Sign in and open [Self-hosting](/self-hosting).
Generate a pairing code. It is single-use and expires after 10 minutes.
Copy the current install command from that page to your server. Do not publish the code.
Wait for the node to report online, then choose it in the bot's hosting settings.
Start one test bot and confirm a command response plus recent logs.
Daily operation
The agent polls for work and reports status. A paired server still needs a working network, disk and runtime. Monitor
systemctl status bottly-agent and journalctl -u bottly-agent -n 50. Do not paste unredacted logs containing credentials into public support channels.If pairing fails
An expired or already-used code requires a fresh code. An offline node requires checking the agent and connectivity, not resetting every bot token. Follow the page's current installer command so you do not reuse an obsolete version.