Run ExApp without Orchestration

[HoffmannP]

Hy, I'd like to orchestrate my ExApp-Container myself and just register the already running Container as an ExApp to Nextcloud. Is there any way to do this? I thus wouldn't need a Docker Daemon.

[andrey18106]

Hello, there is a manual-install (https://nextcloud.github.io/app_api/notes_for_developers/DevelopmentEnvironment.html) Deploy daemon type which can be used to register already running ExApp. For examples you can have a look at these PyCharm run configuration to start manually ExApp (https://github.com/cloud-py-api/nc_py_api/tree/main/.run), and then register it via makefile commands (https://github.com/cloud-py-api/nc_py_api/blob/main/Makefile, https://github.com/cloud-py-api/nc_py_api/blob/main/scripts/dev_register.sh).
If there is something missing for your scenario, feel free to open an issue.

[HoffmannP]

[HoffmannP]

As a documentation for others that may want to run an ExApp without a Docker Orchestration.
You need the following ENV-Variables (everything uppercase):

• NEXTCLOUD_URL (points back to your NC instance)
• APP_VERSION (should be the same as the "version"-value in the xml/json info you use for registering your app)
• APP_ID (as "appid"/"id" above)
• APP_SECRET (required, you must give the same "secret"-value in your xml/json while registering)

[HoffmannP]

Also, wenn registering the app manualy via app_api:app:register you need to add the route to your registration information like this:

app_api:app:register --json-info '{"name":"$NAME","scopes": ["ALL"],"version":"0.1","port":80,"secret":"$SECRET","external-app":{"routes":[{"url":"$ROUTE","verb":"POST","access_level":1}]}}'

(this is the minimum I was able to get to run)

{
    "name": "$NAME",
    "scopes": [
        "ALL"
    ],
    "version": "0.1",
    "port": 80,
    "secret": "$SECRET",
    "external-app": {
        "routes": [
            {
                "url": "$ROUTE",
                "verb": "POST",
                "access_level": "$LEVEL"
            }
        ]
    }
}

Where $LEVEL can be one of

• 0: For everybody
• 1: For registered users
• 2: For Administrators