Getting started

Signing in

ogma has no passwords and no public sign-up. Your account is created by an administrator; you sign in with the email address they used. Sign-in is handled by the shared account service — one session works across all the apps that use it.

<img class="shot-light" src="/img/help/sign-in-light.webp" alt="The sign-in page: an email field and an "Email me a code" button, under the note "We'll email you a six-digit code — no password." A line below reads "Accounts are created by an administrator.""> <img class="shot-dark" src="/img/help/sign-in-dark.webp" alt="The sign-in page: an email field and an "Email me a code" button, under the note "We'll email you a six-digit code — no password." A line below reads "Accounts are created by an administrator."">

1. Go to the ogma URL — you'll be sent to the account service's Sign in.
2. Enter your email and choose Email me a code.
3. We send a six-digit code to that address. Enter it on the next screen.
4. That's it — you're back in ogma.

The code is single-use, expires after 10 minutes, and you can request a new one if it doesn't arrive (there's a short wait between requests). If the email address isn't a known account, nothing happens — so double-check the address your administrator set up.

Some installations add a "Verify you are human" check below the sign-in box. It usually confirms on its own; if it asks for a click, give it one before choosing Email me a code. It needs JavaScript — the page says so if yours is turned off.

Running ogma yourself? In development builds the account service shows the code right on the verification screen (a small dev: NNNNNN hint), so you don't need email configured to try it out.

Your dashboard

After signing in you're on Projects — your dashboard:

<img class="shot-light" src="/img/help/dashboard-light.webp" alt="The Projects dashboard: one project tile named Aurora relay with its description, member avatars and a card count, beside a dashed "New project" tile."> <img class="shot-dark" src="/img/help/dashboard-dark.webp" alt="The Projects dashboard: one project tile named Aurora relay with its description, member avatars and a card count, beside a dashed "New project" tile.">

Every project you're a member of appears as a tile, with a git-provider badge when a repository is linked.

The top navigation also has My work, which gathers every card assigned to you across all your projects, and a bell that collects your notifications (see Writing & mentions).

Creating your first project

1. On the dashboard, choose the dashed tile — Start your first board (it reads New project once you have some).
2. Give it a name and, optionally, a description and a repository URL.
3. Create it — you're now the project Owner, and a fresh board opens with a few starter columns.

From here, head to Projects & boards to start adding columns and cards.

Signing out

Open the avatar menu in the top-right and choose Log out.