# Rhdh Local

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-redhat-developer-rhdh-skill-rhdh-local`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [redhat-developer](https://agentstack.voostack.com/s/redhat-developer)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [redhat-developer](https://github.com/redhat-developer)
- **Source:** https://github.com/redhat-developer/rhdh-skill/tree/main/skills/rhdh-local

## Install

```sh
agentstack add skill-redhat-developer-rhdh-skill-rhdh-local
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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](https://github.com/redhat-developer)
- **Source:** [redhat-developer/rhdh-skill](https://github.com/redhat-developer/rhdh-skill)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-redhat-developer-rhdh-skill-rhdh-local
- Seller: https://agentstack.voostack.com/s/redhat-developer
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.