Harp Nextcloud — Install
: 32 or newer is highly recommended for full HaRP support.
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
: The AppAPI app must be installed and enabled on your Nextcloud instance. Step 1: Deploy the HaRP Container : 32 or newer is highly recommended for full HaRP support
By using HaRP, ExApps can communicate directly with clients via WebSockets, bypassing the main Nextcloud PHP stack to significantly reduce latency and improve performance for real-time features like AI chats or document indexing. Prerequisites Before beginning the installation, ensure you have: Step 1: Deploy the HaRP Container By using
nextcloud/HaRP: Fast Proxy for AppAPI(Nextcloud 32+) - GitHub
NC_INSTANCE_URL : Your public Nextcloud URL (e.g., https://cloud.example.com ).
: Start the FRP client container on the remote machine to establish the secure tunnel. Troubleshooting and Verification