This typically indicates that:
Nextcloud has marked the older DSP method for removal by Nextcloud 35, making HaRP the definitive path for future app development. How to Use HaRP
The Harp did not need a central conductor. It was a decentralized symphony. Every peer was a player. Every file was a note. And the music, once started, never truly stopped.
The official Nextcloud HaRP Repository serves as . Built on top of high-performance HAProxy and integrated with Fast Reverse Proxy (FRP) tunneling, HaRP provides a secure, stateful, and asynchronous gateway for external containers. The Core Architectural Change
"Confirmed. Update the Loom. The whole stanza shifts from pastoral to industrial. This changes the meaning of the entire piece." harp nextcloud
Add the following lines to your virtual host configuration file (before existing configuration):
location /exapps/ proxy_pass http://127.0.0.1:8780; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # WebSocket support proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
If running a custom Docker architecture where Nextcloud and HaRP share a machine, ensure they sit on the exact same internal Docker network.
As Elara dove deeper, she found the heart of the system: a shared folder named [ACTIVE] Loom: The Lost Chorale of Oaxaca . This typically indicates that: Nextcloud has marked the
For organizations currently using the Docker Socket Proxy, planning a migration to HaRP will future-proof your infrastructure and unlock new capabilities.
Multiple servers run identical copies of Nextcloud’s PHP code via .
With WebSockets now fully supported, external apps can deliver true real‑time experiences. Nextcloud itself already uses this capability in its own applications: Nextcloud Office (Collabora integration), Nextcloud Text, and Nextcloud Whiteboard all rely on WebSocket‑based communication to propagate changes instantly. When someone edits a document, their keystrokes appear on other participants’ screens immediately, without needing to refresh the page or wait for a polling interval.
When scaling up, resource-heavy AI tasks or LLMs can be moved to dedicated GPU-equipped hardware. HaRP facilitates this by allowing an external Docker host to securely communicate back over WAN via FRP certificates generated automatically inside the primary /certs/frp storage path. Finalizing Integration inside Nextcloud Admin UI Every peer was a player
version: '3.8' services: nextcloud: image: nextcloud:stable-apache container_name: nextcloud-core networks: - nextcloud_network volumes: - nextcloud_data:/var/www/html restart: always appapi-harp: image: ghcr.io/nextcloud/nextcloud-appapi-harp:latest container_name: appapi-harp environment: - HP_SHARED_KEY=YourSuperSecureRandomSecretKeyHere # Must match Nextcloud configuration - HP_TRUSTED_PROXY_IPS=172.18.0.0/16 # Enter your local Docker CIDR range volumes: - /var/run/docker.sock:/var/run/docker.sock # Allows managing child containers - harp_certs:/certs # Vital for persistent TLS configurations ports: - "8780:8780" # HaRP Control / HTTP Frontend - "8782:8782" # FRP Tunnel connection port networks: - nextcloud_network restart: always networks: nextcloud_network: driver: bridge volumes: nextcloud_data: harp_certs: Use code with caution. Critical Environment Variables Explained HaRP ? · nextcloud all-in-one · Discussion #7061 - GitHub
For new Nextcloud deployments, starting with HaRP from day one is the clear recommended path. Whether you're a home user wanting to experiment with local AI models or an enterprise building custom microservices, HaRP provides the foundation you need.
HaRP replaces the older DockerSocketProxy setup with a single, easy‑to‑use container. Instead of configuring multiple moving parts, you deploy one container, set a shared secret, and point your reverse proxy at it. The GitHub documentation describes it as replacing “more complex setups with an easy‑to‑use container” – and that simplicity is a genuine advantage for administrators who want to get ExApps running without spending hours debugging proxy rules.
Set up your S3 bucket or MinIO cluster. Nextcloud interacts with object storage directly as primary storage, which is significantly faster than mounting S3 as an external storage folder. Create a bucket named nextcloud-harp-storage and note your access keys. Step 3: Initialize the First Web Node