Refresh nginx_webserver_proxy startup fix

Update CLAUDE.md with full workflow list, template modules, and user customization

.templates/ha_autoapps.sh

@@ -9,6 +9,61 @@ set -e
 PACKAGES="$1"
 echo "To install : $PACKAGES"
 
+apt_has_sources() {
+    [ -d /etc/apt ] || return 1
+    find /etc/apt -type f \( -name "sources.list" -o -name "*.list" -o -name "*.sources" \) \
+        -exec grep -Ehs '^[[:space:]]*(deb|Types:[[:space:]]*deb)' {} \; | grep -q .
+}
+
+restore_apt_sources_if_missing() {
+    command -v apt-get > /dev/null 2> /dev/null || return 0
+    apt_has_sources && return 0
+
+    if [ -r /etc/os-release ]; then
+        # shellcheck disable=SC1091
+        . /etc/os-release
+    fi
+
+    codename="${VERSION_CODENAME:-${UBUNTU_CODENAME:-}}"
+    if [ -z "$codename" ]; then
+        echo "Error: apt sources are missing and OS codename could not be detected" >&2
+        exit 1
+    fi
+
+    mkdir -p /etc/apt
+    case "${ID:-}" in
+        ubuntu)
+            arch="$(dpkg --print-architecture 2> /dev/null || true)"
+            if [ "$arch" = "amd64" ] || [ "$arch" = "i386" ]; then
+                mirror="http://archive.ubuntu.com/ubuntu"
+                security_mirror="http://security.ubuntu.com/ubuntu"
+            else
+                mirror="http://ports.ubuntu.com/ubuntu-ports"
+                security_mirror="$mirror"
+            fi
+            cat > /etc/apt/sources.list <<EOF2
+deb ${mirror} ${codename} main restricted universe multiverse
+deb ${mirror} ${codename}-updates main restricted universe multiverse
+deb ${security_mirror} ${codename}-security main restricted universe multiverse
+EOF2
+            ;;
+        debian)
+            cat > /etc/apt/sources.list <<EOF2
+deb http://deb.debian.org/debian ${codename} main contrib non-free non-free-firmware
+deb http://deb.debian.org/debian ${codename}-updates main contrib non-free non-free-firmware
+deb http://deb.debian.org/debian-security ${codename}-security main contrib non-free non-free-firmware
+EOF2
+            ;;
+        *)
+            echo "Error: apt sources are missing for unsupported OS '${ID:-unknown}'" >&2
+            exit 1
+            ;;
+    esac
+}
+
+restore_apt_sources_if_missing
+rm -f /ERROR
+
 # Install bash if needed
 if ! command -v bash > /dev/null 2> /dev/null; then
     (apt-get update && apt-get install -yqq --no-install-recommends bash || apk add --no-cache bash) > /dev/null

CLAUDE.md

@@ -43,15 +43,21 @@ Shared build-time scripts are pulled from `.templates/` at build time:
 - `bashio-standalone.sh` – Bashio library for scripts outside Supervisor context
 
 The `ARG MODULES=` line lists template scripts to download at build time (e.g., `00-banner.sh 01-custom_script.sh 00-smb_mounts.sh`). Commonly-used modules in `.templates/` (not exhaustive):
+- `00-banner.sh` – Print the add-on startup banner
 - `00-global_var.sh` – Initialize global env vars from HA options
 - `00-local_mounts.sh` – Mount local disks (localdisks option)
 - `00-smb_mounts.sh` – SMB/CIFS network mount support
+- `00-deprecated.sh` – Print a deprecation warning for add-ons superseded by official ones
 - `01-config_yaml.sh` – Map HA options → app's `config.yaml`
 - `01-custom_script.sh` – Run user-provided custom scripts
+- `19-json_repair.sh` – Validate/repair JSON config files
 - `90-disable_ingress.sh` – Allow disabling HA ingress
 - `90-dns_set.sh` – Configure custom DNS
+- `91-silent.sh` – Reduce log verbosity
 - `91-universal_graphic_drivers.sh` – GPU driver detection
-- `19-json_repair.sh` – Validate/repair JSON config files
+- `99-custom_script.sh` – Run a user `script.sh` from the add-on config dir at startup
+
+Other helper scripts in `.templates/` used at build/run time: `ha_automatic_packages.sh` (resolve package names across distros), `ha_entrypoint_modif.sh`, `00-aaa_dockerfile_backup.sh`, plus `config.template`/`script.template`/`show_text_color` (templates/assets copied into add-ons).
 
 ## config.yaml Schema
 
@@ -120,6 +126,15 @@ When an upstream version is bumped, update `version` in `config.yaml`. If the ad
 
 **Weekly** (`weekly_addons_updater`): Runs the `addons_updater` container to bump add-on versions to match upstream.
 
