From 883786ec91579115fa70249c91292188d531b986 Mon Sep 17 00:00:00 2001
From: FlyingToto <68790909+FlyingToto@users.noreply.github.com>
Date: Mon, 1 Sep 2025 17:39:58 -0400
Subject: [PATCH 1/2] added a variant of example 2 as 5...

---
 docs/DOCKER_COMPOSE.md | 56 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/docs/DOCKER_COMPOSE.md b/docs/DOCKER_COMPOSE.md
index ecde2533..629ddd8b 100755
--- a/docs/DOCKER_COMPOSE.md
+++ b/docs/DOCKER_COMPOSE.md
@@ -137,3 +137,59 @@ networks:
 
 
 ```
+### Example 5: same as 3 but with a top level root, also works in portainder as-is
+
+`docker-compose.yml` 
+
+```yaml
+services:
+  netalertx:
+    container_name: netalertx
+    # use the below line if you want to test the latest dev image instead of the stable release
+    # image: "ghcr.io/jokob-sk/netalertx-dev:latest" 
+    image: "ghcr.io/jokob-sk/netalertx:latest"      
+    network_mode: "host"        
+    restart: unless-stopped
+    volumes:
+      - ${APP_FOLDER}/netalertx/config:/app/config
+      - ${APP_FOLDER}/netalertx/db:/app/db     
+      # (optional) useful for debugging if you have issues setting up the container
+      - ${APP_FOLDER}/netalertx/log:/app/log
+      # (API: OPTION 1) default -> use for performance
+      - type: tmpfs
+        target: /app/api
+      # (API: OPTION 2) use when debugging issues 
+      # -  ${APP_FOLDER}/netalertx/api:/app/api
+    environment:
+      - TZ=${TZ}      
+      - PORT=${PORT}
+```
+
+`.env` file
+
+```yaml
+APP_FOLDER=/path/to/local/NetAlertX/location
+
+#ENVIRONMENT VARIABLES
+PUID=300
+PGID=200
+TZ=America/New_York
+LISTEN_ADDR=0.0.0.0
+PORT=20211
+#GLOBAL PATH VARIABLE
+
+# you may want to create a dedicated user and group to run the container with 
+# sudo groupadd -g 300 nax-g 
+# sudo useradd -u 200 -g 300 nax-u
+# mkdir -p $APP_FOLDER/{db,config,log} 
+# chown -R 200:300 $APP_FOLDER
+# chmod -R 775 $APP_FOLDER
+
+# DEVELOPMENT VARIABLES
+# you can create  multiple env files called .env.dev1, .env.dev2 etc and use them by running:
+# docker compose --env-file .env.dev1 up -d
+# you can then clone  multiple dev copies of NetAlertX just make sure to change the APP_FOLDER and PORT variables in each .env.devX file
+
+```
+
+To run the container execute: `sudo docker-compose --env-file /path/to/.env up`

From bb1e00301c15015d29be1a676360cf6e0a96917c Mon Sep 17 00:00:00 2001
From: FlyingToto <68790909+FlyingToto@users.noreply.github.com>
Date: Mon, 1 Sep 2025 18:29:39 -0400
Subject: [PATCH 2/2] fixing typo

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 docs/DOCKER_COMPOSE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/DOCKER_COMPOSE.md b/docs/DOCKER_COMPOSE.md
index 629ddd8b..e776962c 100755
--- a/docs/DOCKER_COMPOSE.md
+++ b/docs/DOCKER_COMPOSE.md
@@ -137,7 +137,7 @@ networks:
 
 
 ```
-### Example 5: same as 3 but with a top level root, also works in portainder as-is
+### Example 5: same as 3 but with a top-level root directory; also works in Portainer as-is
 
 `docker-compose.yml`