: 32 or newer is highly recommended for full HaRP support.
NC_INSTANCE_URL : Your public Nextcloud URL (e.g., https://cloud.example.com ).
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. harp nextcloud install
Once the container is running, you must tell Nextcloud how to find it. Navigate to > AppAPI . Click Register Daemon .
HP_TRUSTED_PROXY_IPS : The IP or CIDR range of your main reverse proxy (e.g., Nginx or Caddy). : 32 or newer is highly recommended for full HaRP support
: Copy the generated certificates from the HaRP container to the remote machine. docker cp appapi-harp:/certs/frp/client.crt ./certs/frp/ Use code with caution.
: Start the FRP client container on the remote machine to establish the secure tunnel. Troubleshooting and Verification Once the container is running, you must tell
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
: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.