Harp Nextcloud Install [better]

Since you are looking to install Nextcloud HaRP (HTTP Autoregister Reverse Proxy), this draft post outlines the steps to set up the new proxy system designed for Nextcloud 32+ External Apps (ExApps). Draft Post: Setting Up Nextcloud HaRP for External Apps

If you are tired of dependency hell and want a production-grade Nextcloud instance without spending two days debugging a 502 Bad Gateway error, Harp is your solution. This article is the definitive guide to performing a harp nextcloud install—from zero to fully functioning cloud. harp nextcloud install

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. Since you are looking to install Nextcloud HaRP

Add a weekly scheduled pipeline to check for new Nextcloud images and re-deploy. Can't access the site

Troubleshooting

  • Can't access the site? Ensure ports 80 and 443 are open in your cloud provider's firewall (e.g., AWS Security Groups, DigitalOcean Firewalls) and on your server firewall (ufw).
  • SSL Errors? Ensure your domain DNS is fully propagated before starting the installation, or Let's Encrypt will fail to issue a certificate.

3. Configure the Instance

  1. You will be presented with a screen asking for a password. The password is generated and displayed in your terminal logs. To find it, run: 
    sudo docker logs nextcloud-aio-mastercontainer
    (Look for the line that says Your initial master password is: ...).
  2. Login and configure your options. Ensure you enter your domain correctly in the "Domain" field.
  3. Timezone: Set this to match your server (e.g., America/New_York or Europe/London).
  4. Click "Start Containers."

variables: HELM_RELEASE: nextcloud NAMESPACE: nextcloud CHART_VERSION: "4.5.0" # update weekly

Prerequisites

To top