"I can set up a harp container on my fileserver but outside of my nextcloud container. I got the context chat back and up and running on a separate machine that has a fast GPU. Then from the OCC command line, I would issue a command to enable and register a demon and the app."
Then bring the stack up with:
The remote host, running the ExApps, tunnels its Docker socket to the HaRP container via a secure tunnel (FRP).
CREATE USER nextcloud WITH PASSWORD 'secure_password'; CREATE DATABASE nextcloud_db OWNER nextcloud; GRANT ALL PRIVILEGES ON DATABASE nextcloud_db TO nextcloud; \q Use code with caution.
The installation involves two main parts: running the HaRP Docker container and registering it within Nextcloud. Part 1: Run the HaRP Docker Container harp nextcloud install
Add the following lines:
A is a significant upgrade for any administrator looking to leverage the full power of modern, Docker-based External Apps. By implementing HaRP, you ensure a secure, high-performance environment that streamlines the management of complex Nextcloud extensions.
| Feature | Harp | Plex (via web) | Funkwhale | Koel (standalone) | | :--- | :--- | :--- | :--- | :--- | | | вњ… Native app | вќЊ External | вќЊ Separate | вќЊ Separate | | Uses your Nextcloud storage | вњ… Yes | вќЊ No | вќЊ No | вќЊ No | | Mobile client via API | вњ… Ampache | вњ… Yes | вњ… Yes | вќЊ Limited | | Resource usage | Very low | High | Medium | Very high | | Open source | вњ… GPL | вќЊ Proprietary | вњ… AGPL | вњ… MIT |
Note: If you are using Nextcloud All-in-One (AIO), these locations might be managed automatically or require special handling. Troubleshooting "I can set up a harp container on
memory_limit = 512M max_execution_time = 300 post_max_size = 2048M upload_max_filesize = 2048M
: You typically run HaRP as a separate Docker container alongside your Nextcloud instance or on a dedicated host. Key Configuration Environment Variables : You must set HP_SHARED_KEY (a secret for authentication) and NC_INSTANCE_URL (the address of your Nextcloud server). : It often requires a Docker Socket Proxy
Step 6 — Nginx site config
For a resilient production environment, it is best practice to separate these services across multiple virtual machines or containers. However, this architecture can also be consolidated onto a single powerful server using isolated service units. Minimum System Requirements : Ubuntu 24.04 LTS or Debian 12 CPU : 4 vCPUs (minimum for distributed architecture) By implementing HaRP, you ensure a secure, high-performance
If you encounter issues during installation or would like to optimize further, let me know by providing more context: The you are currently running.
HaRP is designed for the modern AppAPI framework (Nextcloud 32 and newer).
sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --permanent --add-service=https sudo firewall-cmd --reload Use code with caution. Step 2: Install and Configure the Apache Web Server (HTTPD)
Apache acts as the application delivery web server behind the HAProxy load balancer. It processes PHP-FPM to serve Nextcloud components.
This typically indicates that your reverse proxy is not forwarding /exapps/ requests correctly. Verify that the location block for /exapps/ is properly configured and that the proxy_pass URL points to the correct HaRP port (default 8780). Also ensure that no other proxy rules are intercepting the /exapps/ path.
sudo docker run \ --sig-proxy=false \ --name nextcloud-aio-mastercontainer \ --restart always \ --publish 80:80 \ --publish 8080:8080 \ --publish 8443:8443 \ --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \ --volume /var/run/docker.sock:/var/run/docker.sock:ro \ nextcloud/all-in-one:latest