Quick Start

This page gets Aripa running locally or on a server. Aripa uses Bun as its runtime and package manager.

Requirements

• Bun installed on the machine that will run the bot.
• A Discord bot token.
• Access to the Discord server where Aripa will run.
• The Discord Message Content privileged intent enabled for the bot.

Install

Download the latest release from the Releases page and extract the contents to a directory, e.g. aripa.

Navigate to the directory and install the dependencies:

cd aripa
bun install

Configure

Create the runtime configuration:

bun run onboard

The onboarding wizard creates config.json and requires at least one allowlisted Discord server ID.

Run

Start the bot with your Discord bot token:

TOKEN="your-discord-bot-token" bun run start

In Discord, confirm the bot is responding:

-ping

The default command prefix is -. You can change it with the PREFIX environment variable.

Check Logs

Open the local log UI:

TOKEN="your-discord-bot-token" bun run logs:ui

For development or local testing with file watching:

TOKEN="your-discord-bot-token" bun run logs:ui:dev

Next Steps

After the bot starts, invite it to your server, check its Discord permissions, and configure mod logs and mute behavior.