# How to setup AppAPI **URL:** \ **Category:** 📦 Appliances (Docker, Snappy, VM, NCP, AIO)\ **Tags:** docker, linuxserverio\ **Created:** [August 11, 2026, 11:54am UTC](https://help.nextcloud.com/t/how-to-setup-appapi/247991 "2026-08-11T11:54:53Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![Rob\_Kalmeijer](https://help.nextcloud.com/user_avatar/help.nextcloud.com/rob_kalmeijer/32/66068_2.png) [@Rob\_Kalmeijer](https://help.nextcloud.com/u/Rob_Kalmeijer)\ **Post date:** [August 11, 2026, 11:54am UTC](https://help.nextcloud.com/t/how-to-setup-appapi/247991/1 "2026-08-11T11:54:53Z")
> **Support intro** > > ## Sorry to hear you’re facing problems. 🙁 > > _The community help forum ([help.nextcloud.com](http://help.nextcloud.com)) is for home and non-enterprise users. Support is provided by other community members on a best effort / “as available” basis. All of those responding are **volunteering their time to help you.** _ > > **If you’re using Nextcloud in a business/critical setting, paid and SLA-based support services can be accessed via [portal.nextcloud.com](http://portal.nextcloud.com) where Nextcloud engineers can help ensure your business keeps running smoothly.** > > ## Getting help > > In order to help you as efficiently (and quickly!) as possible, please fill in as much of the below requested information as you can. > > **Before clicking submit** : Please check if your query is already addressed via the following resources: > > - [Official documentation](https://docs.nextcloud.com) (searchable and regularly updated) > - [How to topics and FAQs](https://help.nextcloud.com/c/how-to-faqs/9) > - [Forum search](https://help.nextcloud.com/search) > > (Utilizing these existing resources is typically faster. It also helps reduce the load on our generous volunteers while elevating the signal to noise ratio of the forums otherwise arising from the same queries being posted repeatedly). Some or all of the below information will be requested if it isn’t supplied; for fastest response please provide as much as you can. ❤ ## The Basics - Nextcloud Server version _(e.g., 29.x.x)_: - `latest` - Operating system and version _(e.g., Ubuntu 24.04)_: - `Rocky Linux 9` - Web server and version _(e.g, Apache 2.4.25)_: - `Apache` - Reverse proxy and version \_(e.g. nginx 1.27.2) - `replace me` - PHP version _(e.g, 8.3)_: - `replace me` - Is this the first time you’ve seen this error? (Yes / No): - `n.a.` - When did this problem seem to first start? - `with setting up` - Installation method _(e.g. AlO, NCP, Bare Metal/Archive, etc.)_ - `replace me` - Are you using CloudfIare, mod\_security, or similar? _(Yes / No)_ - `no` ### Summary of the issue you are facing: Which setting up for AppAPI must I use? Apache with Nextclouds runs direct in the system. Docker is setup. I’m trying the script below: #! /usr/bin/bash docker run -e HP\_SHARED\_KEY=“\*\*\*\*\*\*\*\*\*\*” -e NC\_INSTANCE\_URL="[https://cloud.xxxx.nl](https://cloud.xxxx.nl) -v /var/run/docker.sock:/var/run/docker.sock -v `pwd`/certs:/certs –name appapi-harp -h appapi-harp –restart unless-stopped -p 8780:8780 -p 8782:8782 -d [Package nextcloud-appapi-harp · GitHub](http://ghcr.io/nextcloud/nextcloud-appapi-harp:release) From which directory must I run it? Why are the certs installed in the /root/ directory anddo I need them? Which option to use in the nextcloud AppAPI setup page? See: [AppAPI](https://www.robkalmeijer.nl/techniek/computer/servers/http/cms/nextcloud/appapi.html) ---
**Author:** ![ThomasG8235](https://help.nextcloud.com/letter_avatar/thomasg8235/32/5_5575768a8748004e209b776fc1b2916d.png) [@ThomasG8235](https://help.nextcloud.com/u/ThomasG8235)\ **Post date:** [August 11, 2026, 5:52pm UTC](https://help.nextcloud.com/t/how-to-setup-appapi/247991/2 "2026-08-11T17:52:46Z")
Hello, to help you, we unfortunately need to clarify a few questions first. - Do you use a reverse proxy in front of your Nextcloud? - What kind of installation are you using? AIO, Bare Metal, SNAP It will be difficult without this information. You don’t need to worry about the certificates; that happens automatically in the background. ---
**Author:** ![Rob\_Kalmeijer](https://help.nextcloud.com/user_avatar/help.nextcloud.com/rob_kalmeijer/32/66068_2.png) [@Rob\_Kalmeijer](https://help.nextcloud.com/u/Rob_Kalmeijer)\ **Post date:** [August 11, 2026, 7:31pm UTC](https://help.nextcloud.com/t/how-to-setup-appapi/247991/3 "2026-08-11T19:31:52Z")
Bare metal No reverse proxy. ---
**Author:** ![ThomasG8235](https://help.nextcloud.com/letter_avatar/thomasg8235/32/5_5575768a8748004e209b776fc1b2916d.png) [@ThomasG8235](https://help.nextcloud.com/u/ThomasG8235)\ **Post date:** [August 11, 2026, 8:25pm UTC](https://help.nextcloud.com/t/how-to-setup-appapi/247991/4 "2026-08-11T20:25:25Z")
Okay, let’s give it a try. **First, please edit your initial post and change your URL to** `my.cloud.nl`. Please do not post your actual address here in the forum. The original code is ```bash docker run \ -e HP_SHARED_KEY="some_very_secure_password" \ -e NC_INSTANCE_URL="https://127.0.0.1:8080" \ -v /var/run/docker.sock:/var/run/docker.sock \ -v `pwd`/certs:/certs \ --name appapi-harp -h appapi-harp \ --restart unless-stopped \ -p 8780:8780 \ -p 8782:8782 \ -d ghcr.io/nextcloud/nextcloud-appapi-harp:release ``` You should use this one as well. You can create the password using `openssl rand -hex 32`. Test whether you can use the local IP `127.0.0.1`, since everything is running on the same system. > **My configuration** > > This is my command for creating the Docker container. > > However, I have a proxy manager in front of it. In principle, though, it should work for you too. You would just need to set `NC_INSTANCE_URL` to [https://your.url](https://your.url) and `HP_EXAPPS_ADDRESS` to your server’s IP address. > > ```bash > docker run \ > -e HP_SHARED_KEY="PASSWORT" \ > -e NC_INSTANCE_URL="http://DOMAIN" \ > -e HP_EXAPPS_ADDRESS="INTERNE-IP:8780" \ > -v /var/run/docker.sock:/var/run/docker.sock \ > -v `pwd`/certs:/certs \ > --name appapi-harp -h appapi-harp \ > --restart unless-stopped \ > --network host \ > -d ghcr.io/nextcloud/nextcloud-appapi-harp:release > > ``` ---
**Author:** ![Rob\_Kalmeijer](https://help.nextcloud.com/user_avatar/help.nextcloud.com/rob_kalmeijer/32/66068_2.png) [@Rob\_Kalmeijer](https://help.nextcloud.com/u/Rob_Kalmeijer)\ **Post date:** [August 14, 2026, 7:46pm UTC](https://help.nextcloud.com/t/how-to-setup-appapi/247991/5 "2026-08-14T19:46:29Z")
NC\_INSTANCE\_URL=“[https://127.0.0.1:8080](https://127.0.0.1:8080)” doesn’t work. 8080 is not used in the system and the webserver only rsponds to URL’s. The password trick is a good option to use. How is this used? -v `pwd`/certs:/certs \ When I run the image the certificates are installed in the working directory, in my case /root/certs. What is the best directory to get them in and do I need them at all? I not familiar whit docker See [AppAPI](https://www.robkalmeijer.nl/techniek/computer/servers/http/cms/nextcloud/appapi.html) for what I have done. Its my website.