Migration map for the PMA wiki rebuild (ticket #3932). The legacy Dutch wiki under
/pma-v2/*+/asd-pma/*+/projects/asd-pma/*stays live for now; new content lives under/pma/*. This page is the canonical "where did X move to" reference.
If you came here from a bookmark or external link, the table below points you at the new equivalent. Bookmark the new path — legacy paths will be archived in a follow-up ticket once we're confident the new content covers everything.
/pma-v2/ → /pma/| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/executive/summary |
/pma/why |
Five-personas framing replaces summary |
/pma-v2/executive/business-case |
/pma/compared/vs-saas-stacks |
Cost story + quantified comparison |
/pma-v2/executive/pitch |
/essays/pma-magic |
Long-form positioning |
/pma-v2/executive/roadmap |
— | (Not migrated — roadmap lives in Redmine epics now) |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/getting-started/installation |
/pma/learn/01-install-pma |
Reframed as rung 1 of the learn ladder |
/pma-v2/getting-started/quick-start |
/pma/learn/00-start-here |
Rung 0 — orientation |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/architecture/overview |
/pma/internals/architecture |
Nine-pillars framing |
/pma-v2/architecture/package-system |
/pma/internals/package-system |
Deeper, with hook contracts |
/pma-v2/architecture/mcp-gateway |
/pma/internals/mcp-gateway |
Both layers (gateway + server) |
/pma-v2/architecture/mcp-ecosystem |
/pma/internals/mcp-gateway + /pma/reference/cli/mcp |
Split into internals + reference |
/pma-v2/architecture/multi-tenant |
/pma/cookbook/run-pma-as-a-cooperative + /pma/cookbook/share-pma-with-clients |
Cookbook recipes for the two patterns |
/pma-v2/architecture/docker-infrastructure |
/pma/internals/package-system |
Docker is part of package layer now |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/services/redmine |
/pma/services/redmine |
|
/pma-v2/services/mattermost |
/pma/services/mattermost |
|
/pma-v2/services/n8n |
/pma/services/n8n |
|
/pma-v2/services/erpnext |
/pma/services/erpnext |
|
/pma-v2/services/espocrm |
/pma/services/espocrm |
|
/pma-v2/services/zammad |
/pma/services/zammad |
|
/pma-v2/services/wikijs |
/pma/services/wikijs |
|
/pma-v2/services/grafana |
/pma/services/grafana |
|
/pma-v2/services/loki |
/pma/services/grafana |
Loki covered under Grafana (observability triple) |
/pma-v2/services/openproject |
— | (Not migrated — PMA uses Redmine, not OpenProject) |
/pma-v2/services/openwebui |
— | (Not migrated — optional/experimental; not in default profiles) |
/pma-v2/services/index |
/pma/services |
Service catalogue |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/operations/commands |
/pma/reference/cli |
CLI overview + per-group deep-dives |
/pma-v2/operations/backup-restore |
/pma/learn/05-backup-and-restore + /pma/reference/cli/backup |
Learn rung + reference |
/pma-v2/operations/health-checks |
/pma/reference/cli/lifecycle |
Status / health under lifecycle group |
/pma-v2/operations/troubleshooting |
/pma/cookbook/debug-a-failed-release + /pma/internals/recovery-playbooks |
Decision tree + playbook system |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/integrations/sso |
/pma/learn/04-sso-everywhere + /pma/reference/cli/sso |
Learn rung + CLI ref |
/pma-v2/integrations/email |
/pma/services/postal |
Email service detail |
/pma-v2/integrations/workflows |
/pma/services/n8n |
n8n shipped workflows |
/pma-v2/integrations/logging |
/pma/services/grafana |
Loki/Promtail covered there |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/development/workflow |
/pma/learn/06-release-and-rollback + /pma/internals/release-orchestrator |
Atomic release flow |
/pma-v2/development/skills |
/pma/internals/install-skill |
Install Skill protocol in depth |
/pma-v2/development/api-reference |
/pma/reference/cli/mcp |
MCP tools as the canonical API surface |
/pma-v2/development/contributing |
— | (Not migrated — see CLAUDE.md + CLAUDE-OPERATIONS.md in the repo) |
| Legacy path | New path | Notes |
|---|---|---|
/pma-v2/reference/glossary |
/pma/reference/glossary |
Refreshed in English |
/pma-v2/reference/faq |
— | (Not migrated as a single page — answers distributed across /pma/why, /pma/cookbook/*, /pma/compared/vs-saas-stacks) |
/pma-v2/reference/changelog |
— | (Not migrated — release history lives in git log + Redmine releases #) |
/pma-v2/style-guide |
— | (Not migrated — CLAUDE.md Golden Rule 17 covers English + style for new content) |
/asd-pma/ orphans → new| Legacy path | New path | Notes |
|---|---|---|
/asd-pma/services-yaml-configuration |
/pma/reference/services-yaml |
Lifted + reformatted |
/projects/asd-pma/ → /pma/| Legacy path | New path | Notes |
|---|---|---|
/projects/asd-pma/start |
/pma/learn/00-start-here |
|
/projects/asd-pma/pitch |
/essays/pma-magic |
Long-form pitch |
/projects/asd-pma/executive-summary |
/pma/why |
|
/projects/asd-pma/cockpit |
/pma/reference/cli |
Cockpit = dashboard = just |
/projects/asd-pma/commands |
/pma/reference/cli |
|
/projects/asd-pma/commands/health-check |
/pma/reference/cli/lifecycle |
|
/projects/asd-pma/services |
/pma/services |
|
/projects/asd-pma/services/* |
/pma/services/<svc> |
Per-service equivalent |
/projects/asd-pma/architecture/overview |
/pma/internals/architecture |
|
/projects/asd-pma/architecture/configuration |
/pma/internals/bootstrap |
Bootstrap covers config flow |
/projects/asd-pma/architecture/monitoring |
/pma/services/grafana |
|
/projects/asd-pma/getting-started/* |
/pma/learn/01-install-pma + /pma/learn/02-add-a-service |
| Legacy content | Why |
|---|---|
| Roadmap pages | Lives in Redmine epics — single source of truth |
| FAQ as a single page | Distributed across /pma/why, cookbook recipes, vs-saas-stacks — fewer-but-deeper answers |
| Changelog | Git log + Redmine releases — no manual maintenance |
| Style guide | Subsumed into Golden Rule 17 + docs/framework/DOC-HYGIENE.md |
| Contributing guide | CLAUDE.md is the operational guide; AI agents follow Install Skill |
| OpenProject + OpenWebUI service pages | Not in PMA's default profiles |
| Topic | Status |
|---|---|
| FAQ page consolidating common questions | Possibly future ticket if demand is high |
| Per-service deep-dive cookbook recipes | Currently covered at the service-page level |
| Video walkthroughs | Not planned in this rebuild |
This page is the migration map. If you want to set up server-side
HTTP redirects (so users hitting legacy URLs auto-redirect to the new
ones), Wiki.js v2 supports this via Page Properties → Redirect. The
work is per-page (no bulk redirect mechanism in v2). A follow-up
ticket can automate this via the GraphQL API if there's appetite.
For now, the legacy pages stay live + searchable; this redirect
page is linked from the home page so people who land on a legacy
page can navigate themselves.