: On the remote machine, create a frpc.toml file pointing to your HaRP server's address on port 8782.
Once the container is running, you must tell Nextcloud how to find it. Navigate to > AppAPI . Click Register Daemon .
:You can deploy HaRP using a standard Docker command. Ensure you publish the necessary ports: Port 8780 : Standard HTTP communication. Port 8782 : FRP tunnel port for ExApps. harp nextcloud install
For , add a location block above your main Nextcloud route:
: A running Docker engine where you can deploy the HaRP container. : On the remote machine, create a frpc
docker run -d \ --name appapi-harp \ --network host \ -e HP_SHARED_KEY="your_secure_password" \ -e NC_INSTANCE_URL="https://nextcloud.url" \ -e HP_TRUSTED_PROXY_IPS="172.18.0.0/16,127.0.0.1" \ -v /var/run/docker.sock:/var/run/docker.sock \ ghcr.io/nextcloud/harp:latest Use code with caution.
: 32 or newer is highly recommended for full HaRP support. Click Register Daemon
HP_TRUSTED_PROXY_IPS : The IP or CIDR range of your main reverse proxy (e.g., Nginx or Caddy).
To enable direct routing (and WebSockets), your main reverse proxy (Nginx, Apache, or Caddy) needs a redirect for the /exapps/ path.
Note: Using --network host is the simplest way to ensure local reachability, but you can also use a dedicated Docker network if preferred. Step 2: Register the HaRP Daemon in Nextcloud