rhdh-local

<essential_principles>

All configuration edits go in `rhdh-customizations/`, never in `rhdh-local/` directly. After every edit, run `rhdh local apply` to sync copies. This is the fundamental invariant. Use `rhdh local up` / `rhdh local down` — never `podman compose restart/up/down` directly when Lightspeed or Orchestrator are enabled. These commands manage the local compose lifecycle directly through Python; do not bypass them with direct compose commands when shared-network services are enabled. See `references/troubleshooting.md` for network namespace details. Plugin package definitions come from `rhdh-plugin-export-overlays` on GitHub. Always fetch the OCI reference from `spec.dynamicArtifact` in the package metadata — do NOT construct OCI URLs manually.

</essential_principles>

## Step 1: Identify What You Want to Do

What would you like to do with your local RHDH instance?

1. Enable a plugin — Add a plugin from the export-overlays catalog to your local RHDH
2. Disable a plugin — Disable or remove a plugin from your local RHDH
3. Switch mode — Switch between Customized (your config) and Pristine (RHDH defaults)
4. Test a plugin — Run end-to-end verification after enabling a plugin
5. Check status — See which plugins are currently enabled

Wait for response before proceeding.

| Response | Workflow | |----------|----------| | 1, "enable", "add plugin", "install plugin" | `workflows/enable-plugin.md` | | 2, "disable", "remove plugin", "turn off plugin" | `workflows/disable-plugin.md` | | 3, "switch", "pristine", "customized", "mode" | `workflows/switch-mode.md` | | 4, "test", "verify", "check plugin" | `workflows/test-plugin.md` | | 5, "status", "list plugins", "show plugins" | Read `rhdh-customizations/configs/dynamic-plugins/dynamic-plugins.override.yaml` and list entries | | "start", "up", "start rhdh" | Run `rhdh local up` (add `--lightspeed`, `--orchestrator`, or `--both` as needed) | | "stop", "down", "stop rhdh" | Run `rhdh local down` | | "health", "check health", "is rhdh running" | Run `rhdh local health` | | "backup", "save config", "archive" | Run `rhdh local backup` | | "restore", "restore backup" | Run `rhdh local restore ` (dry-run by default) | | "env", "environment variables", "env vars", ".env" | Read `references/env-reference.md` | | "troubleshoot", "debug", "504", "error", "not working" | Read `references/troubleshooting.md` |

<reference_index> Customization system (copy-sync, file mapping, edit rules): references/customization-system.md Environment variables (.env reference): references/env-reference.md Troubleshooting & comparative testing: references/troubleshooting.md Container lifecycle, startup scripts, network namespace: references/troubleshooting.md — restart patterns, 504 debugging, network namespace rules Dynamic plugin YAML format, OCI references: ../overlay/references/rhdh-local.md section <dynamic_plugins_config> (if unavailable, see rhdh-plugin-export-overlays repo README for YAML format) </reference_index>

<skills_index>

Skill	Purpose	Path
overlay	Onboard/update plugins in rhdh-plugin-export-overlays	../overlay/SKILL.md
rhdh	Orchestrator — routes to all skills, runs CLI checks	../rhdh/SKILL.md

</skills_index>