Skip to content

ddtcorex/maestro-skills / skills/govard-toolbox

govard-toolbox

Flagged

Use when starting or stopping a Govard environment, running container commands, database dump or import, syncing from staging, Xdebug, or a deploy and its rehearsal. Keywords govard up, govard sh, govard deploy.

FileKindSize
SKILL.mdskill md10.4 KB
references/AUDIT.mdmarkdown4.6 KB
references/COMMANDS.mdmarkdown7.3 KB
references/CONFIGURATION.mdmarkdown2.2 KB
references/DEPLOYMENT.mdmarkdown4.8 KB
references/FAQ.mdmarkdown3.5 KB
references/GUIDES.mdmarkdown2.8 KB
references/HOST-WITHOUT-DOCKER.mdmarkdown1.8 KB
references/SANDBOX.mdmarkdown5.0 KB
references/VERIFY.mdmarkdown23.8 KB

references/FAQ.md

View on GitHub
# Govard FAQ & Troubleshooting

Common questions, issues, and official solutions for Govard environments.

## 1. Installation & Environment

### Q: Installer fails with a permission error

**A**: Use the `--local` flag to install to `~/.local/bin` instead of `/usr/local/bin`.

```bash
curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash -s -- --local
```

### Q: Port conflict when starting environment

**A**: `govard doctor` reports conflicts on ports 80/443; `--fix` does not free them. Find the process holding the port (for example `ss -tlnp`), stop it, then run `govard svc up` again.

### Q: Host/Domain identity collision

**A**: Change `project_name` or `domain` in `.govard.yml` to a unique value. Update with `govard config set` (alias `cfg`).

---

## 2. SSL & Network

### Q: Browser shows "Your connection is not private"

**A**: Run `govard svc up` (shared proxy) and `govard doctor trust` (re-import Root CA).

### Q: Domain doesn't resolve (.test)

**A**: Ensure the global DNS service is running with `govard svc up`. Use `resolvectl query <domain>` for diagnostics.

### Q: RabbitMQ management UI not reachable

**A**: Check `stack.services.queue` is `rabbitmq` (not `none`), re-run `govard env up`, and use `http://<domain>:15672` (plain HTTP, guest/guest), never `https://`.

---

## 3. Remote & Sync

### Q: Sync takes too long or times out

**A**: Use `--no-compress` (less CPU usage) and skip data with `--no-noise` or `--no-pii`.

```bash
govard sync -s staging --full --no-compress --no-noise
```

### Q: Authenticity of host can't be established

**A**: Use `govard remote copy-id <remote>` to add your SSH key to the remote host.

### Q: Gateway SSH refused / sandbox unreachable at :2222

**A**: Check the chain: `govard svc up` (bastion), then `govard sandbox up` (target), then `govard gateway allow-key` (key). `gateway status` shows target and allowlist counts and warns if port 2222 is held by another process. Log in as the slugged name (`Foo_Bar` becomes `foo-bar`); pass the key as one quoted shell argument.

### Q: Remote dump fails

**A**: A failed dump is reported as a failure, not as an empty file; read the credential warning first. A remote path that points at the layout root is fine (Govard probes `<path>`, `public_html`, `current`); "no database configuration at ..." lists every path tried, so check the path before retrying.

---

## 4. Frameworks & Database

### Q: Magento 2 Database password is wrong after bootstrap

**A**: Run `govard config auto` to rebuild the app-level config (for Magento, `app/etc/env.php`) with the correct local credentials.

### Q: PHPMyAdmin doesn't show my project's database

**A**: Run `govard env up` to re-register the project with the global proxy/PMA.

---

## 5. Xdebug

### Q: Xdebug is not connecting to my IDE

**A**:
1. Check state: `govard debug status`
2. Match cookie: `XDEBUG_SESSION` must match `stack.xdebug_session` in `.govard.yml`
3. Check IDE: Port 9003 must be listening

### Q: Xdebug slows down my site

**A**: Use `govard debug off` to disable Xdebug when not in use. With the `XDEBUG_SESSION` cookie absent, requests are not routed to the debug container.

---

## 6. Resources & Performance

### Q: Docker storage is full

**A**:
1. `govard project orphans` to find stale projects
2. `govard project delete <name>` for unused projects
3. `govard env cleanup` to prune stale compose files and manifests

### Q: Desktop App shows old data

**A**: Restart the desktop process, and make sure the installed Govard binaries are current (`govard self-update`).
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall