Harp Nextcloud: Install

SSH into your Nextcloud server:

cd /var/www/nextcloud/custom_apps
sudo git clone https://github.com/gabrielbruin/harp.git

Note: Your Nextcloud path might be /var/www/html/nextcloud or /apps/www/nextcloud. Adjust accordingly.

| Problem | HARP solution | |---------|----------------| | “Data directory not writable” | Check PVC permissions; run occ files:scan --all via Ansible | | Slow uploads | Increase php memory_limit and client_max_body_size in ingress | | Redis connection refused | Verify Redis secret and service discovery (redis-headless) | | Helm upgrade fails | Use --history-max 2 and --atomic flag | | Rancher can't access cluster | Re-import kubeconfig via rancher-cli or refresh token | harp nextcloud install

Create an Ansible playbook that deploys a lightweight K3s cluster (ideal for edge/self-hosted) or a full K8s on VMs.

provision-cluster.yml (excerpt):

- hosts: all
  become: yes
  roles:
    - role: xanmanning.k3s
      vars:
        k3s_version: v1.27.4+k3s1
        k3s_server_manifests_templates:
          - longhorn.yaml
        k3s_install_hard_links: true

Run:

ansible-playbook -i inventory/hosts.ini provision-cluster.yml

Then import the cluster into Rancher via the rancher2 Ansible module or Rancher UI. Create an Ansible playbook that deploys a lightweight

redis: enabled: true architecture: standalone auth: existingSecret: redis-secret master: persistence: enabled: true size: 5Gi

Harp sets safe defaults, but you should add these layers manually: harp nextcloud install

sudo -u www-data php /var/www/nextcloud/occ files:scan --all

Log out of your Nextcloud session and log back in. The Harp icon should now appear.