Harp Nextcloud Install [TESTED]

We will use the official Nextcloud Helm chart from Bitnami or truecharts. Below is a production values.yaml.

nextcloud-values.yaml:

# Global settings
global:
  storageClass: "longhorn"  # or your preferred CSI

nextcloud:
host: nextcloud.example.com
existingSecret:
name: nextcloud-secrets
key: admin-password
username: admin
existingSecretEnabled: true


Installing and Configuring HaRP for Nextcloud AppAPI HaRP (High-performance AppAPI Reverse Proxy) is the next-generation deployment daemon for Nextcloud Hub 32+, replacing the older DockerSocketProxy (DSP). It acts as a dedicated bridge and proxy for External Apps (ExApps), enabling them to communicate directly with clients via WebSockets and bypass the standard PHP stack for improved performance. 1. Prerequisites Before beginning the installation, ensure you have:


Nextcloud 32 or higher (HaRP is the recommended standard for these versions). Docker and Docker Compose installed on your host. Administrative access to your Nextcloud instance. The AppAPI app installed from the Nextcloud App Store. 2. Deploying the HaRP Container


HaRP is typically deployed as a standalone Docker container. Use the following docker-compose.yml snippet to launch it:


services: appapi-harp: image: ghcr.io/nextcloud/nextcloud-appapi-harp:release container_name: appapi-harp restart: always environment: - HP_SHARED_KEY=your_very_secure_password # Minimum 12 characters - NC_INSTANCE_URL=https://your-nextcloud-domain.com volumes: - /var/run/docker.sock:/var/run/docker.sock:ro # Access to Docker engine - ./harp_certs:/certs # Persistent storage for FRP certificates networks: - nextcloud_network networks: nextcloud_network: external: true  Use code with caution.


HP_SHARED_KEY: A secret key used to authenticate communication between Nextcloud and HaRP. harp nextcloud install


NC_INSTANCE_URL: The full URL of your Nextcloud installation.


Persistent Volume: Mounting /certs is critical. If these certificates are lost, existing ExApp tunnels will fail due to TLS mismatches. 3. Registering the HaRP Daemon in Nextcloud


Once the container is running, you must link it to Nextcloud through the web interface: Installing Harp for ExApps: Can't Connect from Nextcloud


The Basics. Nextcloud Server version (e.g., 29. x.x): 31.0. 4. Operating system and version (e.g., Ubuntu 24.04): Ubuntu 24.04. 2. Nextcloud community


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




This guide assumes "HARP" refers to a Linux server/environment (e.g., a host named HARP). If you meant a different HARP (Harp static site server, HARP stack, or a hosting provider), tell me and I’ll adapt.


Prerequisites



Step 1 — Update system



Step 2 — Install required packages



Step 3 — Secure and configure MariaDB





Step 4 — Download Nextcloud



Step 5 — Configure PHP




  • Restart PHP-FPM: sudo systemctl restart php*-fpm
    • 


    Step 6 — Nginx site config
    


    Step 7 — Obtain HTTPS certificate
    


    Step 8 — Complete web-based setup
    


    Step 9 — Recommended post-install
    


    Troubleshooting tips
    


    If you want, I can:
    


    

    Add these to your Ansible provisioning stage:
    


    

    One of the best features of using Harp is painless updates.
    

    To update to the latest Nextcloud version, just change the version tag in your harp.json (if pinned) or simply run: We will use the official Nextcloud Helm chart
    

    harp update

    

    Harp will:
    


    Zero downtime. Zero anxiety.