AppAPI deploy daemon - Nextcloud

[Felipe]

Hello guys!

So, I’m new to the Homeland environment and I’m trying to install the Nextcloud AppApi so I can access the platform’s ExApps, but I’m having some difficulty because I’m not very experienced with this and I can’t get it to work. From what I understood, I need to install HaRP, but I haven’t found an “easy” tutorial to make it work. If anyone has a link or video that could help me, I’d really appreciate it!

 

”AppAPI deploy daemon

AppAPI default deploy daemon "harp_proxy_host" is not accessible. Please check the daemon configuration.”

[Felipe]

Any new about it?

[TheGlitch]

On 1/5/2026 at 7:09 PM, Felipe said:

Hello guys!

So, I’m new to the Homeland environment and I’m trying to install the Nextcloud AppApi so I can access the platform’s ExApps, but I’m having some difficulty because I’m not very experienced with this and I can’t get it to work. From what I understood, I need to install HaRP, but I haven’t found an “easy” tutorial to make it work. If anyone has a link or video that could help me, I’d really appreciate it!

 

”AppAPI deploy daemon

AppAPI default deploy daemon "harp_proxy_host" is not accessible. Please check the daemon configuration.”

Hey Bud, 

This is a common point of confusion with Nextcloud, as this is a new framework called AppAPI that was introduced to run "External Apps" (ExApps) for things like AI assistants and more advanced office integrations that run in separate Docker containers for better performance. For these to work, they need a "bridge" called HaRP (Homeland App Runtime Platform).

If you are seeing the harp_proxy_host error, it simply means Nextcloud is looking for that bridge and can't find it.

Do you need to use the ExApps or just wanting to play around?

Edited 16 hours ago by TheGlitch

[Felipe]

Segue versão melhorada, com inglês mais claro e formal:

I would like to set this up. Some applications caught my attention, and I would like to test them as well.

While researching, I found that I may need to deploy a new container that is not available within the Nextcloud app on TrueNAS. Is that correct?

Is it possible to run these applications on the same instance as the Nextcloud app, or would it be necessary to deploy a separate container or service to run them?

[TheGlitch]

Sem problema, meu amigo, eu só queria ter certeza de que entendo o nível de NECESSIDADE vs. DESEJO. 😄

So I will be upfront, I am new to Nextcloud also, but I've read some of the documentation and have gleaned the following to your questions. 
 

1. Yes, it would seem ExApps need to un as their own separate containers. They don't run into the Nextcloud app itself. 
2. You do need a separate service called HaRP proxy to act as the bridge. Since HexOS is based on TrueNAS SCALE, you usually have to deploy HaRP as a Custom App using the the image found at,  ghcr.io/nextcloud/nextcloud-appapi-harp:release.
   
   I did find this video helpful, maybe this could be your starting off point. I would highly suggest that you spin up some sort of sandbox environment to play around with. Not sure if forcing this rather messy setup into HexOS right now. Maybe in the future someone will develop an automation for it but... couldn't even guess when that could be.
   
   Sorry I don't have much to offer at this time. I'm not able to play around with Nextcloud to that depth until i get some other things figured out.