diff --git a/.examples/appapi/Dockerfile b/.examples/appapi/Dockerfile
index d6df27f8..678e7544 100644
--- a/.examples/appapi/Dockerfile
+++ b/.examples/appapi/Dockerfile
@@ -1,7 +1,11 @@
 FROM nextcloud:stable-fpm
-RUN apt-get update && apt-get install -y ffmpeg python3.13-venv nano pipx
+
+RUN apt-get update && apt-get install -y python3.13-venv pipx
+
 ADD ./poetry.sh /tmp/poetry.sh
+
 USER www-data
 RUN pipx ensurepath
 RUN python3 /tmp/poetry.sh
-USER root
\ No newline at end of file
+
+USER root
diff --git a/.examples/appapi/compose.yaml b/.examples/appapi/compose.yaml
index ffa56d71..5ccd15db 100644
--- a/.examples/appapi/compose.yaml
+++ b/.examples/appapi/compose.yaml
@@ -63,7 +63,7 @@ services:
   
   appapi:
     platform: linux/amd64
-    container-name: appapi
+    container_name: appapi
     hostname: appapi
     privileged: true
     image: ghcr.io/nextcloud/nextcloud-appapi-harp:release
@@ -73,12 +73,16 @@ services:
     restart: unless-stopped
     depends_on:
       - app
-    #env_file:
-    #  - appapi.env
+    # env_file:
+    #   - appapi.env
     environment:
-      - NC_HAPROXY_PASSWORD=CHANGEME # this needs to be at least 12 chars long. This exists for backward compatibility with the DSP image, it might be removed in the future from this example.
-      - HP_SHARED_KEY="CHANGEME" # this needs to be at least 12 chars long
-      - NC_INSTANCE_URL="https://external-nextcloud.url"
+      # NC_HAPROXY_PASSWORD needs to be at least 12 chars long. This variable exists for backward compatibility with the DSP image
+      # ToDo: verify whether this variable is still required
+      - NC_HAPROXY_PASSWORD=CHANGEME1234
+      # HP_SHARED_KEY needs to be at least 12 chars long.
+      - HP_SHARED_KEY=CHANGEME1234
+      # NC_INSTANCE_URL must be the externally accessible URL of the Nextcloud instance
+      - NC_INSTANCE_URL=https://external-nextcloud.url
     volumes:
       - /var/run/docker.sock:/var/run/docker.sock
 
@@ -87,8 +91,9 @@ volumes:
   nextcloud:
 
 networks:
-  proxy: # This is external network, created for nginx-proxy-manager used by this setup.
+  proxy: # This is an external network created for nginx-proxy-manager used by this setup. It must be edited to match your environment.
     name: proxy-manager_proxy_network
     external: true
-  appapi: # this is required in order for appapi to work
+
+  appapi: # This network is required in order for AppAPI to function correctly. Using "host" networking as in some examples may fail.
     name: appapi_network
\ No newline at end of file