Installation

This guide walks through the baseline install for a Diadem instance.

Prerequisites

Node.js 22+
pnpm
Running Unown# Stack

Installation

Set up the directory
Terminal window
```
git clone https://github.com/ccev/diadem
cd diadem
./setup.sh
```
Diadem’s config files need to sit in specific places. setup.sh sets up syslinks to centralize them all in /config for your convenience.
Configure

Open config/config.toml and fill out as needed. Find the reference here.
Install dependencies and build
Terminal window
```
pnpm install
pnpm run build
```
Push the internal DB schema
Terminal window
```
pnpm run db:push
```
This initializes Diadem tables (users/sessions) in server.internalDb.

Run

You may want to run Diadem using pm2.

PORT=3900 HOST=127.0.0.1 FORCE_COLOR=1 pm2 start build/index.js -n "diadem"

Reverse Proxy (optional)

For production use, it’s probably a good idea to set up Diadem behind a reverse proxy. Here’s a configuration for Caddy that works.
```
example.com {
  root * /path/to/diadem/build
  reverse_proxy * 127.0.0.1:3900
}
```

Updating

Install dependencies and build
Terminal window
```
pnpm install
pnpm run build
```
Restart
Terminal window
```
pm2 restart diadem
```

Docker quick start

For containerized setup using the published ghcr.io/ccev/diadem:latest image:

cp config/config.example.toml config/config.toml
cp docker-compose.example.yml docker-compose.yml
docker compose pull
docker compose up -d

Then edit config/config.toml to point to the correct DB and API hosts for your environment.

To update an existing Docker install:

docker compose pull
docker compose up -d

Dev mode (debugging)

By default Docker uses the optimized published image. To debug an issue with readable, unminified code and source maps in your browser devtools, build the local dev target with a compose override:

cat > docker-compose.override.yml <<'EOF'
services:
  diadem:
    build:
      context: .
      dockerfile: Dockerfile
      target: dev
    image: diadem:dev
EOF
echo "DIADEM_TARGET=dev" >> .env
docker compose up -d --build

This runs the Vite dev server (with its error overlay) instead of node build/index.js. Remove docker-compose.override.yml, set DIADEM_TARGET=runtime (or remove the line), and run docker compose pull && docker compose up -d to return to the published image.