Nextcloud - Harp
(High-performance AppAPI Reverse Proxy) is the modern proxy system introduced for Nextcloud 32+
to manage External Apps (ExApps). It is designed to replace the older Docker Socket Proxy (DSP) method, which is scheduled for deprecation by Nextcloud 35. What is HaRP?
HaRP acts as a dedicated gateway between users and Nextcloud's external microservice-based applications. Key features include: Direct Routing
: It allows clients to communicate directly with ExApps, bypassing the heavy Nextcloud PHP process to improve performance and reduce latency. WebSocket Support
: Unlike the previous proxy, HaRP natively supports end-to-end WebSockets, enabling real-time features like live editing and instant notifications for external apps. Secure Tunneling FRP (Fast Reverse Proxy)
tunnels to connect ExApp containers. This means apps don't need to expose ports to the host, simplifying networking and NAT traversal. Language Agnostic
: Because it works through the AppAPI, developers can build these external apps in any language (Python, Node.js, Go, etc.) and integrate them into the Nextcloud UI. Why Switch to HaRP? Older Method (DSP) HaRP (Recommended) Performance Proxied through PHP (Slower) Direct client-to-app routing Connectivity Requires reachable ports Secure FRP tunneling (no open ports) WebSockets Limited/No support Native support for real-time apps Deprecated in NC 35 Default for Nextcloud 32 and beyond How to Implement It For Admins
: HaRP can be installed alongside Nextcloud on the same Docker network or on a remote host to scale resources. You must register it as a "Deploy Daemon" within the AppAPI Admin Settings For Developers : To adapt an app for HaRP, you typically include a
script in your container image that handles the FRP client connection before launching your app process.
If you are currently running Nextcloud 32, it is recommended to Migrate your ExApps from DSP to HaRP now to ensure future compatibility. of HaRP, or are you trying to migrate existing apps to the new proxy? Adapting ExApps to HaRP - Nextcloud Documentation
The query "harp nextcloud" refers to HaRP (Nextcloud AppAPI HaProxy Reverse Proxy), a critical system designed for Nextcloud developers and self-hosters to handle External Apps (ExApps) more efficiently. What is HaRP? harp nextcloud
HaRP is a high-performance reverse proxy that simplifies how Nextcloud communicates with apps running outside the main server (ExApps). It was introduced primarily to:
Enable WebSockets: Before HaRP, ExApps struggled with real-time features. HaRP allows end-to-end WebSocket connections for live chats, collaborative editing, and dashboards.
Improve Performance: It bypasses the traditional, slower PHP stack for specific app traffic, routing requests directly from the client to the ExApp.
Simplify Deployment: It replaces older, more complex setups (like DockerSocketProxy) and uses FRP-based transport to allow ExApps to connect even without exposing ports to the host. Integrating HaRP into Your Stack
If you are managing a Nextcloud instance and want to "make" this piece work, here are the core integration points: Deployment Type Key Integration Step All-In-One (AIO)
Requires setting a shared key (HP_SHARED_KEY) and optionally extending the Apache vhost template to route /exapps/ to the HaRP container. Docker Compose
Add the nextcloud-appapi-harp image to your compose file. It typically listens on port 8780 for proxying. Kubernetes (Helm)
Use a custom Nginx server block to route /exapps/ traffic directly to the internal nextcloud-harp service. Why it Matters Now
Starting with Nextcloud 32, HaRP is the recommended way to handle external applications. The older systems are being deprecated and are scheduled for removal in Nextcloud 35.
If you are developing an app, you can follow the official Nextcloud ExApp HaRP Integration guide to ensure your app remains compatible with future versions. Adapting ExApps to HaRP - Nextcloud Documentation (High-performance AppAPI Reverse Proxy) is the modern proxy
2.3 Blockchain-inspired Integrity
Prior works like Siyu et al. (2022) integrated blockchains with cloud storage for audit trails. Harp uses a lightweight, permissionless hash chain stored locally per user — no proof-of-work required.
7.3 Use Cases
- Remote field offices: intermittent connectivity without a central VPN.
- Compliance logging: healthcare or legal environments needing tamper-proof file operation history.
- Research data management: verifiable provenance of datasets.
Alternatives
- Use Git + CI to build Harp and deploy to a static host.
- Serve compiled site from a dedicated webserver (Apache/Nginx) with Nextcloud only as storage via WebDAV or external storage mount.
If you want, I can provide:
- A sample Harp project structure and minimal config.
- A simple script to compile and upload compiled files to Nextcloud via WebDAV.
roxy) is the modern proxy engine for Nextcloud 32+ that allows External Apps (ExApps) to communicate with Nextcloud
. It is specifically designed to support high-performance features like WebSockets for real-time AI and communication tools. 1. Deploy the HaRP Container
Run the HaRP container using Docker. Replace the placeholders with your specific values. NC_INSTANCE_URL : Your internal Nextcloud address (e.g.,
Unlocking the Power of Cloud Storage with Harp and Nextcloud
In today's digital age, cloud storage has become an essential tool for individuals and organizations alike. The ability to access and share files from anywhere, at any time, has revolutionized the way we work and collaborate. Two popular solutions that have gained significant attention in recent years are Harp and Nextcloud. In this article, we will explore the benefits and features of integrating Harp with Nextcloud, and how this powerful combination can take your cloud storage experience to the next level.
What is Harp?
Harp is an open-source, cloud-native storage solution that provides a scalable, secure, and highly available storage platform for modern applications. Developed by the Linux Foundation, Harp is designed to work seamlessly with cloud-native applications, providing a robust and flexible storage solution that can adapt to the needs of growing businesses.
What is Nextcloud?
Nextcloud is a popular, open-source cloud storage solution that allows users to store, access, and share files, contacts, calendars, and more from a single platform. With a strong focus on security, scalability, and user-friendliness, Nextcloud has become a favorite among individuals, businesses, and organizations looking for a reliable cloud storage solution.
The Benefits of Integrating Harp with Nextcloud
So, why integrate Harp with Nextcloud? The answer lies in the numerous benefits that this powerful combination provides:
- Scalability: Harp's cloud-native architecture allows it to scale seamlessly with your growing storage needs, while Nextcloud provides a user-friendly interface to manage and access your files.
- Security: Both Harp and Nextcloud prioritize security, providing end-to-end encryption, secure authentication, and access controls to ensure that your data remains safe and protected.
- High Availability: Harp's distributed architecture ensures that your storage is always available, even in the event of hardware failures or outages, while Nextcloud provides a highly available platform for accessing and sharing files.
- Flexibility: The integration of Harp and Nextcloud provides a flexible storage solution that can adapt to the needs of your organization, whether you're a small business or a large enterprise.
Key Features of Harp and Nextcloud Integration
So, what can you expect from the integration of Harp and Nextcloud? Here are some key features to look out for:
- Cloud-Native Storage: Harp provides a cloud-native storage solution that is optimized for modern applications and workloads.
- Object Storage: Harp's object storage capabilities allow you to store and manage large amounts of unstructured data, such as files, images, and videos.
- Block Storage: Harp's block storage capabilities provide high-performance storage for applications that require low-latency and high-throughput storage.
- File Sharing: Nextcloud provides a user-friendly interface for sharing files and folders with colleagues, partners, and customers.
- End-to-End Encryption: Both Harp and Nextcloud provide end-to-end encryption to ensure that your data remains secure and protected, both in transit and at rest.
Use Cases for Harp and Nextcloud Integration
The integration of Harp and Nextcloud provides a powerful solution for a wide range of use cases, including:
- Cloud-Native Applications: Harp and Nextcloud provide a scalable and secure storage solution for cloud-native applications, such as containerized workloads and serverless functions.
- Enterprise File Sharing: Nextcloud provides a user-friendly interface for sharing files and folders with colleagues, partners, and customers, while Harp provides a scalable and secure storage solution for large amounts of data.
- Data Lakes: Harp's object storage capabilities make it an ideal solution for data lakes, providing a scalable and secure storage solution for large amounts of unstructured data.
- Disaster Recovery: The integration of Harp and Nextcloud provides a highly available and secure storage solution for disaster recovery, ensuring that your data remains safe and accessible even in the event of outages or disasters.
Getting Started with Harp and Nextcloud
So, how do you get started with Harp and Nextcloud? Here are the steps to follow:
- Download and Install Harp: Download and install Harp on your server or cloud infrastructure.
- Download and Install Nextcloud: Download and install Nextcloud on your server or cloud infrastructure.
- Configure Harp and Nextcloud: Configure Harp and Nextcloud to work together, using Harp as the storage backend for Nextcloud.
- Test and Validate: Test and validate your Harp and Nextcloud integration, ensuring that it meets your scalability, security, and performance requirements.
Conclusion
In conclusion, the integration of Harp and Nextcloud provides a powerful solution for cloud storage, offering a scalable, secure, and highly available storage platform for modern applications. With its cloud-native architecture, object storage capabilities, and end-to-end encryption, Harp provides a robust storage solution that can adapt to the needs of growing businesses. Nextcloud, on the other hand, provides a user-friendly interface for accessing and sharing files, contacts, calendars, and more. Together, Harp and Nextcloud provide a winning combination for organizations looking for a reliable and secure cloud storage solution. Whether you're a small business or a large enterprise, the integration of Harp and Nextcloud is definitely worth considering.