Skip to content
Oriel

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

Section titled “Bootstrap The First Admin”

For compose:

Terminal window
cd deploy/compose
docker compose 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:

Terminal window
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

Section titled “Create A Workspace”
Terminal window
docker compose 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

Section titled “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.

Next Steps

Section titled “Next Steps”
  • Create a project and environment in Settings.
  • Create an ingest token for that project.
  • Send OTLP traces, logs, or metrics to Oriel.