HaRP operations
HaRP is the service AppAPI drives to deploy and reach External Apps. It is three things in one container: the HTTP frontend that carries all ExApp traffic, the FRP tunnel server that ExApp containers dial back into, and the control path AppAPI uses to manage Docker or Kubernetes. Most "my ExApp is broken" reports are really one of those three planes failing, and each fails with a different signature.
This skill is HaRP itself. Registering daemons, installing ExApps and the occ surface are exapp-operations.
How to work
- Read references/harp-operations.md: the planes, the probes, the configuration that matters, log decoding, upgrades, certificates and symptom-first troubleshooting.
- Collect the state before theorising: assets/harp-triage.sh prints container health, the reported version, ports, the probe results and recent errors, with secrets redacted.
- Fix the daemon registration or the ExApp instead if the fault is on that side: exapp-operations.
Facts that save hours
- Read the status code first, it names the plane:
401shared key,403route access level,404unknown route or an app not on this daemon,502an infrastructure route or a proxy rule pointing nowhere,503the agent under load. GET /on the HTTP frontend answers404by design. Never use it as a health probe; use/exapps/app_api/infowith theharp-shared-keyheader.- One HaRP serves one Nextcloud.
NC_INSTANCE_URLis a single value and every request is authorised against that instance. - HaRP must be reachable at
<nextcloud_url>/exapps/: AppAPI talks to ExApps through the public URL, so a missing reverse-proxy rule blocks installs, not just browsers. - Regenerating the FRP certificates invalidates every deployed ExApp: they embed them at install time and must be reinstalled, not restarted.
:releaseis the newest release,:latestand:mainare built frommain. Pin:vX.Y.Zif you need a known version.
Files
- references/harp-operations.md: the runbook.
- assets/harp-triage.sh: read-only diagnostics collector.
- Daemon registration, ExApp lifecycle and the occ surface: exapp-operations. ExApps on a separate host or in Kubernetes: remote-daemon.md, kubernetes.md.