Schemas, CLI commands, glossary. Reference-grade — dense, accurate, scannable.
| Page | What it covers |
|---|---|
| Manifest schema | packages/<svc>/manifest.yaml — service identity, containers, DB, SSO, backup, health, E2E test config. Every field documented. |
| services.yaml schema | services.yaml — the project-wide service registry, profiles, command structure, port allocation patterns. |
The route schema (packages/<svc>/net.manifest.yaml) is owned by
asd — see /asd/reference/net-manifest.
PMA's CLI surface is built from just recipes wrapping asd and
service-specific scripts.
| Page | What it covers |
|---|---|
| CLI overview | Top-N just recipes + "I want to…" recipe table |
just <svc>-* lifecycle |
start / stop / restart / status / logs per service |
| User management | just user-add-all, just <svc>-create-user, just <svc>-list-users |
| Backup + restore | just backup, just restore, just list-backups |
| SSO management | just sso-add, just sso-check, just sso-fix |
| Release + revert | just release-run, just release-revert, just release-state |
| MCP gateway + tools | just mcp-asd, MCP server tools available to AI agents |
For the underlying asd CLI, see /asd/reference/cli.
Glossary — every PMA-specific term, defined once.
For asd-specific terms (manifest, route, tunnel, registry,
caddy-state, client-id, etc.) see the /asd/reference/glossary.
Reference is for looking things up. If you're learning by doing,
start at /pma/learn. If you have a specific problem,
/pma/cookbook. If you want to understand internals,
/pma/internals.