Docs · Getting started & concepts

Getting started

Use production hostnames only. Local loopback APIs are for contributors, not customers. After signup, Console Overview shows a getting-started checklist (enroll → identity → allow policy → verify sign). Free beta soft caps: 2 identities / 2 signer nodes. Free during the beta, no card required. Paid plans (see pricing) start at the 1.0 release, with 60 days to convert after the end-of-beta notice (paid self-serve Checkout is not enabled yet). Liminal Keys may send transactional email for signup confirmation, end-beta / conversion-grace notices, and billing issues (not marketing).

Service URLs

RoleURL
API https://api.liminalkeys.com
Console https://console.liminalkeys.com (use ?signup=1 for a new workspace)

Operator path

  1. Open Console Open Console sign-up (console.liminalkeys.com/?signup=1) and sign in with Microsoft work or school, Google, Apple, or Sign in with email code when shown on Console. GitHub is not offered. New users create a free beta workspace themselves — no invite or operator ticket required.
  2. Prepare an identity Import a PKCS#12 into custody or generate a CSR, complete it with the issued certificate, then create policy rules (subjects, optional confirmation) and Apply policy.
  3. Issue an enrollment code Create a short-lived enrollment code for the Mac that will sign. Treat it as a secret.
  4. Install Liminal Keys for Mac Contractors can download without Console sign-in from www.liminalkeys.com/download/mac/. Admins can also use Download Liminal Keys for Mac (or copy the contractor install link) on Console Overview.
  5. Enroll the Mac In Liminal Keys for Mac, set API URL to https://api.liminalkeys.com, paste the code, enroll, and refresh identities. For build agents and CI, use the headless Host CLI instead — see CI & pipelines.
  6. Approve the Mac signing extension and sign Allow the Liminal signing extension when macOS prompts. Sign with codesign or Xcode as usual (on-Mac confirmation prompts are coming soon).

Headless enroll

Build Macs and long-lived self-hosted runners use the bundled Host CLI (after installing from download/mac). Always set the production API URL explicitly:

export LIMINAL_KEYS_API_BASE_URL=https://api.liminalkeys.com
export LIMINAL_KEYS_ENROLLMENT_CODE='…from Console Devices…'
liminal-keys enroll --json
liminal-keys refresh --json

Ephemeral GitHub Actions CI uses OIDC and LiminalKeys/liminal-keys-ci-sample/sign@v1 — not enrollment codes. Start from the public sample Quickstart or CI & pipelines.

Console devices and enrollment where Mac enrollment codes are issued

Next (concepts): Console · Security
App & code signing: macOS agent · CI & pipelines
AI agent signing: AI agents & MCP