1 tutorials basic usage
dunklecat edited this page 2025-12-24 14:10:44 +01:00

Let's start the bot and create our first admin

1. Configure the bot

By default the bot uses the file at ./delta-fastbot.yaml to load a configuration. You can set the DELTA_FASTBOT_CONFIG environment variable to customize the path and create your own custom configuration following this reference guide.

2. Start the bot

Depending on how you're using the bot, there are two ways to start the bot:

  • Installed from Guix run delta-fastbot from a terminal emulator;
  • Directly from the repository run cargo run --release from the top directory of the repository.

3. Create the first admin

On startup the bot prints two important messages:

  • a Delta Chat QR link that can be used to start a private conversation with the bot;
  • a one-time admin token that needs to be sent to the private chat with the bot in order to register the first admin. The token is valid only once.

Open the conversation using the Delta chat QR link and send the message containing the one-time admin token to register yourself as the first admin of that instance of the bot.

4. Explore the bot

Now that the bot is fully functional you can start explore the bot using the !help command.