Nextcloud Install - Harp

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.

: 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.

: The AppAPI app must be installed and enabled on your Nextcloud instance. Step 1: Deploy the HaRP Container harp nextcloud install

nextcloud/HaRP: Fast Proxy for AppAPI(Nextcloud 32+) - GitHub

: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. Complete Guide to Installing HaRP for Nextcloud AppAPI

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:

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. docker cp appapi-harp:/certs/frp/client

: On the remote machine, create a frpc.toml file pointing to your HaRP server's address on port 8782.

NC_INSTANCE_URL : Your public Nextcloud URL (e.g., https://cloud.example.com ).