Quickstart

Solmara Lab is the standalone Registry Stack adopter demo. This quickstart clones its repository, generates synthetic country configuration and local demo secrets, starts the digest-pinned services, and runs the repository-owned smoke suite. It does not use the retired monorepo Lab or its hosted endpoints.

Outcome

A local Solmara Lab topology verified by its smoke suite.

Time

About 20 minutes, mostly first-run dependency installation and image pulls

Level

Local multi-service demo

Prerequisites

Docker Compose v2justuvPython 3 and OpenSSLpnpm 11.3.0 via corepackgit

Separate adopter repository

Solmara Lab demonstrates Registry Stack but is not a fifth Registry Stack product. Its configuration and orchestration live in registrystack/solmara-lab.

This tutorial uses generated synthetic records and local demo credentials. Do not reuse its keys, tokens, or passwords in another environment.

Get the repository

Clone Solmara Lab and install its pinned Python and Node dependencies:

git clone https://github.com/registrystack/solmara-lab
cd solmara-lab
just setup

just setup installs the generator environments with uv and the portal dependencies with the repository’s pinned pnpm version.

Start and verify the topology

Run these commands from the Solmara Lab checkout:

1. Generate deterministic fixtures, local demo secrets, and TLS material:

   just generate

2. Build the adopter-owned wrapper images and start the topology:

   just up

3. Run the authoritative smoke suite:

   just smoke

The smoke command exits successfully only after the generated configuration, service health, and protected Relay and Notary journeys selected by that Solmara revision pass. A failure stays visible in the command output.

Stop the topology

When you are finished:

just down

What you completed

You generated an adopter-owned country topology, started the Registry Stack services from immutable image references, and verified the running system with the same smoke command Solmara maintains in CI. No deprecated hosted Lab token, URL, or monorepo path is part of the journey.

Next

• First run with Solmara Lab: inspect the topology and call a Notary evaluation route directly.
• Run a protected registry API locally: generate a smaller Relay project from a sample workbook.
• Evaluate a claim with Registry Notary: extend the generated project with Notary.

Troubleshooting

Symptom	Cause	Fix
just generate reports a missing command	A prerequisite is not installed or not on PATH	Install the named tool, then rerun just setup and just generate
Compose cannot pull a pinned image	Docker cannot reach GHCR or the host architecture is unsupported by that release	Confirm registry access and use the platform documented by the pinned Solmara revision
just smoke fails after services start	One or more services are not ready, or generated files do not match the checkout	Read the first failing smoke check, run just down, then regenerate and retry without hand-editing generated files