Discord Application Setup

Aripa needs a Discord application with a bot user. Keep the bot token private; anyone with the token can run the bot as your application.

Create the Bot

1. Open the Discord Developer Portal.
2. Create a new application.
3. Open the Bot section.
4. Create or reset the bot token.
5. Copy the token and store it securely.

Use the token as the TOKEN environment variable when starting Aripa.

Enable Message Content

Aripa uses text commands, so the bot needs the Message Content privileged intent.

In the bot settings, enable:

• Message Content Intent

Without this intent, Aripa may connect successfully but ignore normal text commands.

Invite the Bot

Create an invite URL with the bot scope. Give the bot only the permissions it needs for the commands you plan to use.

Common permissions include:

• View Channels
• Send Messages
• Read Message History
• Manage Messages
• Moderate Members
• Kick Members
• Ban Members
• Manage Roles
• Manage Guild

Discord role hierarchy still applies. For moderation and role commands, the bot's highest role must be above the members or roles it needs to manage.

Add the Server ID

Aripa only runs in allowlisted servers. Add your Discord server ID to allowlistedServerIds in config.json, or use:

bun run onboard

The bot will ignore servers that are not allowlisted. This behaviour cannot be disabled by default.