+Other automation workflows:
+- `daily_README.yaml` – Regenerates the root `README.md` add-on table.
+- `weekly_crlftolf.yaml` – Finds and fixes CRLF line endings repo-wide.
+- `weekly_reduceimagesize.yml` – Compresses images and opens a PR with savings.
+- `weekly_stats.yaml` / `helper_stats_graphs.yaml` – Refresh the `Stats`/`Stats2` files and stat graphs.
+- `daily_stale.yml` – Warns and closes stale issues/PRs.
+- `on_issues.yml` / `on_issues_ping_submitter.yml` – Link issues to add-on READMEs and ping submitters.
+- `generate_stargazer_map.yml` – Regenerates the stargazer map image.
+
 Adding `[nobuild]` anywhere in a commit message skips the builder workflow.
 
 ## Linting Rules
@@ -146,3 +161,7 @@ Scripts in `rootfs/etc/cont-init.d/` run in lexicographic order. Common numberin
 - `80-*` – Application configuration
 - `90-*` – Misc pre-startup tasks (ssl, vpn, custom run)
 - `99-*` – Final startup / launch
+
+## User Customization
+
+Add-ons support end-user customization without rebuilding the image (see the repo wiki). At startup, `99-custom_script.sh` looks in the add-on's config directory for a user-provided `script.sh` (seeded from `.templates/script.template`) and executes it. Combined with the `env_vars` passthrough and the custom-script modules, this lets users inject commands and environment without forking the add-on.

aurral/CHANGELOG.md

