Harp Nextcloud Install Updated -

Setting Up HaRP for Nextcloud 32+ HaRP (High-performance AppAPI Reverse Proxy) is the new recommended bridge for running External Apps (ExApps) in Nextcloud 32 and beyond. It replaces the older DockerSocketProxy, offering better performance and native support for features like WebSockets. Why Use HaRP?

Direct Routing: Requests bypass the Nextcloud PHP stack, significantly reducing resource usage.

WebSocket Support: Essential for real-time AI assistants and interactive external apps.

Simplified Networking: Uses FRP (Fast Reverse Proxy) tunnels, so your ExApp containers don't need to expose ports to the host or be on the same network as Nextcloud. Step-by-Step Installation 1. Deploy the HaRP Container

The easiest way to start is using the official nextcloud/HaRP GitHub image. You'll need to define a shared key for secure communication. Example Docker Run Command:

docker run -d \ --name appapi-harp \ -e HP_SHARED_KEY="your_secure_password" \ -e NC_INSTANCE_URL="https://yourdomain.com" \ -p 8780:8780 -p 8782:8782 \ ghcr.io/nextcloud/nextcloud-appapi-harp:release Use code with caution. Copied to clipboard Port 8780: Handles HTTP/WebSocket traffic. Port 8782: The FRP server for ExApp tunnels. 2. Register the Daemon in Nextcloud Log in to your Nextcloud instance as an admin. Navigate to Administration settings > AppAPI. Click Register Daemon.

Choose the HaRP Proxy (Host) or HaRP Proxy (Docker) template. Fill in the details: HaRP host: :8780 FRP server address: :8782 HaRP shared key: Use the same HP_SHARED_KEY from Step 1. Click Check connection and then Register. 3. Update Your Reverse Proxy (Important) harp nextcloud install

To ensure everything works correctly, especially for external access, you must route requests for /exapps/ directly to the HaRP container. Apache Example Snippet:

ProxyPreserveHost On ProxyPass http://127.0.0.1:8780/exapps/ nocanon ProxyPassReverse http://127.0.0.1:8780/exapps/ Use code with caution. Copied to clipboard

Note: Ensure proxy, proxy_http, and headers modules are enabled. Troubleshooting Common Issues

Connection Failed: Double-check that your HP_SHARED_KEY matches exactly in both the Docker environment and the Nextcloud UI.

Docker Version: Some users have reported issues with older Docker versions; ensure you are running a recent version (v29+ is recommended) to avoid API client mismatches.

Certificate Persistence: If running in a Kubernetes or ephemeral environment, ensure the /certs directory is mounted to a persistent volume, or HaRP will regenerate CA certs on restart, orphaning existing ExApps. Setting Up HaRP for Nextcloud 32+ HaRP (High-performance

For deeper configuration details, check out the official Docker Deploy Daemon (HaRP) Documentation. Docker Deploy Daemon (HaRP) - Nextcloud Documentation

Step 4: Verify Installation

Wait for the "App enabled" success message. Nextcloud may prompt you to install additional dependencies—accept them. Once complete, you will see a new "Music" (or Harp) icon appear in your Nextcloud top navigation bar.

Step 1: Preparing Your Server Environment

SSH into your target server:

ssh root@your-server-ip

While Harp will handle most configurations, the server needs to be minimally prepared. Run the following to update the system and install basic tools:

apt update && apt upgrade -y
apt install -y curl git ufw

Firewall Configuration (UFW): Harp will need ports 22 (SSH), 80 (HTTP), and 443 (HTTPS) open.

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable

Now, exit the SSH session and return to your local machine. We will now deploy from local to remote. Step 4: Verify Installation Wait for the "App

Implement Rate Limiting

To prevent brute-force attacks on your Harp API endpoint, add this to your Nextcloud .htaccess or Nginx config:

location ~ /harp/ 
    limit_req zone=music burst=5;

Step 2: Prepare Rancher Project & Namespace

In Rancher UI:

  1. Create a new Project called Nextcloud-Project.
  2. Within it, a Namespace named nextcloud.
  3. Enable Project Monitoring for Prometheus metrics.
  4. Set resource quotas: CPU 4-8 cores, Memory 8-16Gi.

For CLI lovers, use rancher-cli:

rancher namespace create nextcloud --project p-xxxxx

Conclusion: Your Music, Your Server, Your Rules

Completing a Harp Nextcloud install turns your Nextcloud instance from a simple file sync tool into a serious music streaming platform. You are no longer at the mercy of streaming services removing albums or raising prices.

Whether you are a self-hosting veteran or a beginner with a Raspberry Pi, Harp offers the perfect balance of simplicity and power. It respects your privacy, handles large libraries gracefully, and even connects to high-end mobile players via Ampache.