AI runbook

Prerequisites only the human can resolve

• A Discord Developer Portal account
• Docker Desktop installed and open — the daemon does not start itself
• Node.js installed
• A fork of the OpenCall repository, or the original repo to clone

No cloud account, no card, no domain. The clickable version of this path is Run locally with Docker.

1. Check the machine

docker info > /dev/null && echo "docker ok"
node --version
pnpm --version || npm install -g pnpm

If docker info fails, Docker Desktop is not running: pause for human action, do not try to start the daemon yourself.

2. Clone and install

git clone https://github.com/YOUR-USERNAME/OpenCall.git
cd OpenCall
pnpm install

The repo's postinstall runs prisma generate. If it fails, stop here and show the output before moving on.

3. Discord Application

There is no official CLI — 100% manual (see Set up Discord). Ask the human to create the application with the local Redirect URI:

http://localhost:3000/api/auth/callback/discord

Then ask for DISCORD_CLIENT_ID and DISCORD_CLIENT_SECRET.

4. Environment variables

cp .env.docker.example .env

The file already ships every value matching docker-compose.yml (Postgres on 5433, MinIO on 9000, LiveKit on 7880) plus a development NEXTAUTH_SECRET. Fill in only the two Discord lines:

DISCORD_CLIENT_ID=...
DISCORD_CLIENT_SECRET=...

It has to be .env, not .env.local: the Prisma CLI only reads .env, and the migration in step 5 fails with Environment variable not found: DATABASE_URL.

5. Bring up the infrastructure and the app

pnpm dev:docker

The script chains three things: pnpm docker:up (Postgres + MinIO + LiveKit), prisma migrate dev (creates the tables) and pnpm dev (Next.js on 3000).

pnpm dev never exits — it is a long-running process. Run it in the background or in a separate terminal, otherwise the session hangs waiting on it.

The minio-init container finishing with exited (0) is success: it creates the bucket, makes it publicly readable, runs once and stops.

Here the command is prisma migrate dev, not db push: the repository does version prisma/migrations/.

6. Final validation

1. Ask the human to open http://localhost:3000 and log in with Discord — it is that first login that creates the ADMIN.
2. Confirm access to /admin/channels.
3. Test a voice call in the Geral channel, on that same machine.
4. Send a message with an image attached — MinIO stands in for R2.

Warn the human about one structural limit: voice and video only work on that machine. The LiveKit container announces 127.0.0.1 as its ICE candidate, so another device on the same network opens the page but never joins the call. To test with other people, the path is the Free demo tab.

Shutting down

pnpm docker:down          # stops the containers, keeps the data
docker compose down -v    # stops and WIPES database and uploads

Human checkpoints (summary)

• Open Docker Desktop before starting
• Create the Discord Application and paste client id/secret (there is no API)
• Register http://localhost:3000/api/auth/callback/discord as the Redirect URI
• Be the first to log in, to become ADMIN