Trying to set up HaRP proxy (docker) deploy deamon

Support intro

Sorry to hear you’re facing problems. :slightly_frowning_face:

The community help forum (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 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:

(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. :heart:

The Basics

  • Nextcloud Server version (e.g., 29.x.x):
    • 32.0.1
  • Operating system and version (e.g., Ubuntu 24.04):
    • Synology DSM 7.2.2
  • Web server and version (e.g, Apache 2.4.25):
    • Apache 2.4.65
  • Reverse proxy and version _(e.g. nginx 1.27.2)
    • Nginx 1.29.3
  • PHP version (e.g, 8.3):
    • Php 8.3.27
  • Is this the first time you’ve seen this error? (Yes / No):
    • Yes
  • When did this problem seem to first start?
    • today, but it's the first time I'm trying to set it up
  • Installation method (e.g. AlO, NCP, Bare Metal/Archive, etc.)
    • official docker images + github doc
  • Are you using CloudfIare, mod_security, or similar? (Yes / No)
    • No

Summary of the issue you are facing:

I’m trying to configure nextcloud on a synology NAS with docker compose.

In the appapi-harp container I see this error at startup:

2025-11-16 21:48:24.423 [E] [client/service.go:280] send Login request to plugin error

I think it’s the source of the problem. I’ll describe my setup below

Steps to replicate it (hint: details matter!):slight_smile:

My docker compose file copy the informations on this page: GitHub - nextcloud/HaRP: Fast Proxy for AppAPI(Nextcloud 32+)

Precisely I’ve followed the exact configuration of the paragraph “Using Host Networking”

The only differences being:

  • I changed the HP_SHARED_KEY :innocent:
  • NC_INSTANCE_URL=“https://cloud.subdomain.synology.me”
  • HP_EXAPPS_ADDRESS=“192.168.2.5:8780” (my NAS local IP)

An nginx container listen on the NAS 8080 address and is configured like this:

server {
listen 80;

server_name localhost;

location / {
    proxy_pass http://app:80;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

# appapi-harp sur /exapps
location /exapps/ {
    proxy_pass http://192.168.0.2:8780;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

}

The Synology NAS reverse proxy takes care of https and redirects https://cloud.subdomain.synology.me to http://0.0.0.0:8080, which then redirects to either app (the nextcloud container) or 192.168.0.2:8780 (the HaRP container).

Nextcloud runs well. But my efforts to try to setup AppAPI fail. I put these in the Deploy Daemon (DaemonConfig) GUI:

  • display name: HaRP proxy (docker)
  • Deployment method: docker-install
  • HaRP host: 192.168.0.2:8780
  • HaRP shared key: the same as HP_SHARED_KEY
  • Nextcloud URL: https://cloud.subdomain.synology.me

I think that’s all needed for the first step. But pressing “check connection” fails

The compose file snippet is:

appapi-harp:
image: Package nextcloud-appapi-harp · GitHub
restart: unless-stopped
network_mode: host
hostname: appapi-harp
container_name: appapi-harp
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./certs:/certs
environment:
- HP_SHARED_KEY=xxx
- HP_EXAPPS_ADDRESS=“192.168.0.2:8780”
- NC_INSTANCE_URL=https://cloud.subdomain.synology.me

Log entries

Nextcloud

Please provide the log entries from your Nextcloud log that are generated during the time of problem (via the Copy raw option from Administration settings->Logging screen or from your nextcloud.log located in your data directory). Feel free to use a pastebin/gist service if necessary.

nextcloud-app-1  | [Sun Nov 16 23:16:17.700133 2025] [php:notice] [pid 59:tid 59] [client 172.25.0.1:0] cURL error 28: Operation timed out after 3002 milliseconds with 0 bytes received (see https://curl.haxx.se/libcurl/c/libcurl-errors.html) for http://192.168.0.2:8780/exapps/app_api/v1.41/_ping

Web Browser

If the problem is related to the Web interface, open your browser inspector Console and Network tabs while refreshing (reloading) and reproducing the problem. Provide any relevant output/errors here that appear.

Not applicable

Web server / Reverse Proxy

The output of your Apache/nginx/system log in /var/log/____:

nginx log seems good:

nextcloud-nginx-1  | 172.25.0.1 - - [16/Nov/2025:23:20:10 +0000] "POST /apps/app_api/daemons/verify_connection HTTP/1.1" 200 37 "-" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:145.0) Gecko/20100101 Firefox/145.0" "-"

BUT the HaRP container says:

appapi-harp  | 2025-11-16 22:43:58.747 [I] [sub/root.go:142] start frpc service for config file [/frpc-docker.toml]
appapi-harp  | 2025-11-16 22:43:58.748 [I] [client/service.go:295] try to connect to server...
appapi-harp  | 2025-11-16 22:43:58.761 [E] [client/service.go:280] send Login request to plugin error
appapi-harp  | 2025-11-16 22:43:58.761 [W] [client/service.go:298] connect to server error: send Login request to plugin error
appapi-harp  | 2025-11-16 22:43:58.761 [I] [sub/root.go:160] frpc service for config file [/frpc-docker.toml] stopped

Configuration

Nextcloud

The output of occ config:list system or similar is best, but, if not possible, the contents of your config.php file from /path/to/nextcloud is fine (make sure to remove any identifiable information!):

{                                                                                                                                                                      
    "system": {                                                                                                                                                        
        "htaccess.RewriteBase": "\/",                                                                                                                                  
        "memcache.local": "\\OC\\Memcache\\APCu",                                                                                                                      
        "memcache.locking": "\\OC\\Memcache\\Redis",                                                                                                                   
        "memcache.distributed": "\\OC\\Memcache\\Redis",                                                                                                               
        "redis": {                                                                                                                                                     
            "host": "***REMOVED SENSITIVE VALUE***",                                                                                                                   
            "port": 6379,                                                                                                                                              
            "timeout": 1.5                                                                                                                                             
        },                                                                                                                                                             
        "apps_paths": [                                                                                                                                                
            {                                                                                                                                                          
                "path": "\/var\/www\/html\/apps",                                                                                                                      
                "url": "\/apps",                                                                                                                                       
                "writable": false                                                                                                                                      
            },                                                                                                                                                         
            {                                                                                                                                                          
                "path": "\/var\/www\/html\/custom_apps",                                                                                                               
                "url": "\/custom_apps",                                                                                                                                
                "writable": true                                                                                                                                       
            }
        ],
        "upgrade.disable-web": true,
        "instanceid": "***REMOVED SENSITIVE VALUE***",
        "passwordsalt": "***REMOVED SENSITIVE VALUE***",
        "secret": "***REMOVED SENSITIVE VALUE***",
        "trusted_domains": [
            "cloud.wzn.synology.me"
        ],
        "trusted_proxies": "***REMOVED SENSITIVE VALUE***",
        "overwriteprotocol": "http",
        "datadirectory": "***REMOVED SENSITIVE VALUE***",
        "dbtype": "mysql",
        "version": "32.0.1.2",
        "overwrite.cli.url": "http:\/\/web:8080",
        "dbname": "***REMOVED SENSITIVE VALUE***",
        "dbhost": "***REMOVED SENSITIVE VALUE***",
        "dbport": "",
        "dbtableprefix": "oc_",
        "mysql.utf8mb4": true,
        "dbuser": "***REMOVED SENSITIVE VALUE***",
        "dbpassword": "***REMOVED SENSITIVE VALUE***",
        "installed": true,
        "loglevel": 2,
        "maintenance": false,
        "config_preset": 2,
        "preview_ffmpeg_path": "\/usr\/local\/bin\/ffmpeg",
        "preview_ffprobe_path": "\/usr\/local\/bin\/ffprobe",
        "preview_max_memory": 1024,
        "preview_max_filesize_image": 52428800,
        "preview_max_filesize_video": 104857600,
        "preview_max_filesize_pdf": 52428800,
        "enabledPreviewProviders": [
            "OC\\Preview\\PNG",
            "OC\\Preview\\JPEG",
            "OC\\Preview\\GIF",
            "OC\\Preview\\HEIC",
            "OC\\Preview\\WebP",
            "OC\\Preview\\MP4",
            "OC\\Preview\\PDF",
            "OC\\Preview\\TXT"
        ],
        "memories.exiftool": "\/var\/www\/html\/custom_apps\/memories\/bin-ext\/exiftool-amd64-glibc",
        "memories.vod.path": "\/var\/www\/html\/custom_apps\/memories\/bin-ext\/go-vod-amd64"
    }
}

Apps

Enabled:

  • activity: 5.0.0-dev.0
  • app_api: 32.0.0
  • bruteforcesettings: 5.0.0-dev.0
  • calendar: 6.0.4
  • circles: 32.0.0
  • cloud_federation_api: 1.16.0
  • comments: 1.22.0
  • contacts: 8.0.6
  • contactsinteraction: 1.13.1
  • dashboard: 7.12.0
  • dav: 1.34.2
  • federatedfilesharing: 1.22.0
  • federation: 1.22.0
  • files: 2.4.0
  • files_downloadlimit: 5.0.0-dev.0
  • files_pdfviewer: 5.0.0-dev.0
  • files_reminders: 1.5.0
  • files_sharing: 1.24.0
  • files_trashbin: 1.22.0
  • files_versions: 1.25.0
  • firstrunwizard: 5.0.0-dev.0
  • guests: 4.6.0
  • logreader: 5.0.0-dev.0
  • lookup_server_connector: 1.20.0
  • memories: 7.7.0
  • nextcloud_announcements: 4.0.0-dev.0
  • notifications: 5.0.0-dev.0
  • oauth2: 1.20.0
  • password_policy: 4.0.0-dev.0
  • privacy: 4.0.0-dev.0
  • profile: 1.1.0
  • provisioning_api: 1.22.0
  • recommendations: 5.0.0-dev.0
  • related_resources: 3.0.0-dev.0
  • serverinfo: 4.0.0-dev.0
  • settings: 1.15.1
  • sharebymail: 1.22.0
  • support: 4.0.0-dev.0
  • survey_client: 4.0.0-dev.0
  • systemtags: 1.22.0
  • tasks: 0.17.1
  • text: 6.0.1
  • theming: 2.7.0
  • twofactor_backupcodes: 1.21.0
  • updatenotification: 1.22.0
  • user_status: 1.12.0
  • viewer: 5.0.0-dev.0
  • weather_status: 1.12.0
  • webhook_listeners: 1.3.0
  • workflowengine: 2.14.0

Disabled:

  • admin_audit: 1.22.0
  • encryption: 2.20.0
  • files_external: 1.24.0
  • photos: 5.0.0-dev.1 (installed 5.0.0-dev.1)
  • suspicious_login: 10.0.0-dev.0
  • twofactor_nextcloud_notification: 6.0.0-dev.0
  • twofactor_totp: 14.0.0
  • user_ldap: 1.23.0

Tips for increasing the likelihood of a response

  • Use the preformatted text formatting option in the editor for all log entries and configuration output.
  • If screenshots are useful, feel free to include them.
    • If possible, also include key error output in text form so it can be searched for.
  • Try to edit log output only minimally (if at all) so that it can be ran through analyzers / formatters by those trying to help you.