SELF-HOST EDITION · VERSION 0.0.3AT

Run ARK Bot on your own server

Run ARK Bot with your own Discord application, database and optional AI provider. Your server settings remain under your control.

Requirements

1. Node.js >=22.0.0, npm and a reachable MongoDB service.
2. A Discord application, bot token and client ID, configured by the operator.
3. Outbound HTTPS access when using optional AI features.

Run the ready-to-run archive

1. Extracttar -xzf ARK-Bot-selfhost-0.0.3AT.tar.gzcd ark-bot-selfhost
2. Install runtime dependenciesnpm ci --omit=dev

   Already compiled: no TypeScript build step, no dev dependencies.

3. Configurecp .env.example .env

   Set Discord and MongoDB credentials in your local environment file.

4. Register commandsnpm run deploy:commands

   Registers commands for your Discord application.

5. Runnpm start

   Use /settings in your Discord server to configure modules.

Build the source archive

1. Extracttar -xzf ARK-Bot-source-0.0.3AT.tar.gzcd ARK-Bot/bot
2. Install and compilenpm cinpm run typechecknpm run build
3. Configurecp .env.example .env
4. Register and runnpm run deploy:commandsnpm start

From a full source checkout you can also run ./scripts/buildStart.sh in the repository root instead of doing the install, build and run steps by hand: it builds and then starts the bot and the website together, and ./scripts/buildStart.sh bot (or web) targets one of them. Run npm run deploy:commands once per Discord application first, because the scripts never register commands for you.

Neither archive contains credentials. Availability requires the matching release SHA-256 manifest.

Need setup help? See self-host troubleshooting.