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:
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 first step is to set up a Docker container called appapi-harp that will act as the bridge between Nextcloud and your external apps. : HP_SHARED_KEY : A secure secret token for authentication. By using HaRP, ExApps can communicate directly with
Complete Guide to Installing HaRP for Nextcloud AppAPI (Nextcloud AppAPI HaProxy Reverse Proxy) is the next-generation proxy system designed to simplify the deployment of External Apps (ExApps) in Nextcloud 32 and later . It replaces the older Docker Socket Proxy (DSP) method, which is slated for deprecation in Nextcloud 35. : HP_SHARED_KEY : A secure secret token for authentication
Choose the or HaRP Proxy (Docker) template. Fill in the details: Host : Use localhost:8780 if HaRP is on the same machine. FRP Server Address : Typically localhost:8782 . Shared Key : Must match the HP_SHARED_KEY set in Step 1. Click Check Connection and then Register . Step 3: Configure Your Main Reverse Proxy