Skill

rhdh-local

Name: rhdh-local
Author: Red Hat Developer

test Red Hat Developer Hub plugins locally

Published by Red Hat Developer Updated Jul 16

Covers Local Development Plugin Development Testing

Description

Test RHDH plugins locally using the rhdh-local-setup customization system. Covers enabling/disabling plugins, switching modes, running end-to-end plugin tests, starting/stopping RHDH (up/down), health checks, troubleshooting errors (504, startup failures), and backup/restore of configurations. Use when asked to "test plugin locally", "local RHDH setup", "start local Developer Hub", "rhdh-local-setup", "local development environment", "podman compose RHDH", or "run RHDH on my machine".

SKILL.md

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

Enable a plugin — Add a plugin from the export-overlays catalog to your local RHDH
Disable a plugin — Disable or remove a plugin from your local RHDH
Switch mode — Switch between Customized (your config) and Pristine (RHDH defaults)
Test a plugin — Run end-to-end verification after enabling a plugin
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.mdEnvironment variables (.env reference): references/env-reference.mdTroubleshooting & comparative testing: references/troubleshooting.mdContainer 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>

More skills from the rhdh-skill repository

View all 20 skills

SkillTagsUpdated

More from Red Hat Developer

View publisher

SkillTagsUpdated