@@ -1,3 +1,6 @@
+ 
+## 1.76.51 (2026-06-17)
+- Update to latest version from lklynet/aurral (changelog : https://github.com/lklynet/aurral/releases)
 ## 1.76.49 (2026-06-05)
 - Update to latest version from lklynet/aurral (changelog : https://github.com/lklynet/aurral/releases)
 ## 1.76.42 (2026-06-01)

aurral/config.yaml

@@ -1,5 +1,5 @@
 name: Aurral
-version: "1.76.49"
+version: "1.76.51"
 slug: aurral
 description: >-
   Self-hosted music discovery, request management, flows, and playlist

aurral/updater.json

@@ -1,8 +1,9 @@
 {
-  "last_update": "2026-06-05",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "aurral",
   "source": "github",
   "upstream_repo": "lklynet/aurral",
-  "upstream_version": "1.76.49"
+  "upstream_version": "1.76.51",
+  "github_beta": false
 }

birdnet-go/CHANGELOG.md

@@ -1,3 +1,6 @@
+ 
+## nightly-20260615 (2026-06-17)
+- Update to latest version from tphakala/birdnet-go (changelog : https://github.com/tphakala/birdnet-go/releases)
 ## nightly-20260601-2 (03-06-2026)
 - Minor bugs fixed
 ## nightly-20260601 (2026-06-01)

birdnet-go/config.yaml

@@ -126,4 +126,4 @@ slug: birdnet-go
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/birdnet-go
 usb: true
-version: "nightly-20260601-2"
+version: "nightly-20260615"

birdnet-go/updater.json

@@ -2,10 +2,10 @@
   "github_beta": true,
   "github_exclude": "-4",
   "github_fulltag": true,
-  "last_update": "2026-06-01",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "birdnet-go",
   "source": "github",
   "upstream_repo": "tphakala/birdnet-go",
-  "upstream_version": "nightly-20260601"
+  "upstream_version": "nightly-20260615"
 }

birdnet-pi/CHANGELOG.md

@@ -1,3 +1,5 @@
+## 2026.06.01 (19-06-2026)
+- Minor bugs fixed
 ## 2026.02.25 (25-02-2026)
 - Minor bugs fixed
 ## 2026.02.01 (01-02-2026)

birdnet-pi/config.yaml

@@ -116,5 +116,5 @@ tmpfs: true
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/birdnet-pi
 usb: true
-version: 2026.02.25
+version: 2026.06.01
 video: true

browserless_chrome/CHANGELOG.md

@@ -1,4 +1,7 @@
  
+## 2.52.2 (2026-06-17)
+- Update to latest version from browserless/chrome (changelog : https://github.com/browserless/chrome/releases)
+ 
 ## 2.52.1 (2026-06-13)
 - Update to latest version from browserless/chrome (changelog : https://github.com/browserless/chrome/releases)
  

browserless_chrome/config.yaml

@@ -86,5 +86,5 @@ schema:
 slug: browserless_chrome
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/browserless_chrome
-version: "2.52.1"
+version: "2.52.2"
 webui: "[PROTO:ssl]://[HOST]:[PORT:3000]/docs"

browserless_chrome/updater.json

@@ -1,9 +1,9 @@
 {
   "github_tagfilter": "v",
-  "last_update": "2026-06-13",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "browserless_chrome",
   "source": "github",
   "upstream_repo": "browserless/chrome",
-  "upstream_version": "2.52.1"
+  "upstream_version": "2.52.2"
 }

cloudcommander/CHANGELOG.md

@@ -1,3 +1,6 @@
+ 
+## 19.19.1 (2026-06-17)
+- Update to latest version from coderaiser/cloudcmd (changelog : https://github.com/coderaiser/cloudcmd/releases)
 
 ## 19.19.0 (2026-05-30)
 - Update to latest version from coderaiser/cloudcmd (changelog : https://github.com/coderaiser/cloudcmd/releases)

cloudcommander/config.yaml

@@ -104,4 +104,4 @@ schema:
 slug: cloudcommander
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/cloudcommander
-version: "19.19.0"
+version: "19.19.1"

cloudcommander/updater.json

@@ -1,8 +1,8 @@
 {
-  "last_update": "2026-05-30",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "cloudcommander",
   "source": "github",
   "upstream_repo": "coderaiser/cloudcmd",
-  "upstream_version": "19.19.0"
+  "upstream_version": "19.19.1"
 }

codex/CHANGELOG.md

@@ -1,3 +1,6 @@
+ 
+## 1.12.8 (2026-06-17)
+- Update to latest version from ajslater/codex (changelog : https://github.com/ajslater/codex/releases)
 
 ## 1.12.7 (2026-05-30)
 - Update to latest version from ajslater/codex (changelog : https://github.com/ajslater/codex/releases)

codex/config.yaml

@@ -101,4 +101,4 @@ schema:
 slug: codex
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "1.12.7"
+version: "1.12.8"

codex/updater.json

@@ -1,9 +1,9 @@
 {
   "github_beta": "true",
-  "last_update": "2026-05-30",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "codex",
   "source": "github",
   "upstream_repo": "ajslater/codex",
-  "upstream_version": "1.12.7"
+  "upstream_version": "1.12.8"
 }

filebrowser/CHANGELOG.md

@@ -1,4 +1,7 @@
  
+## 2.63.15 (2026-06-17)
+- Update to latest version from filebrowser/filebrowser (changelog : https://github.com/filebrowser/filebrowser/releases)
+ 
 ## 2.63.14 (2026-06-11)
 - Update to latest version from filebrowser/filebrowser (changelog : https://github.com/filebrowser/filebrowser/releases)
 ## 2.63.12 (2026-06-05)

filebrowser/config.yaml

@@ -124,4 +124,4 @@ schema:
 slug: filebrowser
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "2.63.14"
+version: "2.63.15"

filebrowser/updater.json

@@ -1,10 +1,10 @@
 {
   "github_beta": "true",
-  "last_update": "2026-06-11",
+  "last_update": "2026-06-17",
   "paused": false,
   "repository": "alexbelgium/hassio-addons",
   "slug": "filebrowser",
   "source": "github",
   "upstream_repo": "filebrowser/filebrowser",
-  "upstream_version": "2.63.14"
+  "upstream_version": "2.63.15"
 }

grav/CHANGELOG.md

@@ -1,3 +1,6 @@
+ 
+## 1.7.53 (2026-06-17)
+- Update to latest version from linuxserver/docker-grav (changelog : https://github.com/linuxserver/docker-grav/releases)
 
 ## 1.7.52 (2026-05-02)
 - Update to latest version from linuxserver/docker-grav (changelog : https://github.com/linuxserver/docker-grav/releases)

grav/Dockerfile

@@ -16,7 +16,7 @@
 
 ARG BUILD_FROM
 ARG BUILD_VERSION
-ARG BUILD_UPSTREAM="1.7.52"
+ARG BUILD_UPSTREAM="1.7.53"
 FROM ${BUILD_FROM}
 
 ##################

grav/config.yaml

@@ -89,5 +89,5 @@ schema:
 slug: grav
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "1.7.52"
+version: "1.7.53"
 webui: "[PROTO:ssl]://[HOST]:[PORT:80]"

grav/updater.json

@@ -1,9 +1,9 @@
 {
   "github_beta": false,
-  "last_update": "2026-05-02",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "grav",
   "source": "github",
   "upstream_repo": "linuxserver/docker-grav",
-  "upstream_version": "1.7.52"
+  "upstream_version": "1.7.53"
 }

jackett/CHANGELOG.md

@@ -1,4 +1,7 @@
  
+## 0.24.2075 (2026-06-17)
+- Update to latest version from linuxserver/docker-jackett (changelog : https://github.com/linuxserver/docker-jackett/releases)
+ 
 ## 0.24.2051 (2026-06-13)
 - Update to latest version from linuxserver/docker-jackett (changelog : https://github.com/linuxserver/docker-jackett/releases)
  

jackett/config.yaml

@@ -106,5 +106,5 @@ schema:
 slug: jackett_nas
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/jackett
-version: "0.24.2051"
+version: "0.24.2075"
 webui: http://[HOST]:[PORT:9117]

jackett/updater.json

@@ -1,8 +1,8 @@
 {
-  "last_update": "2026-06-13",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "jackett",
   "source": "github",
   "upstream_repo": "linuxserver/docker-jackett",
-  "upstream_version": "0.24.2051"
+  "upstream_version": "0.24.2075"
 }

mylar3/CHANGELOG.md

@@ -1,3 +1,6 @@
+ 
+## 0.10.0 (2026-06-17)
+- Update to latest version from linuxserver/docker-mylar3 (changelog : https://github.com/linuxserver/docker-mylar3/releases)
 
 ## 0.9.0 (2026-04-23)
 - Update to latest version from linuxserver/docker-mylar3 (changelog : https://github.com/linuxserver/docker-mylar3/releases)

mylar3/config.yaml

@@ -100,5 +100,5 @@ schema:
 slug: mylar3
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "0.9.0"
+version: "0.10.0"
 webui: "[PROTO:ssl]://[HOST]:[PORT:8090]"

mylar3/updater.json

@@ -1,8 +1,8 @@
 {
-  "last_update": "2026-04-23",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "mylar3",
   "source": "github",
   "upstream_repo": "linuxserver/docker-mylar3",
-  "upstream_version": "0.9.0"
+  "upstream_version": "0.10.0"
 }

nginx_webserver_proxy/Dockerfile

@@ -1,18 +1,14 @@
 ARG BUILD_FROM=jc21/nginx-proxy-manager:latest
 FROM ${BUILD_FROM}
 
-# NPM is Debian-based; install jq for options parsing + stub with-contenv if absent
+# NPM is Debian-based; install jq for options parsing and ensure bash is present.
 # hadolint ignore=DL3008
 RUN apt-get update \
-    && apt-get install -y --no-install-recommends jq \
-    && rm -rf /var/lib/apt/lists/* \
-    && if ! command -v with-contenv >/dev/null 2>&1; then \
-         printf '#!/usr/bin/env bash\nexec "$@"\n' > /usr/bin/with-contenv \
-         && chmod +x /usr/bin/with-contenv; \
-       fi
+    && apt-get install -y --no-install-recommends bash jq \
+    && rm -rf /var/lib/apt/lists/*
 
 COPY run.sh /npm-addon-init.sh
-RUN chmod +x /npm-addon-init.sh
+RUN chmod 0755 /npm-addon-init.sh
 
 ARG BUILD_VERSION
 LABEL \

nginx_webserver_proxy/config.yaml

@@ -1,7 +1,7 @@
 name: "Nginx Proxy Manager + Static Web Server"
 slug: nginx_webserver_proxy
 description: "Nginx Proxy Manager with a built-in configurable static file server. Manage reverse proxies via NPM UI on port 81 while serving files from HA storage on port 80."
-version: "2.14.0"
+version: "2.14.1"
 url: "https://github.com/alexbelgium/hassio-addons/tree/master/nginx_webserver_proxy"
 arch:
   - amd64

nginx_webserver_proxy/run.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/with-contenv bash
+#!/bin/bash
 # shellcheck shell=bash
 set -Eeuo pipefail
 

openproject/CHANGELOG.md

@@ -1,4 +1,7 @@
  
+## 17.5.1 (2026-06-17)
+- Update to latest version from opf/openproject (changelog : https://github.com/opf/openproject/releases)
+ 
 ## 17.5.0 (2026-06-11)
 - Update to latest version from opf/openproject (changelog : https://github.com/opf/openproject/releases)
 

openproject/config.yaml

@@ -34,5 +34,5 @@ schema:
 slug: openproject
 udev: true
 url: https://github.com/alexbelgium/hassio-addons/tree/master/openproject
-version: "17.5.0"
+version: "17.5.1"
 webui: "[PROTO:ssl]://[HOST]:[PORT:8080]"

openproject/updater.json

@@ -1,8 +1,8 @@
 {
-  "last_update": "2026-06-11",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "openproject",
   "source": "github",
   "upstream_repo": "opf/openproject",
-  "upstream_version": "17.5.0"
+  "upstream_version": "17.5.1"
 }

plex/updater.json

@@ -1,9 +1,9 @@
 {
   "github_fulltag": "true",
-  "last_update": "2026-06-11",
+  "last_update": "2026-06-17",
   "repository": "alexbelgium/hassio-addons",
   "slug": "plex",
   "source": "github",
   "upstream_repo": "linuxserver/docker-plex",
-  "upstream_version": "1.43.2.10687-563d026ea-ls308"
+  "upstream_version": "1.43.2.10687-563d026ea-ls309"
 }