Random-access how-tos for single PMA problems. Pick the recipe whose title matches what you're trying to do.
Status: recipes are being written as part of the PMA rebuild (ticket #3932). Pages marked planned below will land in subsequent batches.
| Recipe | When you'd reach for it |
|---|---|
| Install a new service (planned) | "I want PMA to manage a service that isn't bundled." |
| Migrate from cloud SaaS (planned) | "We're moving off Salesforce / Atlassian / Slack. Migrate the data." |
| Integrate existing Authentik (planned) | "We already have Authentik. Use it instead of PMA's bundled one." |
| Run PMA as a cooperative (planned) | "Multi-tenant pattern for our community / NGO / cooperative." |
| Upgrade a service safely (planned) | "Bump a service's version without breaking SSO + backups." |
| Debug a failed release (planned) | "release-run failed mid-phase. Now what?" |
| Share PMA with clients (planned) | "Agency pattern — one PMA install per client with profiles." |
The cookbook grows as common questions land in the issue tracker.
If your problem isn't here, check:
/pma/learn ladder — the concept might be covered as a rung./pma/reference pages — for "what does this field do?"./pma/services page for the specific service in question.just (tab-complete) — for "what command should I use?".If none of those answer your question, that's a missing recipe.
File an issue or PR against the docs.