Rhdh Local

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.

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 |

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 ` (if unavailable, see rhdh-plugin-export-overlays` repo README for YAML format)

| 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 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: redhat-developer
• Source: redhat-developer/rhdh-skill
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.