Create the first workspace

Oriel refuses to create additional instance-admin users through the bootstrap command after any user already exists. Run bootstrap once during first install.

Bootstrap the first admin

For compose:

cd deploy/compose
docker compose -f local.yml exec -e ORIEL_BOOTSTRAP_PASSWORD='change-me' oriel \
  oriel admin bootstrap --email you@example.com --name "Your Name"

For a systemd or bare-binary install:

sudo -u oriel ORIEL_BOOTSTRAP_PASSWORD='change-me' \
  oriel --config /etc/oriel/oriel.toml admin bootstrap \
  --email you@example.com --name "Your Name"

Bootstrap also grants the first admin owner access to the reserved _oriel self-observability workspace.

Create a workspace

docker compose -f local.yml exec oriel \
  oriel admin create-workspace --slug demo --name "Demo"

Workspace slugs use lowercase letters, numbers, and hyphens. Leading underscore slugs are reserved for migration-seeded workspaces such as _oriel.

Sign in

Open:

http://localhost:6743

Sign in with the email and password from the bootstrap step. Accounts can also be backed by OIDC once providers are configured.

Create the first telemetry scope

• Create a project and environment in Settings.
• Create an ingest token for that project.
• Send OTLP traces, logs, or metrics to Oriel.