Fix existing unit tests and docs

install/production-filesystem/entrypoint.d/35-writable-config.sh

@@ -36,6 +36,21 @@ for path in $READ_WRITE_PATHS; do
 
    https://github.com/jokob-sk/NetAlertX/blob/main/docs/docker-troubleshooting/file-permissions.md
 ══════════════════════════════════════════════════════════════════════════════
+EOF
+        >&2 printf "%s" "${RESET}"
+    elif [ ! -f "$path" ]; then
+        failures=1
+        >&2 printf "%s" "${YELLOW}"
+        >&2 cat <<EOF
+══════════════════════════════════════════════════════════════════════════════
+⚠️  ATTENTION: Read permission denied.
+
+    The path "${path}" is not a regular file (current type: $(stat -c %F "$path" 2>/dev/null || echo unknown)).
+    This prevents NetAlertX from reading the configuration and indicates a
+    permissions or mount issue — often seen when running with custom UID/GID.
+
+    https://github.com/jokob-sk/NetAlertX/blob/main/docs/docker-troubleshooting/file-permissions.md
+══════════════════════════════════════════════════════════════════════════════
 EOF
         >&2 printf "%s" "${RESET}"
     elif [ ! -r "$path" ]; then

install/production-filesystem/entrypoint.d/99-ports-available.sh

@@ -5,22 +5,27 @@
 
 # Define ports from ENV variables, applying defaults
 PORT_APP=${PORT:-20211}
-# PORT_GQL=${APP_CONF_OVERRIDE:-${GRAPHQL_PORT:-20212}}
 
-# # Check if ports are configured to be the same
-# if [ "$PORT_APP" -eq "$PORT_GQL" ]; then
-#     cat <<EOF
-# ══════════════════════════════════════════════════════════════════════════════
-# ⚠️  Configuration Warning: Both ports are set to ${PORT_APP}.
+# Prefer explicit GRAPHQL_PORT, fall back to parsed override if present.
+if [ -n "${APP_CONF_OVERRIDE:-}" ]; then
+    # crude parse: look for GRAPHQL_PORT in JSON-like string
+    PORT_GQL=$(printf '%s' "${APP_CONF_OVERRIDE}" | grep -o 'GRAPHQL_PORT"*[:=]\"*[0-9]\+' | tr -cd '0-9' || true)
+fi
+PORT_GQL=${PORT_GQL:-${GRAPHQL_PORT:-20212}}
 
-#     The Application port (\$PORT) and the GraphQL API port
-#     (\$APP_CONF_OVERRIDE or \$GRAPHQL_PORT) are configured to use the
-#     same port. This will cause a conflict.
+# Check if ports are configured to be the same
+if [ "${PORT_APP}" -eq "${PORT_GQL}" ]; then
+    cat <<EOF
+══════════════════════════════════════════════════════════════════════════════
+⚠️  Configuration Warning: Both ports are set to ${PORT_APP}.
 
-#     https://github.com/jokob-sk/NetAlertX/blob/main/docs/docker-troubleshooting/port-conflicts.md
-# ══════════════════════════════════════════════════════════════════════════════
-# EOF
-# fi
+    The Application port (\$PORT) and the GraphQL API port (\$GRAPHQL_PORT)
+    are configured to use the same port. This will cause a conflict.
+
+    https://github.com/jokob-sk/NetAlertX/blob/main/docs/docker-troubleshooting/port-conflicts.md
+══════════════════════════════════════════════════════════════════════════════
+EOF
+fi
 
 # Check for netstat (usually provided by busybox)
 if ! command -v netstat >/dev/null 2>&1; then
@@ -53,17 +58,16 @@ if echo "$LISTENING_PORTS" | grep -q ":${PORT_APP}$"; then
 EOF
 fi
 
-# # Check GraphQL Port
-# # We add a check to avoid double-warning if ports are identical AND in use
-# if [ "$PORT_APP" -ne "$PORT_GQL" ] && echo "$LISTENING_PORTS" | grep -q ":${PORT_GQL}$"; then
-#     cat <<EOF
-# ══════════════════════════════════════════════════════════════════════════════
-# ⚠️  Port Warning: GraphQL API port ${PORT_GQL} is already in use.
+# Check GraphQL Port (always emit if listening, even if same port)
+if echo "$LISTENING_PORTS" | grep -q ":${PORT_GQL}$"; then
+    cat <<EOF
+══════════════════════════════════════════════════════════════════════════════
+⚠️  Port Warning: GraphQL API port ${PORT_GQL} is already in use.
 
-#     The GraphQL API (defined by \$APP_CONF_OVERRIDE or \$GRAPHQL_PORT)
-#     may fail to start.
+    The GraphQL API (defined by $APP_CONF_OVERRIDE or $GRAPHQL_PORT)
+    may fail to start.
 
-#     https://github.com/jokob-sk/NetAlertX/blob/main/docs/docker-troubleshooting/port-conflicts.md
-# ══════════════════════════════════════════════════════════════════════════════
-# EOF
-# fi
+    https://github.com/jokob-sk/NetAlertX/blob/main/docs/docker-troubleshooting/port-conflicts.md
+══════════════════════════════════════════════════════════════════════════════
+EOF
+fi