Update CHANGELOG.md (#9637 )

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Update versions.json (#9636 )
2025-12-14 11:13:27 +01:00 · 2025-12-04 00:13:57 +00:00 · 2025-12-04 01:13:31 +01:00 · 2025-12-03 23:06:22 +00:00 · 2025-12-04 00:05:56 +01:00 · 2025-12-03 22:15:23 +00:00
941 changed files with 28357 additions and 5476 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -10,6 +10,282 @@
 > [!CAUTION]
 Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit the project's popularity for potentially malicious purposes.

+## 2025-12-04
+
+## 2025-12-03
+
+### 🚀 Updated Scripts
+
+  - fix(opnsense-vm): improve script  and add single-interface mode [@AlphaLawless](https://github.com/AlphaLawless) ([#9614](https://github.com/community-scripts/ProxmoxVE/pull/9614))
+
+  - #### 🐞 Bug Fixes
+
+    - Fix Homebridge update detection for Debian 13 DEB822 format [@Copilot](https://github.com/Copilot) ([#9629](https://github.com/community-scripts/ProxmoxVE/pull/9629))
+    - go2rtc: Add WorkingDirectory to go2rtc service configuration [@tremor021](https://github.com/tremor021) ([#9618](https://github.com/community-scripts/ProxmoxVE/pull/9618))
+
+  - #### 🔧 Refactor
+
+    - explicit node versions [@CrazyWolf13](https://github.com/CrazyWolf13) ([#9594](https://github.com/community-scripts/ProxmoxVE/pull/9594))
+
+### 🌐 Website
+
+  - Bump next from 15.5.2 to 15.5.7 in /frontend in the npm_and_yarn group across 1 directory [@dependabot[bot]](https://github.com/dependabot[bot]) ([#9632](https://github.com/community-scripts/ProxmoxVE/pull/9632))
+
+  - #### 📝 Script Information
+
+    - Update logo URL in swizzin.json [@MickLesk](https://github.com/MickLesk) ([#9627](https://github.com/community-scripts/ProxmoxVE/pull/9627))
+
+## 2025-12-02
+
+### 🆕 New Scripts
+
+  - Snowshare ([#9578](https://github.com/community-scripts/ProxmoxVE/pull/9578))
+
+### 🚀 Updated Scripts
+
+  - NetVisor: patch systemd file to fix new OIDC config [@vhsdream](https://github.com/vhsdream) ([#9562](https://github.com/community-scripts/ProxmoxVE/pull/9562))
+- Refactor: BookStack [@tremor021](https://github.com/tremor021) ([#9567](https://github.com/community-scripts/ProxmoxVE/pull/9567))
+
+  - #### 🐞 Bug Fixes
+
+    - Matterbridge: Fix ExecStart command in service install script to allow childbridge mode [@jonalbr](https://github.com/jonalbr) ([#9603](https://github.com/community-scripts/ProxmoxVE/pull/9603))
+    - Open-webui add .env backup and restore functionality from older versions [@DrDonoso](https://github.com/DrDonoso) ([#9592](https://github.com/community-scripts/ProxmoxVE/pull/9592))
+    - Booklore: Downgrad Java from 25 to 21 [@Pr0mises](https://github.com/Pr0mises) ([#9566](https://github.com/community-scripts/ProxmoxVE/pull/9566))
+
+  - #### ✨ New Features
+
+    - Set Valkey memory and eviction defaults [@pshankinclarke](https://github.com/pshankinclarke) ([#9602](https://github.com/community-scripts/ProxmoxVE/pull/9602))
+    - Add auth via requirepass to Valkey [@pshankinclarke](https://github.com/pshankinclarke) ([#9570](https://github.com/community-scripts/ProxmoxVE/pull/9570))
+
+  - #### 🔧 Refactor
+
+    - Refactor: 2FAuth [@tremor021](https://github.com/tremor021) ([#9582](https://github.com/community-scripts/ProxmoxVE/pull/9582))
+    - Refactor: Paperless-AI [@MickLesk](https://github.com/MickLesk) ([#9588](https://github.com/community-scripts/ProxmoxVE/pull/9588))
+    - Refactor: AdventureLog [@tremor021](https://github.com/tremor021) ([#9583](https://github.com/community-scripts/ProxmoxVE/pull/9583))
+    - CommaFeed: Bump Java and service file [@tremor021](https://github.com/tremor021) ([#9564](https://github.com/community-scripts/ProxmoxVE/pull/9564))
+    - Refactor: Docmost [@tremor021](https://github.com/tremor021) ([#9563](https://github.com/community-scripts/ProxmoxVE/pull/9563))
+    - Cloudflared: Add repo via helper function [@tremor021](https://github.com/tremor021) ([#9565](https://github.com/community-scripts/ProxmoxVE/pull/9565))
+
+### 🧰 Maintenance
+
+  - #### 📝 Documentation
+
+    - add configuration and deployment guides to docs [@MickLesk](https://github.com/MickLesk) ([#9591](https://github.com/community-scripts/ProxmoxVE/pull/9591))
+
+### 🌐 Website
+
+  - #### 📝 Script Information
+
+    - Update category for "Wanderer" [@Lorondos](https://github.com/Lorondos) ([#9607](https://github.com/community-scripts/ProxmoxVE/pull/9607))
+
+## 2025-12-01
+
+### 🆕 New Scripts
+
+  - Wanderer ([#9556](https://github.com/community-scripts/ProxmoxVE/pull/9556))
+- core: add cloud-init.func library for VM configuration [@MickLesk](https://github.com/MickLesk) ([#9538](https://github.com/community-scripts/ProxmoxVE/pull/9538))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - core: sanitize appname for certificate generation [@tremor021](https://github.com/tremor021) ([#9552](https://github.com/community-scripts/ProxmoxVE/pull/9552))
+    - Fix Django superuser creation failing with ImproperlyConfigured error [@Copilot](https://github.com/Copilot) ([#9554](https://github.com/community-scripts/ProxmoxVE/pull/9554))
+
+  - #### ✨ New Features
+
+    - Bump Baikal to deb13 [@MickLesk](https://github.com/MickLesk) ([#9544](https://github.com/community-scripts/ProxmoxVE/pull/9544))
+    - Enhance MariaDB version fallback logic [@MickLesk](https://github.com/MickLesk) ([#9545](https://github.com/community-scripts/ProxmoxVE/pull/9545))
+
+  - #### 💥 Breaking Changes
+
+    - Refactor: Healthchecks [@MickLesk](https://github.com/MickLesk) ([#9188](https://github.com/community-scripts/ProxmoxVE/pull/9188))
+
+  - #### 🔧 Refactor
+
+    - Refactor: Mealie [@MickLesk](https://github.com/MickLesk) ([#9308](https://github.com/community-scripts/ProxmoxVE/pull/9308))
+
+### 🧰 Maintenance
+
+  - #### 📂 Github
+
+    - add comprehensive documentation (core, develop, functions, technical guide, contributor guide) [@MickLesk](https://github.com/MickLesk) ([#9537](https://github.com/community-scripts/ProxmoxVE/pull/9537))
+
+### 🌐 Website
+
+  - #### 📝 Script Information
+
+    - update selfhst icon-URLs to use @master path [@MickLesk](https://github.com/MickLesk) ([#9543](https://github.com/community-scripts/ProxmoxVE/pull/9543))
+
+## 2025-11-30
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - fix(recyclarr): remove update script systemctl commands [@vidonnus](https://github.com/vidonnus) ([#9522](https://github.com/community-scripts/ProxmoxVE/pull/9522))
+
+  - #### 🔧 Refactor
+
+    - Refactor: Actual Budget [@tremor021](https://github.com/tremor021) ([#9518](https://github.com/community-scripts/ProxmoxVE/pull/9518))
+
+## 2025-11-29
+
+### 🆕 New Scripts
+
+  - Valkey ([#9510](https://github.com/community-scripts/ProxmoxVE/pull/9510))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Fix duplicate ORIGIN in .env for OpenArchiver install script [@Copilot](https://github.com/Copilot) ([#9503](https://github.com/community-scripts/ProxmoxVE/pull/9503))
+
+  - #### 💥 Breaking Changes
+
+    - Remove: Documenso [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#9507](https://github.com/community-scripts/ProxmoxVE/pull/9507))
+
+### 🌐 Website
+
+  - Update Discord link on website [@tremor021](https://github.com/tremor021) ([#9499](https://github.com/community-scripts/ProxmoxVE/pull/9499))
+
+## 2025-11-28
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Apache-guacamole: fixed to early rm [@mtorazzi](https://github.com/mtorazzi) ([#9492](https://github.com/community-scripts/ProxmoxVE/pull/9492))
+
+  - #### 💥 Breaking Changes
+
+    - Remove: Habitica [@MickLesk](https://github.com/MickLesk) ([#9489](https://github.com/community-scripts/ProxmoxVE/pull/9489))
+
+## 2025-11-27
+
+### 🆕 New Scripts
+
+  - Qdrant ([#9465](https://github.com/community-scripts/ProxmoxVE/pull/9465))
+
+### 🚀 Updated Scripts
+
+  - #### 💥 Breaking Changes
+
+    - Upgrade pve-scripts-local to node 24 [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#9457](https://github.com/community-scripts/ProxmoxVE/pull/9457))
+
+### 🌐 Website
+
+  - #### 🐞 Bug Fixes
+
+    - PBS: fix typo [@joshuaharmsen845](https://github.com/joshuaharmsen845) ([#9482](https://github.com/community-scripts/ProxmoxVE/pull/9482))
+
+## 2025-11-26
+
+### 🚀 Updated Scripts
+
+  - Joplin Server: Increase RAM for LXC [@tremor021](https://github.com/tremor021) ([#9460](https://github.com/community-scripts/ProxmoxVE/pull/9460))
+
+  - #### 🐞 Bug Fixes
+
+    - Fix Open WebUI update logic (swap upgrade/install) [@camcop](https://github.com/camcop) ([#9461](https://github.com/community-scripts/ProxmoxVE/pull/9461))
+
+## 2025-11-25
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Open WebUI: Change install command to upgrade for Open-WebUI [@tremor021](https://github.com/tremor021) ([#9448](https://github.com/community-scripts/ProxmoxVE/pull/9448))
+    - core: set default LANG in locale configuration [@MickLesk](https://github.com/MickLesk) ([#9440](https://github.com/community-scripts/ProxmoxVE/pull/9440))
+    - documenso: switch to npm peer-.deps to get build running [@MickLesk](https://github.com/MickLesk) ([#9441](https://github.com/community-scripts/ProxmoxVE/pull/9441))
+    - Refactor Asterisk installation process [@MickLesk](https://github.com/MickLesk) ([#9429](https://github.com/community-scripts/ProxmoxVE/pull/9429))
+    - Fix the mikrotik VM installer after they reformatted their downloads page [@paul-ridgway](https://github.com/paul-ridgway) ([#9434](https://github.com/community-scripts/ProxmoxVE/pull/9434))
+    - paperless: patch consume to uv [@MickLesk](https://github.com/MickLesk) ([#9425](https://github.com/community-scripts/ProxmoxVE/pull/9425))
+
+  - #### ✨ New Features
+
+    - add Zabbix version selection to install and update scripts [@MickLesk](https://github.com/MickLesk) ([#9430](https://github.com/community-scripts/ProxmoxVE/pull/9430))
+
+### 🧰 Maintenance
+
+  - #### 📂 Github
+
+    - gh: update supported PVE Version [@MickLesk](https://github.com/MickLesk) ([#9422](https://github.com/community-scripts/ProxmoxVE/pull/9422))
+
+## 2025-11-24
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - core: remove uv cache clean command [@MickLesk](https://github.com/MickLesk) ([#9413](https://github.com/community-scripts/ProxmoxVE/pull/9413))
+    - Joplin-Server: Bump Node.js version from 22 to 24 [@tremor021](https://github.com/tremor021) ([#9405](https://github.com/community-scripts/ProxmoxVE/pull/9405))
+
+  - #### 🔧 Refactor
+
+    - [Fix]: Wizarr DB error during install [@vhsdream](https://github.com/vhsdream) ([#9415](https://github.com/community-scripts/ProxmoxVE/pull/9415))
+
+### 🌐 Website
+
+  - #### 📝 Script Information
+
+    - Gitea: Update website [@tremor021](https://github.com/tremor021) ([#9406](https://github.com/community-scripts/ProxmoxVE/pull/9406))
+    - huntarr: disable on website during install issues [@MickLesk](https://github.com/MickLesk) ([#9403](https://github.com/community-scripts/ProxmoxVE/pull/9403))
+
+## 2025-11-23
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - core: remove journal log rotation [@MickLesk](https://github.com/MickLesk) ([#9392](https://github.com/community-scripts/ProxmoxVE/pull/9392))
+    - [LibreNMS] Correcting mariadb sed string for Debian 13 default in install/librenms-install.sh, website config for Debian 13 #9369 [@htmlspinnr](https://github.com/htmlspinnr) ([#9370](https://github.com/community-scripts/ProxmoxVE/pull/9370))
+    - fix: Snipe-IT update check failure [@ruanmed](https://github.com/ruanmed) ([#9371](https://github.com/community-scripts/ProxmoxVE/pull/9371))
+
+  - #### ✨ New Features
+
+    - PVE Kernel Clean: Add info about currently running kernel [@tremor021](https://github.com/tremor021) ([#9388](https://github.com/community-scripts/ProxmoxVE/pull/9388))
+
+  - #### 🔧 Refactor
+
+    - Update glpi-install.sh to remove install.php [@CrazyWolf13](https://github.com/CrazyWolf13) ([#9378](https://github.com/community-scripts/ProxmoxVE/pull/9378))
+
+### 🌐 Website
+
+  - #### 🐞 Bug Fixes
+
+    - fix: enhance back navigation in NotFoundPage component and remove unused deps [@BramSuurdje](https://github.com/BramSuurdje) ([#9341](https://github.com/community-scripts/ProxmoxVE/pull/9341))
+
+  - #### ✨ New Features
+
+    - feat(frontend): add script disable functionality with visual indicators [@AlphaLawless](https://github.com/AlphaLawless) ([#9374](https://github.com/community-scripts/ProxmoxVE/pull/9374))
+
+## 2025-11-22
+
+### 🆕 New Scripts
+
+  - Upgopher ([#9360](https://github.com/community-scripts/ProxmoxVE/pull/9360))
+
+### 🚀 Updated Scripts
+
+  - Expand support to Proxmox VE 9.1 in VM scripts [@MickLesk](https://github.com/MickLesk) ([#9351](https://github.com/community-scripts/ProxmoxVE/pull/9351))
+
+  - #### 🐞 Bug Fixes
+
+    - fix: Snipe-IT install and update failure due to new repository url [@ruanmed](https://github.com/ruanmed) ([#9362](https://github.com/community-scripts/ProxmoxVE/pull/9362))
+    - glpi - allow migration of existing databases [@moodyblue](https://github.com/moodyblue) ([#9353](https://github.com/community-scripts/ProxmoxVE/pull/9353))
+
+  - #### ✨ New Features
+
+    - Refactor cleanup steps to use cleanup_lxc function (install/ Folder) [@MickLesk](https://github.com/MickLesk) ([#9354](https://github.com/community-scripts/ProxmoxVE/pull/9354))
+    - Remove redundant cleanup steps from update scripts (ct/ Folder)  [@MickLesk](https://github.com/MickLesk) ([#9359](https://github.com/community-scripts/ProxmoxVE/pull/9359))
+
+### 🌐 Website
+
+  - #### ✨ New Features
+
+    - Refactor /data page [@BramSuurdje](https://github.com/BramSuurdje) ([#9343](https://github.com/community-scripts/ProxmoxVE/pull/9343))
+
 ## 2025-11-21

 ### 🚀 Updated Scripts
--- a/README.md
+++ b/README.md
@ -105,7 +105,7 @@
  <tr>
    <td align="center" width="33%">
      <h3>🖥️ Proxmox VE</h3>
-      <p>Version 8.4.x or 9.0.x</p>
+      <p>Version: 8.4.x | 9.0.x | 9.1.x</p>
    </td>
    <td align="center" width="33%">
      <h3>🐧 Operating System</h3>
--- a/SECURITY.md
+++ b/SECURITY.md
@ -6,6 +6,7 @@ This project currently supports the following versions of Proxmox VE (PVE):

 | Version | Supported          |
 | ------- | ------------------ |
+| 9.1.x   | :white_check_mark: |
 | 9.0.x   | :white_check_mark: |
 | 8.4.x   | :white_check_mark: |
 | 8.3.x   | Limited support* ❕ |
--- a/ct/2fauth.sh
+++ b/ct/2fauth.sh
@ -40,10 +40,7 @@ function update_script() {
    msg_ok "Backup Created"

    if ! dpkg -l | grep -q 'php8.3'; then
-      $STD apt-get install -y \
-        lsb-release \
-        gnupg2
-      PHP_VERSION="8.3" PHP_MODULE="common,ctype,fileinfo,mysql,cli" PHP_FPM="YES" setup_php
+      PHP_VERSION="8.3" PHP_MODULE="common,ctype,fileinfo,mysql,cli,tokenizer,dom,redis,session,openssl" PHP_FPM="YES" setup_php
      sed -i 's/php8.2/php8.3/g' /etc/nginx/conf.d/2fauth.conf
    fi
    fetch_and_deploy_gh_release "2fauth" "Bubka/2FAuth"
@ -57,15 +54,6 @@ function update_script() {
    $STD composer install --no-dev --prefer-dist
    php artisan 2fauth:install
    $STD systemctl restart nginx
-
-    msg_info "Cleaning Up"
-    if dpkg -l | grep -q 'php8.2'; then
-      $STD apt remove --purge -y php8.2*
-    fi
-    $STD apt -y autoremove
-    $STD apt -y autoclean
-    $STD apt -y clean
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/actualbudget.sh
+++ b/ct/actualbudget.sh
@ -24,33 +24,32 @@ function update_script() {
  check_container_storage
  check_container_resources

-  if [[ ! -f /opt/actualbudget_version.txt ]]; then
+  if [[ ! -f ~/.actualbudget && ! -f /opt/actualbudget_version.txt ]]; then
    msg_error "No ${APP} Installation Found!"
    exit
  fi
+
  NODE_VERSION="22" setup_nodejs
-  RELEASE=$(curl -fsSL https://api.github.com/repos/actualbudget/actual/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
+  RELEASE=$(get_latest_github_release "actualbudget/actual")
  if [[ -f /opt/actualbudget-data/config.json ]]; then
-    if [[ ! -f /opt/actualbudget_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/actualbudget_version.txt)" ]]; then
+    if check_for_gh_release "actualbudget" "actualbudget/actual"; then
      msg_info "Stopping Service"
      systemctl stop actualbudget
      msg_ok "Stopped Service"

-      msg_info "Updating ${APP} to ${RELEASE}"
+      msg_info "Updating Actual Budget to ${RELEASE}"
      $STD npm update -g @actual-app/sync-server
-      echo "${RELEASE}" >/opt/actualbudget_version.txt
-      msg_ok "Updated ${APP} to ${RELEASE}"
+      echo "${RELEASE}" >~/.actualbudget
+      msg_ok "Updated Actual Budget to ${RELEASE}"

      msg_info "Starting Service"
      systemctl start actualbudget
      msg_ok "Started Service"
      msg_ok "Updated successfully!"
-    else
-      msg_info "${APP} is already up to date"
    fi
  else
    msg_info "Old Installation Found, you need to migrate your data and recreate to a new container"
-    msg_info "Please follow the instructions on the ${APP} website to migrate your data"
+    msg_info "Please follow the instructions on the Actual Budget website to migrate your data"
    msg_info "https://actualbudget.org/docs/backup-restore/backup"
    exit
  fi
--- a/ct/adventurelog.sh
+++ b/ct/adventurelog.sh
@ -48,7 +48,7 @@ function update_script() {
    msg_info "Updating ${APP}"
    cp /opt/adventurelog-backup/backend/server/.env /opt/adventurelog/backend/server/.env
    cp -r /opt/adventurelog-backup/backend/server/media /opt/adventurelog/backend/server/media
-    cd /opt/adventurelog/backend/server || exit
+    cd /opt/adventurelog/backend/server
    if [[ ! -x .venv/bin/python ]]; then
      $STD uv venv .venv
      $STD .venv/bin/python -m ensurepip --upgrade
@ -59,9 +59,10 @@ function update_script() {
    $STD .venv/bin/python -m manage migrate

    cp /opt/adventurelog-backup/frontend/.env /opt/adventurelog/frontend/.env
-    cd /opt/adventurelog/frontend || exit
+    cd /opt/adventurelog/frontend
    $STD pnpm i
    $STD pnpm build
+    rm -rf /opt/adventurelog-backup
    msg_ok "Updated ${APP}"

    msg_info "Starting Services"
@ -69,10 +70,6 @@ function update_script() {
    systemctl start adventurelog-backend
    systemctl start adventurelog-frontend
    msg_ok "Services Started"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/adventurelog-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/apache-tika.sh
+++ b/ct/apache-tika.sh
@ -38,15 +38,13 @@ function update_script() {
    curl -fsSL -o tika-server-standard-${RELEASE}.jar "https://dlcdn.apache.org/tika/${RELEASE}/tika-server-standard-${RELEASE}.jar"
    mv --force tika-server-standard.jar tika-server-standard-prev-version.jar
    mv tika-server-standard-${RELEASE}.jar tika-server-standard.jar
+    rm -rf /opt/apache-tika/tika-server-standard-prev-version.jar
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP} to v${RELEASE}"

    msg_info "Starting Service"
    systemctl start apache-tika
    msg_ok "Started Service"
-    msg_info "Cleaning Up"
-    rm -rf /opt/apache-tika/tika-server-standard-prev-version.jar
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/authelia.sh
+++ b/ct/authelia.sh
@ -31,15 +31,11 @@ function update_script() {
  fi

  if check_for_gh_release "authelia" "authelia/authelia"; then
-    $STD apt-get update
-    $STD apt-get -y upgrade
+    $STD apt update
+    $STD apt -y upgrade

    fetch_and_deploy_gh_release "authelia" "authelia/authelia" "binary"

-    msg_info "Cleaning Up"
-    $STD apt-get -y autoremove
-    $STD apt-get -y autoclean
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/backrest.sh
+++ b/ct/backrest.sh
@ -39,16 +39,13 @@ function update_script() {
    curl -fsSL "https://github.com/garethgeorge/backrest/releases/download/v${RELEASE}/backrest_Linux_x86_64.tar.gz" -o "$temp_file"
    tar xzf $temp_file -C /opt/backrest/bin
    chmod +x /opt/backrest/bin/backrest
+    rm -f "$temp_file"
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP} to ${RELEASE}"

    msg_info "Starting Service"
    systemctl start backrest
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -f "$temp_file"
-    msg_ok "Cleaned up"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at ${RELEASE}"
--- a/ct/baikal.sh
+++ b/ct/baikal.sh
@ -11,7 +11,7 @@ var_cpu="${var_cpu:-1}"
 var_ram="${var_ram:-512}"
 var_disk="${var_disk:-4}"
 var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
+var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"

 header_info "$APP"
@ -37,8 +37,9 @@ function update_script() {
    mv /opt/baikal /opt/baikal-backup
    msg_ok "Backed up data"

-    fetch_and_deploy_gh_release "baikal" "sabre-io/Baikal"
+    PHP_APACHE="YES" PHP_MODULE="pgsql,curl" PHP_VERSION="8.3" setup_php
    setup_composer
+    fetch_and_deploy_gh_release "baikal" "sabre-io/Baikal"

    msg_info "Configuring Baikal"
    cp -r /opt/baikal-backup/config/baikal.yaml /opt/baikal/config/
@ -47,15 +48,12 @@ function update_script() {
    chmod -R 755 /opt/baikal/
    cd /opt/baikal
    $STD composer install
+    rm -rf /opt/baikal-backup
    msg_ok "Configured Baikal"

    msg_info "Starting Service"
    systemctl start apache2
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/baikal-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/bar-assistant.sh
+++ b/ct/bar-assistant.sh
@ -54,15 +54,12 @@ function update_script() {
    $STD php artisan route:cache
    $STD php artisan event:cache
    chown -R www-data:www-data /opt/bar-assistant
+    rm -rf /opt/bar-assistant-backup
    msg_ok "Updated Bar-Assistant"

    msg_info "Starting nginx"
    systemctl start nginx
    msg_ok "Started nginx"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/bar-assistant-backup
-    msg_ok "Cleaned"
  fi

  if check_for_gh_release "vue-salt-rim" "karlomikus/vue-salt-rim"; then
@ -81,15 +78,12 @@ function update_script() {
    cd /opt/vue-salt-rim
    $STD npm install
    $STD npm run build
+    rm -rf /opt/vue-salt-rim-backup
    msg_ok "Updated Vue Salt Rim"

    msg_info "Starting nginx"
    systemctl start nginx
    msg_ok "Started nginx"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/vue-salt-rim-backup
-    msg_ok "Cleaned"
  fi

  if check_for_gh_release "meilisearch" "meilisearch/meilisearch"; then
--- a/ct/booklore.sh
+++ b/ct/booklore.sh
@ -45,7 +45,7 @@ function update_script() {
    $STD npm run build --configuration=production
    msg_ok "Built Frontend"

-    JAVA_VERSION="25" setup_java
+    JAVA_VERSION="21" setup_java

    msg_info "Building Backend"
    cd /opt/booklore/booklore-api
--- a/ct/bookstack.sh
+++ b/ct/bookstack.sh
@ -11,7 +11,7 @@ var_cpu="${var_cpu:-1}"
 var_ram="${var_ram:-1024}"
 var_disk="${var_disk:-4}"
 var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
+var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"

 header_info "$APP"
@ -57,15 +57,12 @@ function update_script() {
    chmod -R 755 /opt/bookstack /opt/bookstack/bootstrap/cache /opt/bookstack/public/uploads /opt/bookstack/storage
    chmod -R 775 /opt/bookstack/storage /opt/bookstack/bootstrap/cache /opt/bookstack/public/uploads
    chmod -R 640 /opt/bookstack/.env
+    rm -rf /opt/bookstack-backup
    msg_ok "Configured BookStack"

    msg_info "Starting Apache2"
    systemctl start apache2
    msg_ok "Started Apache2"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/bookstack-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/commafeed.sh
+++ b/ct/commafeed.sh
@ -28,6 +28,9 @@ function update_script() {
    msg_error "No ${APP} Installation Found!"
    exit
  fi
+
+  JAVA_VERSION="25" setup_java
+
  if check_for_gh_release "commafeed" "Athou/commafeed"; then
    msg_info "Stopping Service"
    systemctl stop commafeed
--- a/ct/dispatcharr.sh
+++ b/ct/dispatcharr.sh
@ -109,6 +109,7 @@ function update_script() {
    fi
    $STD uv run python manage.py migrate --noinput
    $STD uv run python manage.py collectstatic --noinput
+    rm -f /tmp/dispatcharr_db_*.sql
    msg_ok "Migrations Complete"

    msg_info "Starting Services"
@ -117,10 +118,6 @@ function update_script() {
    systemctl start dispatcharr-celerybeat
    systemctl start dispatcharr-daphne
    msg_ok "Started Services"
-
-    msg_info "Cleaning up"
-    rm -f /tmp/dispatcharr_db_*.sql
-    msg_ok "Cleanup completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/docker.sh
+++ b/ct/docker.sh
@ -76,11 +76,6 @@ function update_script() {
      portainer/agent
    msg_ok "Updated Portainer Agent"
  fi
-
-  msg_info "Cleaning up"
-  $STD apt-get -y autoremove
-  $STD apt-get -y autoclean
-  msg_ok "Cleanup complete"
  msg_ok "Updated successfully!"
  exit
 }
--- a/ct/documenso.sh
+++ b/ct/documenso.sh
@ -1,77 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2025 community-scripts ORG
-# Author: MickLesk (CanbiZ)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/documenso/documenso
-
-APP="Documenso"
-var_tags="${var_tags:-document}"
-var_disk="${var_disk:-12}"
-var_cpu="${var_cpu:-6}"
-var_ram="${var_ram:-6144}"
-var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-  if [[ ! -d /opt/documenso ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-  RELEASE=$(curl -fsSL https://api.github.com/repos/documenso/documenso/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
-  if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
-    msg_info "Stopping Service"
-    systemctl stop documenso
-    msg_ok "Stopped Service"
-
-    msg_info "Updating ${APP} to ${RELEASE}"
-    cp /opt/documenso/.env /opt/
-    rm -rf /opt/documenso
-    cd /opt
-    curl -fsSL "https://github.com/documenso/documenso/archive/refs/tags/v${RELEASE}.zip" -o v${RELEASE}.zip
-    $STD unzip v${RELEASE}.zip
-    mv documenso-${RELEASE} /opt/documenso
-    cd /opt/documenso
-    mv /opt/.env /opt/documenso/.env
-    export TURBO_CACHE=1
-    export NEXT_TELEMETRY_DISABLED=1
-    export CYPRESS_INSTALL_BINARY=0
-    export NODE_OPTIONS="--max-old-space-size=4096"
-    $STD npm ci
-    $STD turbo run build --filter=@documenso/remix
-    $STD npm run prisma:migrate-deploy
-    $STD turbo daemon stop
-    echo "${RELEASE}" >/opt/${APP}_version.txt
-    msg_ok "Updated ${APP}"
-
-    msg_info "Starting Service"
-    systemctl start documenso
-    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/v${RELEASE}.zip
-    msg_ok "Cleaned"
-    msg_ok "Updated successfully!"
-  else
-    msg_ok "No update required. ${APP} is already at ${RELEASE}"
-  fi
-  exit
-}
-
-start
-build_container
-description
-
-msg_ok "Completed Successfully!\n"
-echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
-echo -e "${INFO}${YW} Access it using the following URL:${CL}"
-echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3000${CL}"
--- a/ct/domain-locker.sh
+++ b/ct/domain-locker.sh
@ -34,7 +34,7 @@ function update_script() {
        msg_info "Service stopped"

        PG_VERSION="17" setup_postgresql
-        setup_nodejs
+        NODE_VERSION="22" setup_nodejs
        CLEAN_INSTALL=1 fetch_and_deploy_gh_release "domain-locker" "Lissy93/domain-locker"

        msg_info "Installing Modules (patience)"
--- a/ct/emqx.sh
+++ b/ct/emqx.sh
@ -47,16 +47,13 @@ function update_script() {

    msg_info "Installing EMQX"
    $STD apt-get install -y "$DEB_FILE"
+    rm -f "$DEB_FILE"
+    echo "$RELEASE" >~/.emqx
    msg_ok "Installed EMQX v${RELEASE}"

    msg_info "Starting EMQX"
    systemctl start emqx
-    echo "$RELEASE" >~/.emqx
    msg_ok "Started EMQX"
-
-    msg_info "Cleaning Up"
-    rm -f "$DEB_FILE"
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. EMQX is already at v${RELEASE}"
--- a/ct/fileflows.sh
+++ b/ct/fileflows.sh
@ -48,16 +48,13 @@ function update_script() {
    temp_file=$(mktemp)
    curl -fsSL https://fileflows.com/downloads/zip -o "$temp_file"
    $STD unzip -o -d /opt/fileflows "$temp_file"
+    rm -rf "$temp_file"
+    rm -rf "$backup_filename"
    msg_ok "Updated $APP to latest version"

    msg_info "Starting Service"
    systemctl start fileflows
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf "$temp_file"
-    rm -rf "$backup_filename"
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at latest version"
--- a/ct/ghostfolio.sh
+++ b/ct/ghostfolio.sh
@ -56,10 +56,6 @@ function update_script() {
    msg_info "Starting Service"
    systemctl start ghostfolio
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    $STD npm cache clean --force
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/habitica.sh
+++ b/ct/habitica.sh
@ -1,82 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2025 community-scripts ORG
-# Author: Slaviša Arežina (tremor021)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/HabitRPG/habitica
-
-APP="Habitica"
-var_tags="${var_tags:-gaming}"
-var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-4096}"
-var_disk="${var_disk:-8}"
-var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-
-  if [[ ! -d "/opt/habitica" ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-  NODE_VERSION="20" NODE_MODULE="gulp-cli,mocha" setup_nodejs
-  if check_for_gh_release "habitica" "HabitRPG/habitica"; then
-    msg_info "Stopping Service"
-    systemctl stop habitica-mongodb
-    systemctl stop habitica
-    systemctl stop habitica-client
-    msg_info "Stopped Service"
-
-    msg_info "Save configuration"
-    if [[ -f /opt/habitica/config.json ]]; then
-      cp /opt/habitica/config.json ~/config.json
-      msg_ok "Saved configuration"
-    else
-      msg_warn "No configuration file found, skipping save"
-    fi
-
-    fetch_and_deploy_gh_release "habitica" "HabitRPG/habitica" "tarball" "latest" "/opt/habitica"
-
-    msg_info "Updating $APP"
-    cd /opt/habitica
-    $STD npm i
-    $STD npm run postinstall
-    $STD npm run client:build
-    $STD gulp build:prod
-    msg_ok "Updated $APP"
-
-    msg_info "Restoring configuration"
-    if [[ -f ~/config.json ]]; then
-      cp ~/config.json /opt/habitica/config.json
-      msg_ok "Restored configuration"
-    else
-      msg_warn "No configuration file found to restore"
-    fi
-
-    msg_info "Starting Service"
-    systemctl start habitica-mongodb
-    systemctl start habitica
-    systemctl start habitica-client
-    msg_ok "Started Service"
-    msg_ok "Updated successfully!"
-  fi
-  exit
-}
-
-start
-build_container
-description
-
-msg_ok "Completed Successfully!\n"
-echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
-echo -e "${INFO}${YW} Access it using the following URL:${CL}"
-echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3000${CL}"
--- a/ct/headers/documenso
+++ b/ct/headers/documenso
@ -1,6 +0,0 @@
-    ____                                                 
-   / __ \____  _______  ______ ___  ___  ____  _________ 
-  / / / / __ \/ ___/ / / / __ `__ \/ _ \/ __ \/ ___/ __ \
- / /_/ / /_/ / /__/ /_/ / / / / / /  __/ / / (__  ) /_/ /
-/_____/\____/\___/\__,_/_/ /_/ /_/\___/_/ /_/____/\____/ 
-                                                         
--- a/ct/headers/habitica
+++ b/ct/headers/habitica
@ -1,6 +0,0 @@
-    __  __      __    _ __  _           
-   / / / /___ _/ /_  (_) /_(_)________ _
-  / /_/ / __ `/ __ \/ / __/ / ___/ __ `/
- / __  / /_/ / /_/ / / /_/ / /__/ /_/ / 
-/_/ /_/\__,_/_.___/_/\__/_/\___/\__,_/  
-                                        
--- a/ct/headers/qdrant
+++ b/ct/headers/qdrant
@ -0,0 +1,6 @@
+   ____      __                 __ 
+  / __ \____/ /________ _____  / /_
+ / / / / __  / ___/ __ `/ __ \/ __/
+/ /_/ / /_/ / /  / /_/ / / / / /_  
+\___\_\__,_/_/   \__,_/_/ /_/\__/  
+                                   
--- a/ct/headers/snowshare
+++ b/ct/headers/snowshare
@ -0,0 +1,6 @@
+   _____                     _____ __                  
+  / ___/____  ____ _      __/ ___// /_  ____ _________ 
+  \__ \/ __ \/ __ \ | /| / /\__ \/ __ \/ __ `/ ___/ _ \
+ ___/ / / / / /_/ / |/ |/ /___/ / / / / /_/ / /  /  __/
+/____/_/ /_/\____/|__/|__//____/_/ /_/\__,_/_/   \___/ 
+                                                       
--- a/ct/headers/upgopher
+++ b/ct/headers/upgopher
@ -0,0 +1,6 @@
+   __  __                        __             
+  / / / /___  ____ _____  ____  / /_  ___  _____
+ / / / / __ \/ __ `/ __ \/ __ \/ __ \/ _ \/ ___/
+/ /_/ / /_/ / /_/ / /_/ / /_/ / / / /  __/ /    
+\____/ .___/\__, /\____/ .___/_/ /_/\___/_/     
+    /_/    /____/     /_/                       
--- a/ct/headers/valkey
+++ b/ct/headers/valkey
@ -0,0 +1,6 @@
+ _    __      ____             
+| |  / /___ _/ / /_____  __  __
+| | / / __ `/ / //_/ _ \/ / / /
+| |/ / /_/ / / ,< /  __/ /_/ / 
+|___/\__,_/_/_/|_|\___/\__, /  
+                      /____/   
--- a/ct/headers/wanderer
+++ b/ct/headers/wanderer
@ -0,0 +1,6 @@
+ _       __                __                   
+| |     / /___ _____  ____/ /__  ________  _____
+| | /| / / __ `/ __ \/ __  / _ \/ ___/ _ \/ ___/
+| |/ |/ / /_/ / / / / /_/ /  __/ /  /  __/ /    
+|__/|__/\__,_/_/ /_/\__,_/\___/_/   \___/_/     
+                                                
--- a/ct/healthchecks.sh
+++ b/ct/healthchecks.sh
@ -28,26 +28,42 @@ function update_script() {
    msg_error "No ${APP} Installation Found!"
    exit
  fi
+
  if check_for_gh_release "healthchecks" "healthchecks/healthchecks"; then
    msg_info "Stopping Services"
    systemctl stop healthchecks
    msg_ok "Stopped Services"

-    PYTHON_VERSION="3.13" setup_uv
+    msg_info "Backing up existing installation"
+    BACKUP="/opt/healthchecks-backup-$(date +%F-%H%M)"
+    cp -a /opt/healthchecks "$BACKUP"
+    msg_ok "Backup created at $BACKUP"
+
    fetch_and_deploy_gh_release "healthchecks" "healthchecks/healthchecks"

-    msg_info "Updating healthchecks"
    cd /opt/healthchecks
-    mkdir -p /opt/healthchecks/static-collected/
-    $STD uv pip install wheel gunicorn -r requirements.txt --system
-    $STD uv run -- python manage.py makemigrations
-    $STD uv run -- python manage.py migrate --noinput
-    $STD uv run -- python manage.py collectstatic --noinput
-    $STD uv run -- python manage.py compress
-    msg_ok "Updated healthchecks"
+    if [[ -d venv ]]; then
+      rm -rf venv
+    fi
+    msg_info "Recreating Python venv"
+    $STD python3 -m venv venv
+    $STD source venv/bin/activate
+    $STD pip install --upgrade pip wheel
+    msg_ok "Created venv"
+
+    msg_info "Installing requirements"
+    $STD pip install gunicorn -r requirements.txt
+    msg_ok "Installed requirements"
+
+    msg_info "Running Django migrations"
+    $STD python manage.py migrate --noinput
+    $STD python manage.py collectstatic --noinput
+    $STD python manage.py compress
+    msg_ok "Completed Django migrations and static build"
+
    msg_info "Starting Services"
    systemctl start healthchecks
-    systemctl restart caddy
+    systemctl reload caddy
    msg_ok "Started Services"
    msg_ok "Updated successfully!"
  fi
--- a/ct/homebridge.sh
+++ b/ct/homebridge.sh
@ -23,7 +23,7 @@ function update_script() {
  header_info
  check_container_storage
  check_container_resources
-  if [[ ! -f /etc/apt/sources.list.d/homebridge.list ]]; then
+  if ! dpkg -s homebridge >/dev/null 2>&1; then
    msg_error "No ${APP} Installation Found!"
    exit
  fi
--- a/ct/jellyseerr.sh
+++ b/ct/jellyseerr.sh
@ -20,62 +20,57 @@ color
 catch_errors

 function update_script() {
-    header_info
-    check_container_storage
-    check_container_resources
+  header_info
+  check_container_storage
+  check_container_resources

-    if [[ ! -d /opt/jellyseerr ]]; then
-        msg_error "No ${APP} Installation Found!"
-        exit
-    fi
+  if [[ ! -d /opt/jellyseerr ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi

-    if [ "$(node -v | cut -c2-3)" -ne 22 ]; then
-        msg_info "Updating Node.js Repository"
-        echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" >/etc/apt/sources.list.d/nodesource.list
-        msg_ok "Updating Node.js Repository"
+  if [ "$(node -v | cut -c2-3)" -ne 22 ]; then
+    msg_info "Updating Node.js Repository"
+    echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" >/etc/apt/sources.list.d/nodesource.list
+    msg_ok "Updating Node.js Repository"

-        msg_info "Updating Packages"
-        $STD apt-get update
-        $STD apt-get -y upgrade
-        msg_ok "Updating Packages"
+    msg_info "Updating Packages"
+    $STD apt-get update
+    $STD apt-get -y upgrade
+    msg_ok "Updating Packages"
+  fi

-        msg_info "Cleaning up"
-        apt-get -y autoremove
-        apt-get -y autoclean
-        msg_ok "Cleaning up"
-    fi
+  cd /opt/jellyseerr
+  output=$(git pull --no-rebase)

-    cd /opt/jellyseerr
-    output=$(git pull --no-rebase)
+  pnpm_current=$(pnpm --version 2>/dev/null)
+  pnpm_desired=$(grep -Po '"pnpm":\s*"\K[^"]+' /opt/jellyseerr/package.json)

-    pnpm_current=$(pnpm --version 2>/dev/null)
-    pnpm_desired=$(grep -Po '"pnpm":\s*"\K[^"]+' /opt/jellyseerr/package.json)
+  if [ -z "$pnpm_current" ]; then
+    msg_error "pnpm not found. Installing version $pnpm_desired..."
+    NODE_VERSION="22" NODE_MODULE="pnpm@$pnpm_desired" setup_nodejs
+  elif ! node -e "const semver = require('semver'); process.exit(semver.satisfies('$pnpm_current', '$pnpm_desired') ? 0 : 1)"; then
+    msg_error "Updating pnpm from version $pnpm_current to $pnpm_desired..."
+    NODE_VERSION="22" NODE_MODULE="pnpm@$pnpm_desired" setup_nodejs
+  else
+    msg_ok "pnpm is already installed and satisfies version $pnpm_desired."
+  fi

-    if [ -z "$pnpm_current" ]; then
-        msg_error "pnpm not found. Installing version $pnpm_desired..."
-        NODE_VERSION="22" NODE_MODULE="pnpm@$pnpm_desired" setup_nodejs
-    elif ! node -e "const semver = require('semver'); process.exit(semver.satisfies('$pnpm_current', '$pnpm_desired') ? 0 : 1)"; then
-        msg_error "Updating pnpm from version $pnpm_current to $pnpm_desired..."
-        NODE_VERSION="22" NODE_MODULE="pnpm@$pnpm_desired" setup_nodejs
-    else
-        msg_ok "pnpm is already installed and satisfies version $pnpm_desired."
-    fi
+  msg_info "Updating $APP"
+  if echo "$output" | grep -q "Already up to date."; then
+    msg_ok "$APP is already up to date."
+    exit
+  fi

-    msg_info "Updating $APP"
-    if echo "$output" | grep -q "Already up to date."; then
-        msg_ok "$APP is already up to date."
-        exit
-    fi
+  systemctl stop jellyseerr
+  rm -rf dist .next node_modules
+  export CYPRESS_INSTALL_BINARY=0
+  cd /opt/jellyseerr
+  $STD pnpm install --frozen-lockfile
+  export NODE_OPTIONS="--max-old-space-size=3072"
+  $STD pnpm build

-    systemctl stop jellyseerr
-    rm -rf dist .next node_modules
-    export CYPRESS_INSTALL_BINARY=0
-    cd /opt/jellyseerr
-    $STD pnpm install --frozen-lockfile
-    export NODE_OPTIONS="--max-old-space-size=3072"
-    $STD pnpm build
-
-    cat <<EOF >/etc/systemd/system/jellyseerr.service
+  cat <<EOF >/etc/systemd/system/jellyseerr.service
 [Unit]
 Description=jellyseerr Service
 After=network.target
@ -91,10 +86,10 @@ ExecStart=/usr/bin/node dist/index.js
 WantedBy=multi-user.target
 EOF

-    systemctl daemon-reload
-    systemctl start jellyseerr
-    msg_ok "Updated $APP"
-    exit
+  systemctl daemon-reload
+  systemctl start jellyseerr
+  msg_ok "Updated $APP"
+  exit
 }

 start
--- a/ct/joplin-server.sh
+++ b/ct/joplin-server.sh
@ -8,7 +8,7 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 APP="Joplin-Server"
 var_tags="${var_tags:-notes}"
 var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-4096}"
+var_ram="${var_ram:-6144}"
 var_disk="${var_disk:-20}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
@ -28,6 +28,8 @@ function update_script() {
    exit
  fi

+  NODE_VERSION=24 NODE_MODULE="yarn,npm,pm2" setup_nodejs
+
  if check_for_gh_release "joplin-server" "laurent22/joplin"; then
    msg_info "Stopping Services"
    systemctl stop joplin-server
--- a/ct/keycloak.sh
+++ b/ct/keycloak.sh
@ -49,15 +49,12 @@ function update_script() {
    cp -a keycloak.old/conf/. keycloak/conf/
    cp -a keycloak.old/providers/. keycloak/providers/ 2>/dev/null || true
    cp -a keycloak.old/themes/. keycloak/themes/ 2>/dev/null || true
+    rm -rf keycloak.old
    msg_ok "Updated Keycloak"

    msg_info "Restarting Service"
    systemctl restart keycloak
    msg_ok "Restarted Service"
-
-    msg_info "Cleaning up"
-    rm -rf keycloak.old
-    msg_ok "Cleanup complete"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/koillection.sh
+++ b/ct/koillection.sh
@ -50,15 +50,12 @@ function update_script() {
    $STD yarn install
    $STD yarn build
    chown -R www-data:www-data /opt/koillection/public/uploads
+    rm -r /opt/koillection-backup
    msg_ok "Updated Koillection"

    msg_info "Starting Service"
    systemctl start apache2
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -r /opt/koillection-backup
-    msg_ok "Cleaned"
    msg_ok "Updated Successfully!"
  fi
  exit
--- a/ct/librespeed-rust.sh
+++ b/ct/librespeed-rust.sh
@ -30,13 +30,13 @@ function update_script() {

  if check_for_gh_release "librespeed-rust" "librespeed/speedtest-rust"; then
    msg_info "Stopping Services"
-    systemctl stop librespeed_rs
+    systemctl stop librespeed-rs
    msg_ok "Services Stopped"

    fetch_and_deploy_gh_release "librespeed-rust" "librespeed/speedtest-rust" "binary" "latest" "/opt/librespeed-rust" "librespeed-rs-x86_64-unknown-linux-gnu.deb"

    msg_info "Starting Service"
-    systemctl start librespeed_rs
+    systemctl start librespeed-rs
    msg_ok "Started Service"
    msg_ok "Updated successfully!"
  fi
--- a/ct/linkwarden.sh
+++ b/ct/linkwarden.sh
@ -52,17 +52,14 @@ function update_script() {
    $STD yarn web:build
    $STD yarn prisma:deploy
    [ -d /opt/data.bak ] && mv /opt/data.bak /opt/linkwarden/data
+    rm -rf ~/.cargo/registry ~/.cargo/git ~/.cargo/.package-cache ~/.rustup
+    rm -rf /root/.cache/yarn
+    rm -rf /opt/linkwarden/.next/cache
    msg_ok "Updated ${APP}"

    msg_info "Starting Service"
    systemctl start linkwarden
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf ~/.cargo/registry ~/.cargo/git ~/.cargo/.package-cache ~/.rustup
-    rm -rf /root/.cache/yarn
-    rm -rf /opt/linkwarden/.next/cache
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/listmonk.sh
+++ b/ct/listmonk.sh
@ -42,15 +42,12 @@ function update_script() {
    mv /opt/listmonk-backup/config.toml /opt/listmonk/config.toml
    mv /opt/listmonk-backup/uploads /opt/listmonk/uploads
    $STD /opt/listmonk/listmonk --upgrade --yes --config /opt/listmonk/config.toml
+    rm -rf /opt/listmonk-backup/
    msg_ok "Configured listmonk"

    msg_info "Starting Service"
    systemctl start listmonk
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/listmonk-backup/
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/lubelogger.sh
+++ b/ct/lubelogger.sh
@ -53,15 +53,12 @@ function update_script() {
    msg_info "Configuring LubeLogger"
    chmod 700 /opt/lubelogger/CarCareTracker
    cp -rf /tmp/lubeloggerData/* /opt/lubelogger/
+    rm -rf /tmp/lubeloggerData
    msg_ok "Configured LubeLogger"

    msg_info "Starting Service"
    systemctl start lubelogger
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /tmp/lubeloggerData
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/lyrionmusicserver.sh
+++ b/ct/lyrionmusicserver.sh
@ -38,15 +38,9 @@ function update_script() {
    curl -fsSL -o "$DEB_FILE" "$DEB_URL"
    $STD apt install "$DEB_FILE" -y
    systemctl restart lyrion
+    $STD rm -f "$DEB_FILE"
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated $APP to ${RELEASE}"
-
-    msg_info "Cleaning up"
-    $STD rm -f "$DEB_FILE"
-    $STD apt -y autoremove
-    $STD apt -y autoclean
-    $STD apt -y clean
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "$APP is already up to date (${RELEASE})"
--- a/ct/mealie.sh
+++ b/ct/mealie.sh
@ -8,7 +8,7 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 APP="Mealie"
 var_tags="${var_tags:-recipes}"
 var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-2048}"
+var_ram="${var_ram:-3072}"
 var_disk="${var_disk:-10}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
@ -30,53 +30,61 @@ function update_script() {
  fi
  if check_for_gh_release "mealie" "mealie-recipes/mealie"; then
    PYTHON_VERSION="3.12" setup_uv
-    NODE_MODULE="yarn" NODE_VERSION="20" setup_nodejs
+    NODE_MODULE="yarn" NODE_VERSION="24" setup_nodejs

    msg_info "Stopping Service"
    systemctl stop mealie
-    msg_info "Stopped Service"
+    msg_ok "Stopped Service"

-    msg_info "Backing up .env and start.sh"
-    cp -f /opt/mealie/mealie.env /opt/mealie/mealie.env.bak
-    cp -f /opt/mealie/start.sh /opt/mealie/start.sh.bak
+    msg_info "Backing up Configuration"
+    cp -f /opt/mealie/mealie.env /opt/mealie.env
    msg_ok "Backup completed"

-    fetch_and_deploy_gh_release "mealie" "mealie-recipes/mealie" "tarball" "latest" "/opt/mealie"
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "mealie" "mealie-recipes/mealie" "tarball" "latest" "/opt/mealie"

-    msg_info "Rebuilding Frontend"
+    msg_info "Installing Python Dependencies with uv"
+    cd /opt/mealie
+    $STD uv sync --frozen --extra pgsql
+    msg_ok "Installed Python Dependencies"
+
+    msg_info "Building Frontend"
+    MEALIE_VERSION=$(<$HOME/.mealie)
+    $STD sed -i "s|https://github.com/mealie-recipes/mealie/commit/|https://github.com/mealie-recipes/mealie/releases/tag/|g" /opt/mealie/frontend/pages/admin/site-settings.vue
+    $STD sed -i "s|value: data.buildId,|value: \"v${MEALIE_VERSION}\",|g" /opt/mealie/frontend/pages/admin/site-settings.vue
+    $STD sed -i "s|value: data.production ? i18n.t(\"about.production\") : i18n.t(\"about.development\"),|value: \"bare-metal\",|g" /opt/mealie/frontend/pages/admin/site-settings.vue
    export NUXT_TELEMETRY_DISABLED=1
    cd /opt/mealie/frontend
    $STD yarn install --prefer-offline --frozen-lockfile --non-interactive --production=false --network-timeout 1000000
    $STD yarn generate
-    cp -r /opt/mealie/frontend/dist /opt/mealie/mealie/frontend
-    msg_ok "Frontend rebuilt"
+    msg_ok "Built Frontend"

-    msg_info "Rebuilding Backend Environment"
+    msg_info "Copying Built Frontend"
+    mkdir -p /opt/mealie/mealie/frontend
+    cp -r /opt/mealie/frontend/dist/* /opt/mealie/mealie/frontend/
+    msg_ok "Copied Frontend"
+
+    msg_info "Updating NLTK Data"
+    mkdir -p /nltk_data/
    cd /opt/mealie
-    $STD /opt/mealie/.venv/bin/poetry self add "poetry-plugin-export>=1.9"
-    MEALIE_VERSION=$(/opt/mealie/.venv/bin/poetry version --short)
-    $STD /opt/mealie/.venv/bin/poetry build --output dist
-    $STD /opt/mealie/.venv/bin/poetry export --only=main --extras=pgsql --output=dist/requirements.txt
-    echo "mealie[pgsql]==$MEALIE_VERSION \\" >>dist/requirements.txt
-    /opt/mealie/.venv/bin/poetry run pip hash dist/mealie-$MEALIE_VERSION*.whl | tail -n1 | tr -d '\n' >>dist/requirements.txt
-    echo " \\" >>dist/requirements.txt
-    /opt/mealie/.venv/bin/poetry run pip hash dist/mealie-$MEALIE_VERSION*.tar.gz | tail -n1 >>dist/requirements.txt
-    msg_ok "Backend prepared"
-
-    msg_info "Finalize Installation"
-    $STD /opt/mealie/.venv/bin/uv pip install --require-hashes -r /opt/mealie/dist/requirements.txt --find-links dist
-    msg_ok "Mealie installed"
+    $STD uv run python -m nltk.downloader -d /nltk_data averaged_perceptron_tagger_eng
+    msg_ok "Updated NLTK Data"

    msg_info "Restoring Configuration"
-    mv -f /opt/mealie/mealie.env.bak /opt/mealie/mealie.env
-    mv -f /opt/mealie/start.sh.bak /opt/mealie/start.sh
+    mv -f /opt/mealie.env /opt/mealie/mealie.env
+    cat <<'STARTEOF' >/opt/mealie/start.sh
+#!/bin/bash
+set -a
+source /opt/mealie/mealie.env
+set +a
+exec uv run mealie
+STARTEOF
    chmod +x /opt/mealie/start.sh
    msg_ok "Configuration restored"

    msg_info "Starting Service"
    systemctl start mealie
    msg_ok "Started Service"
-    msg_ok "Update Successful"
+    msg_ok "Updated successfully"
  fi
  exit
 }
@ -89,3 +97,4 @@ msg_ok "Completed Successfully!\n"
 echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
 echo -e "${INFO}${YW} Access it using the following URL:${CL}"
 echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:9000${CL}"
+
--- a/ct/minio.sh
+++ b/ct/minio.sh
@ -55,17 +55,13 @@ function update_script() {
    mv /usr/local/bin/minio /usr/local/bin/minio_bak
    curl -fsSL "https://dl.min.io/server/minio/release/linux-amd64/minio" -o /usr/local/bin/minio
    chmod +x /usr/local/bin/minio
+    rm -f /usr/local/bin/minio_bak
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP}"

    msg_info "Starting Service"
    systemctl start minio
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -f /usr/local/bin/minio_bak
-    msg_ok "Cleaned"
-
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at ${RELEASE}"
--- a/ct/monica.sh
+++ b/ct/monica.sh
@ -52,15 +52,12 @@ function update_script() {
    $STD php artisan monica:update --force
    chown -R www-data:www-data /opt/monica
    chmod -R 775 /opt/monica/storage
+    rm -r /opt/monica-backup
    msg_ok "Configured monica"

    msg_info "Starting Service"
    systemctl start apache2
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -r /opt/monica-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/netbox.sh
+++ b/ct/netbox.sh
@ -57,17 +57,14 @@ function update_script() {
    fi

    $STD /opt/netbox/upgrade.sh
+    rm -r "/opt/v${RELEASE}.zip"
+    rm -r /opt/netbox-backup
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated $APP to v${RELEASE}"

    msg_info "Starting Service"
    systemctl start netbox netbox-rq
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -r "/opt/v${RELEASE}.zip"
-    rm -r /opt/netbox-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/netvisor.sh
+++ b/ct/netvisor.sh
@ -79,6 +79,9 @@ function update_script() {
      -e 's| --server-port |:|' \
      /etc/systemd/system/netvisor-daemon.service
    sed -i '/^  \"server_target.*$/d' /root/.config/daemon/config.json
+    if ! grep -q "WorkingD" /etc/systemd/system/netvisor-server.service; then
+      sed -i '\|simple$|a\WorkingDirectory=/opt/netvisor/backend' /etc/systemd/system/netvisor-server.service
+    fi
    systemctl daemon-reload

    msg_info "Starting services"
--- a/ct/nextpvr.sh
+++ b/ct/nextpvr.sh
@ -21,37 +21,34 @@ color
 catch_errors

 function update_script() {
-    header_info
-    check_container_storage
-    check_container_resources
-    if [[ ! -d /opt/nextpvr ]]; then
-        msg_error "No ${APP} Installation Found!"
-        exit
-    fi
-    msg_info "Stopping Service"
-    systemctl stop nextpvr-server
-    msg_ok "Stopped Service"
-
-    msg_info "Updating LXC packages"
-    $STD apt update
-    $STD apt -y upgrade
-    msg_ok "Updated LXC packages"
-
-    msg_info "Updating ${APP}"
-    cd /opt
-    curl -fsSL "https://nextpvr.com/nextpvr-helper.deb" -o $(basename "https://nextpvr.com/nextpvr-helper.deb")
-    $STD dpkg -i nextpvr-helper.deb
-    msg_ok "Updated ${APP}"
-
-    msg_info "Starting Service"
-    systemctl start nextpvr-server
-    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/nextpvr-helper.deb
-    msg_ok "Cleaned"
-    msg_ok "Updated successfully!"
+  header_info
+  check_container_storage
+  check_container_resources
+  if [[ ! -d /opt/nextpvr ]]; then
+    msg_error "No ${APP} Installation Found!"
    exit
+  fi
+  msg_info "Stopping Service"
+  systemctl stop nextpvr-server
+  msg_ok "Stopped Service"
+
+  msg_info "Updating LXC packages"
+  $STD apt update
+  $STD apt -y upgrade
+  msg_ok "Updated LXC packages"
+
+  msg_info "Updating ${APP}"
+  cd /opt
+  curl -fsSL "https://nextpvr.com/nextpvr-helper.deb" -o $(basename "https://nextpvr.com/nextpvr-helper.deb")
+  $STD dpkg -i nextpvr-helper.deb
+  rm -rf /opt/nextpvr-helper.deb
+  msg_ok "Updated ${APP}"
+
+  msg_info "Starting Service"
+  systemctl start nextpvr-server
+  msg_ok "Started Service"
+  msg_ok "Updated successfully!"
+  exit
 }

 start
--- a/ct/nxwitness.sh
+++ b/ct/nxwitness.sh
@ -42,17 +42,13 @@ function update_script() {
    export DEBIAN_FRONTEND=noninteractive
    export DEBCONF_NOWARNINGS=yes
    $STD dpkg -i nxwitness-server-$RELEASE-linux_x64.deb
+    rm -f /tmp/nxwitness-server-$RELEASE-linux_x64.deb
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP}"

    msg_info "Starting Service"
    systemctl start networkoptix-root-tool networkoptix-mediaserver
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -f /tmp/nxwitness-server-$RELEASE-linux_x64.deb
-    msg_ok "Cleaned"
-
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at ${RELEASE}"
--- a/ct/odoo.sh
+++ b/ct/odoo.sh
@ -50,17 +50,13 @@ function update_script() {
    msg_info "Updating ${APP} to ${LATEST_VERSION}"
    curl -fsSL https://nightly.odoo.com/${RELEASE}/nightly/deb/odoo_${RELEASE}.latest_all.deb -o /opt/odoo.deb
    $STD apt install -y /opt/odoo.deb
+    rm -f /opt/odoo.deb
    echo "$LATEST_VERSION" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP} to ${LATEST_VERSION}"

-    msg_info "Starting ${APP} service"
+    msg_info "Starting Service"
    systemctl start odoo
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -f /opt/odoo.deb
-    msg_ok "Cleaned"
-
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at ${LATEST_VERSION}"
--- a/ct/ollama.sh
+++ b/ct/ollama.sh
@ -43,16 +43,13 @@ function update_script() {
    mkdir -p /usr/local/lib/ollama
    tar -xzf "${TMP_TAR}" -C /usr/local/lib/ollama
    ln -sf /usr/local/lib/ollama/bin/ollama /usr/local/bin/ollama
+    rm -f "${TMP_TAR}"
    echo "${RELEASE}" >/opt/Ollama_version.txt
    msg_ok "Updated Ollama to ${RELEASE}"

    msg_info "Starting Services"
    systemctl start ollama
    msg_ok "Started Services"
-
-    msg_info "Cleaning Up"
-    rm -f "${TMP_TAR}"
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. Ollama is already at ${RELEASE}"
--- a/ct/omada.sh
+++ b/ct/omada.sh
@ -30,7 +30,7 @@ function update_script() {

  msg_info "Updating MongoDB"
  if lscpu | grep -q 'avx'; then
-    MONGO_VERSION="8.0" setup_mongodb
+    MONGO_VERSION="8.0"
  else
    msg_error "No AVX detected (CPU-Flag)! We have discontinued support for this. You are welcome to try it manually with a Debian LXC, but due to the many issues with Omada, we currently only support AVX CPUs."
    exit 10
--- a/ct/onedev.sh
+++ b/ct/onedev.sh
@ -39,17 +39,14 @@ function update_script() {
    tar -xzf onedev-latest.tar.gz
    $STD /opt/onedev-latest/bin/upgrade.sh /opt/onedev
    RELEASE=$(cat /opt/onedev/release.properties | grep "version" | cut -d'=' -f2)
+    rm -rf /opt/onedev-latest
+    rm -rf /opt/onedev-latest.tar.gz
    echo "${RELEASE}" >"/opt/${APP}_version.txt"
    msg_ok "Updated ${APP} to v${RELEASE}"

    msg_info "Starting Service"
    systemctl start onedev
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/onedev-latest
-    rm -rf /opt/onedev-latest.tar.gz
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}."
--- a/ct/openwebui.sh
+++ b/ct/openwebui.sh
@ -33,6 +33,7 @@ function update_script() {
    msg_info "Creating Backup"
    mkdir -p /opt/open-webui-backup
    cp -a /opt/open-webui/backend/data /opt/open-webui-backup/data || true
+    cp -a /opt/open-webui/.env /opt/open-webui-backup/.env || true
    msg_ok "Created Backup"

    msg_info "Removing legacy installation"
@ -48,6 +49,7 @@ function update_script() {
    msg_info "Restoring data"
    mkdir -p /root/.open-webui
    cp -a /opt/open-webui-backup/data/* /root/.open-webui/ || true
+    cp -a /opt/open-webui-backup/.env /root/.env || true
    rm -rf /opt/open-webui-backup || true
    msg_ok "Restored data"

@ -108,7 +110,7 @@ EOF

  msg_info "Updating Open WebUI via uv"
  PYTHON_VERSION="3.12" setup_uv
-  $STD uv tool install --python 3.12 open-webui[all]
+  $STD uv tool upgrade --python 3.12 open-webui[all]
  systemctl restart open-webui
  msg_ok "Updated Open WebUI"
  msg_ok "Updated successfully!"
--- a/ct/paperless-ai.sh
+++ b/ct/paperless-ai.sh
@ -27,61 +27,33 @@ function update_script() {
    msg_error "No ${APP} Installation Found!"
    exit
  fi
-  if ! dpkg -s python3-pip >/dev/null 2>&1; then
-    $STD apt install -y python3-pip
-  fi
-  RELEASE=$(curl -fsSL https://api.github.com/repos/clusterzx/paperless-ai/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
-  if [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]] || [[ ! -f /opt/${APP}_version.txt ]]; then
+
+  if check_for_gh_release "paperless-ai" "clusterzx/paperless-ai"; then
    msg_info "Stopping Service"
-    systemctl stop paperless-ai
-    msg_info "Stopped Service"
+    systemctl stop paperless-ai paperless-rag
+    msg_ok "Stopped Service"

-    msg_info "Updating $APP to v${RELEASE}"
-    cd /opt
-    mv /opt/paperless-ai /opt/paperless-ai_bak
-    curl -fsSL "https://github.com/clusterzx/paperless-ai/archive/refs/tags/v${RELEASE}.zip" -o $(basename "https://github.com/clusterzx/paperless-ai/archive/refs/tags/v${RELEASE}.zip")
-    $STD unzip v${RELEASE}.zip
-    mv paperless-ai-${RELEASE} /opt/paperless-ai
-    mkdir -p /opt/paperless-ai/data
-    cp -a /opt/paperless-ai_bak/data/. /opt/paperless-ai/data/
+    fetch_and_deploy_gh_release "paperless-ai" "clusterzx/paperless-ai"
+
+    msg_info "Updating Paperless-AI"
    cd /opt/paperless-ai
-    if [[ ! -f /etc/systemd/system/paperless-rag.service ]]; then
-      cat <<EOF >/etc/systemd/system/paperless-rag.service
-[Unit]
-Description=PaperlessAI-RAG Service
-After=network.target
-
-[Service]
-WorkingDirectory=/opt/paperless-ai
-ExecStart=/usr/bin/python3 main.py --host 0.0.0.0 --port 8000 --initialize
-Restart=always
-
-[Install]
-WantedBy=multi-user.target
-EOF
-      echo "RAG_SERVICE_URL=http://localhost:8000" >>/opt/paperless-ai/data/.env
-      echo "RAG_SERVICE_ENABLED=true" >>/opt/paperless-ai/data/.env
-    fi
+    source /opt/paperless-ai/venv/bin/activate
+    $STD pip install --upgrade pip
    $STD pip install --no-cache-dir -r requirements.txt
    mkdir -p data/chromadb
-    $STD npm install
-    echo "${RELEASE}" >/opt/${APP}_version.txt
-    msg_ok "Updated $APP to v${RELEASE}"
+    $STD npm ci --only=production
+    msg_ok "Updated Paperless-AI"

    msg_info "Starting Service"
+    systemctl start paperless-rag
+    sleep 3
    systemctl start paperless-ai
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/v${RELEASE}.zip
-    rm -rf /opt/paperless-ai_bak
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
-  else
-    msg_ok "No update required. ${APP} is already at v${RELEASE}"
  fi
  exit
 }
+
 start
 build_container
 description
--- a/ct/paperless-gpt.sh
+++ b/ct/paperless-gpt.sh
@ -20,48 +20,45 @@ color
 catch_errors

 function update_script() {
-    header_info
-    check_container_storage
-    check_container_resources
-    if [[ ! -d /opt/paperless-gpt ]]; then
-        msg_error "No Paperless-GPT installation found!"
-        exit
-    fi
-    RELEASE=$(curl -fsSL https://api.github.com/repos/icereed/paperless-gpt/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
-    if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
-        msg_info "Stopping Service"
-        systemctl stop paperless-gpt
-        msg_ok "Service Stopped"
-
-        msg_info "Updating Paperless-GPT to ${RELEASE}"
-        temp_file=$(mktemp)
-        curl -fsSL "https://github.com/icereed/paperless-gpt/archive/refs/tags/v${RELEASE}.tar.gz" -o "$temp_file"
-        tar zxf $temp_file
-        rm -rf /opt/paperless-gpt
-        mv paperless-gpt-${RELEASE} /opt/paperless-gpt
-        cd /opt/paperless-gpt/web-app
-        $STD npm install
-        $STD npm run build
-        cd /opt/paperless-gpt
-        go mod download
-        export CC=musl-gcc
-        CGO_ENABLED=1 go build -tags musl -o /dev/null github.com/mattn/go-sqlite3
-        CGO_ENABLED=1 go build -tags musl -o paperless-gpt .
-        echo "${RELEASE}" >"/opt/paperless-gpt_version.txt"
-        msg_ok "Updated Paperless-GPT to ${RELEASE}"
-
-        msg_info "Starting Service"
-        systemctl start paperless-gpt
-        msg_ok "Started Service"
-
-        msg_info "Cleaning Up"
-        rm -f $temp_file
-        msg_ok "Cleanup Completed"
-        msg_ok "Updated successfully!"
-    else
-        msg_ok "No update required. ${APP} is already at ${RELEASE}"
-    fi
+  header_info
+  check_container_storage
+  check_container_resources
+  if [[ ! -d /opt/paperless-gpt ]]; then
+    msg_error "No Paperless-GPT installation found!"
    exit
+  fi
+  RELEASE=$(curl -fsSL https://api.github.com/repos/icereed/paperless-gpt/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
+  if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
+    msg_info "Stopping Service"
+    systemctl stop paperless-gpt
+    msg_ok "Service Stopped"
+
+    msg_info "Updating Paperless-GPT to ${RELEASE}"
+    temp_file=$(mktemp)
+    curl -fsSL "https://github.com/icereed/paperless-gpt/archive/refs/tags/v${RELEASE}.tar.gz" -o "$temp_file"
+    tar zxf $temp_file
+    rm -rf /opt/paperless-gpt
+    mv paperless-gpt-${RELEASE} /opt/paperless-gpt
+    cd /opt/paperless-gpt/web-app
+    $STD npm install
+    $STD npm run build
+    cd /opt/paperless-gpt
+    go mod download
+    export CC=musl-gcc
+    CGO_ENABLED=1 go build -tags musl -o /dev/null github.com/mattn/go-sqlite3
+    CGO_ENABLED=1 go build -tags musl -o paperless-gpt .
+    rm -f $temp_file
+    echo "${RELEASE}" >"/opt/paperless-gpt_version.txt"
+    msg_ok "Updated Paperless-GPT to ${RELEASE}"
+
+    msg_info "Starting Service"
+    systemctl start paperless-gpt
+    msg_ok "Started Service"
+    msg_ok "Updated successfully!"
+  else
+    msg_ok "No update required. ${APP} is already at ${RELEASE}"
+  fi
+  exit
 }

 start
--- a/ct/paperless-ngx.sh
+++ b/ct/paperless-ngx.sh
@ -105,6 +105,7 @@ function update_script() {
      msg_ok "Backup completed to $BACKUP_DIR"

      declare -A PATCHES=(
+        ["paperless-consumer.service"]="ExecStart=uv run -- python manage.py document_consumer"
        ["paperless-scheduler.service"]="ExecStart=uv run -- celery --app paperless beat --loglevel INFO"
        ["paperless-task-queue.service"]="ExecStart=uv run -- celery --app paperless worker --loglevel INFO"
        ["paperless-webserver.service"]="ExecStart=uv run -- granian --interface asgi --ws \"paperless.asgi:application\""
--- a/ct/part-db.sh
+++ b/ct/part-db.sh
@ -52,17 +52,14 @@ function update_script() {
    $STD php bin/console cache:clear
    $STD php bin/console doctrine:migrations:migrate -n
    chown -R www-data:www-data /opt/partdb
+    rm -r "/opt/v${RELEASE}.zip"
+    rm -r /opt/partdb-backup
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated $APP to v${RELEASE}"

    msg_info "Starting Service"
    systemctl start apache2
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -r "/opt/v${RELEASE}.zip"
-    rm -r /opt/partdb-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/pelican-panel.sh
+++ b/ct/pelican-panel.sh
@ -67,6 +67,7 @@ function update_script() {
    $STD php artisan migrate --seed --force
    chown -R www-data:www-data /opt/pelican-panel
    chmod -R 755 /opt/pelican-panel/storage /opt/pelican-panel/bootstrap/cache/
+    rm -rf "/opt/pelican-panel/panel.tar.gz"
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated $APP to v${RELEASE}"

@ -74,10 +75,6 @@ function update_script() {
    $STD php artisan queue:restart
    $STD php artisan up
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf "/opt/pelican-panel/panel.tar.gz"
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/pterodactyl-panel.sh
+++ b/ct/pterodactyl-panel.sh
@ -70,6 +70,7 @@ EOF
    $STD php artisan migrate --seed --force --no-interaction
    chown -R www-data:www-data /opt/pterodactyl-panel/*
    chmod -R 755 /opt/pterodactyl-panel/storage /opt/pterodactyl-panel/bootstrap/cache/
+    rm -rf "/opt/pterodactyl-panel/panel.tar.gz"
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated $APP to v${RELEASE}"

@ -77,10 +78,6 @@ EOF
    $STD php artisan queue:restart
    $STD php artisan up
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf "/opt/pterodactyl-panel/panel.tar.gz"
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/pve-scripts-local.sh
+++ b/ct/pve-scripts-local.sh
@ -27,42 +27,9 @@ function update_script() {
    msg_error "No ${APP} Installation Found!"
    exit
  fi
-
-  if check_for_gh_release "ProxmoxVE-Local" "community-scripts/ProxmoxVE-Local"; then
-    msg_info "Stopping Services"
-    systemctl stop pvescriptslocal
-    msg_ok "Stopped Services"
-
-    msg_info "Backup Data"
-    cp /opt/ProxmoxVE-Local/.env /opt/.env.bak
-    cp -r /opt/ProxmoxVE-Local/data /opt/data.bak
-    msg_ok "Backed up Data"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "ProxmoxVE-Local" "community-scripts/ProxmoxVE-Local"
-
-    msg_info "Restoring Data"
-    if [[ -f /opt/.env.bak ]]; then
-      mv /opt/.env.bak /opt/ProxmoxVE-Local/.env
-    fi
-    if [[ -d /opt/data.bak ]]; then
-      rm -rf /opt/ProxmoxVE-Local/data
-      mv /opt/data.bak /opt/ProxmoxVE-Local/data
-    fi
-    msg_ok "Restored Data"
-
-    msg_info "Updating PVE Scripts local"
-    cd /opt/ProxmoxVE-Local
-    chmod 755 data
-    $STD npm install
-    $STD npm run build
-    msg_ok "Updated PVE Scripts local"
-
-    msg_info "Starting Services"
-    systemctl start pvescriptslocal
-    msg_ok "Started Services"
-    msg_ok "Updated successfully!"
-  fi
-  exit
+  
+  msg_custom "🚀" "${GN}" "The app offers a built-in updater. Please use it."
+  
 }

 start
--- a/ct/qdrant.sh
+++ b/ct/qdrant.sh
@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/qdrant/qdrant
+
+APP="Qdrant"
+var_tags="${var_tags:-database;vector}"
+var_cpu="${var_cpu:-1}"
+var_ram="${var_ram:-1024}"
+var_disk="${var_disk:-5}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+  if [[ ! -d /var/lib/qdrant ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+  if check_for_gh_release "qdrant" "qdrant/qdrant"; then
+    fetch_and_deploy_gh_release "qdrant" "qdrant/qdrant" "binary" "latest" "/usr/bin/qdrant"
+    chown -R root:root /var/lib/qdrant
+    chmod -R 755 /var/lib/qdrant
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:6333/dashboard${CL}"
--- a/ct/rdtclient.sh
+++ b/ct/rdtclient.sh
@ -43,14 +43,11 @@ function update_script() {
      $STD apt remove --purge -y dotnet-sdk-8.0
      $STD apt install -y dotnet-sdk-9.0
    fi
+    rm -rf /opt/rdtc-backup

    msg_info "Starting Service"
    systemctl start rdtc
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/rdtc-backup
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/reactive-resume.sh
+++ b/ct/reactive-resume.sh
@ -54,6 +54,7 @@ function update_script() {
    cd /tmp
    curl -fsSL https://dl.min.io/server/minio/release/linux-amd64/minio.deb -o minio.deb
    $STD dpkg -i minio.deb
+    rm -f /tmp/minio.deb
    msg_ok "Updated Minio"

    msg_info "Updating Browserless (Patience)"
@ -75,16 +76,12 @@ function update_script() {
    $STD npm run build:function
    $STD npm prune production
    mv /opt/browserless.env /opt/browserless/.env
+    rm -f "$brwsr_tmp"
    msg_ok "Updated Browserless"

    msg_info "Restarting services"
    systemctl start minio Reactive-Resume browserless
    msg_ok "Restarted services"
-
-    msg_info "Cleaning Up"
-    rm -f /tmp/minio.deb
-    rm -f "$brwsr_tmp"
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/recyclarr.sh
+++ b/ct/recyclarr.sh
@ -29,15 +29,10 @@ function update_script() {
  fi
  if check_for_gh_release "recyclarr" "recyclarr/recyclarr"; then

-    msg_info "Stopping Service"
-    systemctl stop recyclarr
-    msg_ok "Stopped Service"
+    msg_info "Updating ${APP}"

    fetch_and_deploy_gh_release "recyclarr" "recyclarr/recyclarr" "prebuild" "latest" "/usr/local/bin" "recyclarr-linux-x64.tar.xz"

-    msg_info "Starting Service"
-    systemctl start recyclarr
-    msg_ok "Started Service"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/revealjs.sh
+++ b/ct/revealjs.sh
@ -41,15 +41,12 @@ function update_script() {
    $STD npm install
    cp -f /opt/index.html /opt/revealjs
    sed -i '25s/localhost/0.0.0.0/g' /opt/revealjs/gulpfile.js
+    rm -f /opt/index.html
    msg_ok "Updated $APP"

    msg_info "Starting Service"
    systemctl start revealjs
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -f /opt/index.html
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/slskd.sh
+++ b/ct/slskd.sh
@ -61,15 +61,12 @@ function update_script() {
  $STD pip install -r requirements.txt
  mv /opt/config.ini.bak /opt/soularr/config.ini
  mv /opt/run.sh.bak /opt/soularr/run.sh
+  rm -rf /tmp/main.zip
  msg_ok "Updated soularr"

  msg_info "Starting soularr timer"
  systemctl start soularr.timer
  msg_ok "Started soularr timer"
-
-  msg_info "Cleaning Up"
-  rm -rf /tmp/main.zip
-  msg_ok "Cleanup Completed"
  exit
 }

--- a/ct/snipeit.sh
+++ b/ct/snipeit.sh
@ -31,7 +31,7 @@ function update_script() {
    sed -i '/index index.php;/i \        client_max_body_size 100M;' /etc/nginx/conf.d/snipeit.conf
  fi

-  if check_for_gh_release "snipe-it" "snipe/snipe-it"; then
+  if check_for_gh_release "snipe-it" "grokability/snipe-it"; then
    msg_info "Stopping Services"
    systemctl stop nginx
    msg_ok "Services Stopped"
@ -40,7 +40,7 @@ function update_script() {
    mv /opt/snipe-it /opt/snipe-it-backup
    msg_ok "Backup created"

-    fetch_and_deploy_gh_release "snipe-it" "snipe/snipe-it" "tarball"
+    fetch_and_deploy_gh_release "snipe-it" "grokability/snipe-it" "tarball"
    [[ "$(php -v 2>/dev/null)" == PHP\ 8.2* ]] && PHP_VERSION="8.3" PHP_MODULE="common,ctype,ldap,fileinfo,iconv,mysql,soap,xsl" PHP_FPM="YES" setup_php
    sed -i 's/php8.2/php8.3/g' /etc/nginx/conf.d/snipeit.conf
    setup_composer
--- a/ct/snowshare.sh
+++ b/ct/snowshare.sh
@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: TuroYT
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/TuroYT/snowshare
+
+APP="SnowShare"
+var_tags="${var_tags:-file-sharing}"
+var_cpu="${var_cpu:-1}"
+var_ram="${var_ram:-1024}"
+var_disk="${var_disk:-5}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+  if [[ ! -d /opt/snowshare ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_release "snowshare" "TuroYT/snowshare"; then
+    msg_info "Stopping Service"
+    systemctl stop snowshare
+    msg_ok "Stopped Service"
+
+    fetch_and_deploy_gh_release "snowshare" "TuroYT/snowshare"
+
+    msg_info "Updating Snowshare"
+    cd /opt/snowshare
+    $STD npm ci
+    $STD npx prisma generate
+    $STD npm run build
+    msg_ok "Updated Snowshare"
+
+    msg_info "Starting Service"
+    systemctl start snowshare
+    msg_ok "Started Service"
+    msg_ok "Updated successfully!"
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3000${CL}"
--- a/ct/spoolman.sh
+++ b/ct/spoolman.sh
@ -43,17 +43,13 @@ function update_script() {
    cd spoolman
    $STD pip3 install -r requirements.txt
    curl -fsSL "https://raw.githubusercontent.com/Donkie/Spoolman/master/.env.example" -o ".env"
+    rm -rf /opt/spoolman.zip
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP} to ${RELEASE}"

    msg_info "Starting Service"
    systemctl start spoolman
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/spoolman.zip
-    msg_ok "Cleaned"
-
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at ${RELEASE}"
--- a/ct/tandoor.sh
+++ b/ct/tandoor.sh
@ -64,16 +64,13 @@ EOF
    cd /opt/tandoor
    $STD /opt/tandoor/.venv/bin/python manage.py migrate
    $STD /opt/tandoor/.venv/bin/python manage.py collectstatic --no-input
+    rm -rf /opt/tandoor.bak
    msg_ok "Updated Trandoor"

    msg_info "Starting Service"
    systemctl start tandoor
    systemctl reload nginx
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/tandoor.bak
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/tasmocompiler.sh
+++ b/ct/tasmocompiler.sh
@ -45,16 +45,13 @@ function update_script() {
    export NODE_OPTIONS=--openssl-legacy-provider
    $STD npm i
    $STD yarn build
+    rm -r "/opt/v${RELEASE}.tar.gz"
+    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated TasmoCompiler"

    msg_info "Starting Service"
    systemctl start tasmocompiler
    msg_ok "Started Service"
-
-    echo "${RELEASE}" >/opt/${APP}_version.txt
-    msg_info "Cleaning up"
-    rm -r "/opt/v${RELEASE}.tar.gz"
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/tdarr.sh
+++ b/ct/tdarr.sh
@ -37,11 +37,8 @@ function update_script() {
  $STD unzip Tdarr_Updater.zip
  chmod +x Tdarr_Updater
  $STD ./Tdarr_Updater
-  msg_ok "Updated Tdarr"
-
-  msg_info "Cleaning up"
  rm -rf /opt/tdarr/Tdarr_Updater.zip
-  msg_ok "Cleaned up"
+  msg_ok "Updated Tdarr"
  msg_ok "Updated successfully!"
  exit
 }
--- a/ct/technitiumdns.sh
+++ b/ct/technitiumdns.sh
@ -38,11 +38,8 @@ function update_script() {
    msg_info "Updating Technitium DNS"
    curl -fsSL "https://download.technitium.com/dns/DnsServerPortable.tar.gz" -o /opt/DnsServerPortable.tar.gz
    $STD tar zxvf /opt/DnsServerPortable.tar.gz -C /opt/technitium/dns/
-    msg_ok "Updated Technitium DNS"
-
-    msg_info "Cleaning up"
    rm -f /opt/DnsServerPortable.tar.gz
-    msg_ok "Cleaned up"
+    msg_ok "Updated Technitium DNS"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required.  Technitium DNS is already at v${RELEASE}."
--- a/ct/teddycloud.sh
+++ b/ct/teddycloud.sh
@ -41,15 +41,12 @@ function update_script() {

    msg_info "Restoring data"
    cp -R /opt/teddycloud_bak/certs /opt/teddycloud_bak/config /opt/teddycloud_bak/data /opt/teddycloud
+    rm -rf /opt/teddycloud_bak
    msg_ok "Data restored"

    msg_info "Starting Service"
    systemctl start teddycloud
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/teddycloud_bak
-    msg_ok "Cleaned up"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/tianji.sh
+++ b/ct/tianji.sh
@ -43,7 +43,7 @@ function update_script() {

    fetch_and_deploy_gh_release "tianji" "msgbyte/tianji"

-    msg_info "Updating ${APP}"
+    msg_info "Updating Tianji"
    cd /opt/tianji
    export NODE_OPTIONS="--max_old_space_size=4096"
    $STD pnpm install --filter @tianji/client... --config.dedupe-peer-dependents=false --frozen-lockfile
@ -55,7 +55,11 @@ function update_script() {
    mv /opt/.env /opt/tianji/src/server/.env
    cd src/server
    $STD pnpm db:migrate:apply
-    msg_ok "Updated ${APP}"
+    rm -rf /opt/tianji_bak
+    rm -rf /opt/tianji/src/client
+    rm -rf /opt/tianji/website
+    rm -rf /opt/tianji/reporter
+    msg_ok "Updated Tianji"

    msg_info "Updating AppRise"
    $STD uv pip install apprise cryptography --system
@ -64,13 +68,6 @@ function update_script() {
    msg_info "Starting Service"
    systemctl start tianji
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/tianji_bak
-    rm -rf /opt/tianji/src/client
-    rm -rf /opt/tianji/website
-    rm -rf /opt/tianji/reporter
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/traccar.sh
+++ b/ct/traccar.sh
@ -50,18 +50,12 @@ function update_script() {
    mv /opt/traccar.xml /opt/traccar/conf
    [[ -d /opt/data ]] && mv /opt/data /opt/traccar
    [[ -d /opt/media ]] && mv /opt/media /opt/traccar
+    [ -f README.txt ] || [ -f traccar.run ] && rm -f README.txt traccar.run
    msg_ok "Data restored"

    msg_info "Starting Service"
    systemctl start traccar
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    [ -f README.txt ] || [ -f traccar.run ] && rm -f README.txt traccar.run
-    $STD apt -y autoremove
-    $STD apt -y autoclean
-    $STD apt -y clean
-    msg_ok "Cleaned up"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/tracktor.sh
+++ b/ct/tracktor.sh
@ -65,7 +65,7 @@ EOF
    fi
    msg_ok "Corrected Services"

-    setup_nodejs
+    NODE_VERSION="22" setup_nodejs
    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "tracktor" "javedh-dev/tracktor" "tarball" "latest" "/opt/tracktor"

    msg_info "Updating tracktor"
--- a/ct/trilium.sh
+++ b/ct/trilium.sh
@ -55,14 +55,8 @@ function update_script() {
    msg_info "Restoring Database"
    mkdir -p "$(dirname "${DB_RESTORE_PATH}")"
    cp -r /opt/trilium_backup/$(basename "${DB_PATH}") "${DB_RESTORE_PATH}"
-    msg_ok "Restored Database"
-
-    msg_info "Cleaning up"
    rm -rf /opt/trilium_backup
-    $STD apt -y autoremove
-    $STD apt -y autoclean
-    $STD apt -y clean
-    msg_ok "Cleaned"
+    msg_ok "Restored Database"

    msg_info "Starting Service"
    systemctl start trilium
--- a/ct/uhf.sh
+++ b/ct/uhf.sh
@ -43,12 +43,6 @@ function update_script() {
    msg_info "Starting Service"
    systemctl start uhf-server
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    $STD apt -y autoremove
-    $STD apt -y autoclean
-    $STD apt -y clean
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/upgopher.sh
+++ b/ct/upgopher.sh
@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: Eduard González (wanetty)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/wanetty/upgopher
+
+APP="Upgopher"
+var_tags="${var_tags:-file-sharing}"
+var_cpu="${var_cpu:-1}"
+var_ram="${var_ram:-512}"
+var_disk="${var_disk:-4}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+    header_info
+    check_container_storage
+    check_container_resources
+    if [[ ! -d /opt/upgopher ]]; then
+        msg_error "No ${APP} Installation Found!"
+        exit
+    fi
+
+    if check_for_gh_release "upgopher" "wanetty/upgopher"; then
+        msg_info "Stopping Service"
+        systemctl stop upgopher
+        msg_ok "Stopped Service"
+
+        fetch_and_deploy_gh_release "upgopher" "wanetty/upgopher" "prebuild" "latest" "/opt/upgopher" "upgopher_*_linux_amd64.tar.gz"
+        chmod +x /opt/upgopher/upgopher
+
+        msg_info "Starting Service"
+        systemctl start upgopher
+        msg_ok "Started Service"
+        msg_ok "Updated successfully!"
+    fi
+    exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:9090${CL}"
--- a/ct/valkey.sh
+++ b/ct/valkey.sh
@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: pshankinclarke (lazarillo)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://valkey.io/
+
+APP="Valkey"
+var_tags="${var_tags:-database}"
+var_cpu="${var_cpu:-1}"
+var_ram="${var_ram:-1024}"
+var_disk="${var_disk:-4}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+    header_info
+    check_container_storage
+    check_container_resources
+    if [[ ! -f /lib/systemd/system/valkey-server.service ]]; then
+        msg_error "No Valkey Installation Found!"
+        exit
+    fi
+    msg_info "Updating Valkey LXC"
+    $STD apt update
+    $STD apt -y upgrade
+    msg_ok "Updated Valkey LXC"
+    msg_ok "Updated successfully!"
+    exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:6379${CL}"
--- a/ct/vaultwarden.sh
+++ b/ct/vaultwarden.sh
@ -57,11 +57,8 @@ function update_script() {
    else
      cp target/release/vaultwarden /opt/vaultwarden/bin/
    fi
-    msg_ok "Updated VaultWarden"
-
-    msg_info "Cleaning up"
    cd ~ && rm -rf vaultwarden
-    msg_ok "Cleaned"
+    msg_ok "Updated VaultWarden"

    msg_info "Starting Service"
    systemctl start vaultwarden
@ -77,11 +74,8 @@ function update_script() {
    msg_info "Updating Web-Vault to $WVRELEASE"
    $STD curl -fsSLO https://github.com/dani-garcia/bw_web_builds/releases/download/"$WVRELEASE"/bw_web_"$WVRELEASE".tar.gz
    $STD tar -zxf bw_web_"$WVRELEASE".tar.gz -C /opt/vaultwarden/
-    msg_ok "Updated Web-Vault"
-
-    msg_info "Cleaning up"
    rm bw_web_"$WVRELEASE".tar.gz
-    msg_ok "Cleaned"
+    msg_ok "Updated Web-Vault"

    msg_info "Starting Service"
    systemctl start vaultwarden
--- a/ct/vikunja.sh
+++ b/ct/vikunja.sh
@ -39,16 +39,13 @@ function update_script() {
    curl -fsSL "https://dl.vikunja.io/vikunja/$RELEASE/vikunja-$RELEASE-amd64.deb" -o $(basename "https://dl.vikunja.io/vikunja/$RELEASE/vikunja-$RELEASE-amd64.deb")
    export DEBIAN_FRONTEND=noninteractive
    $STD dpkg -i vikunja-"$RELEASE"-amd64.deb
+    rm -rf /opt/vikunja-"$RELEASE"-amd64.deb
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated ${APP}"

    msg_info "Starting Service"
    systemctl start vikunja
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/vikunja-"$RELEASE"-amd64.deb
-    msg_ok "Cleaned"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at ${RELEASE}"
--- a/ct/wanderer.sh
+++ b/ct/wanderer.sh
@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: rrole
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://wanderer.to
+
+APP="Wanderer"
+var_tags="${var_tags:-travelling;sport}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-4096}"
+var_disk="${var_disk:-8}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+    header_info
+    check_container_storage
+    check_container_resources
+
+    if [[ ! -f /opt/wanderer/start.sh ]]; then
+        msg_error "No wanderer Installation Found!"
+        exit
+    fi
+
+    if check_for_gh_release "wanderer" "Flomp/wanderer"; then
+        msg_info "Stopping service"
+        systemctl stop wanderer-web
+        msg_ok "Stopped service"
+        
+				fetch_and_deploy_gh_release "wanderer" "Flomp/wanderer"  "tarball" "latest" "/opt/wanderer/source"
+				
+        msg_info "Updating wanderer"
+        cd /opt/wanderer/source/db
+        $STD go mod tidy
+       	$STD go build
+        cd /opt/wanderer/source/web
+        $STD npm ci --omit=dev
+        $STD npm run build
+        msg_ok "Updated wanderer"
+
+        msg_info "Starting service"
+        systemctl start wanderer-web
+        msg_ok "Started service"
+        msg_ok "Update Successful"
+    fi
+    if check_for_gh_release "meilisearch" "meilisearch/meilisearch"; then
+        msg_info "Stopping service"
+        systemctl stop wanderer-web
+        msg_ok "Stopped service"
+
+    		fetch_and_deploy_gh_release "meilisearch" "meilisearch/meilisearch" "binary" "latest" "/opt/wanderer/source/search"
+
+        msg_info "Starting service"
+        systemctl start wanderer-web
+        msg_ok "Started service"
+        msg_ok "Update Successful"
+    fi
+    exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3000${CL}"
--- a/ct/wastebin.sh
+++ b/ct/wastebin.sh
@ -73,16 +73,13 @@ EOF
    cp -f wastebin* /opt/wastebin/
    chmod +x /opt/wastebin/wastebin
    chmod +x /opt/wastebin/wastebin-ctl
+    rm -f "$temp_file"
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated Wastebin"

    msg_info "Starting Wastebin"
    systemctl start wastebin
    msg_ok "Started Wastebin"
-
-    msg_info "Cleaning Up"
-    rm -f "$temp_file"
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/watchyourlan.sh
+++ b/ct/watchyourlan.sh
@ -37,10 +37,7 @@ function update_script() {
    fetch_and_deploy_gh_release "watchyourlan" "aceberg/WatchYourLAN" "binary"
    cp -R config.yaml /data/config.yaml
    sed -i 's|/etc/watchyourlan/config.yaml|/data/config.yaml|' /lib/systemd/system/watchyourlan.service
-
-    msg_info "Cleaning up"
    rm ~/config.yaml
-    msg_ok "Cleaned up"

    msg_info "Starting service"
    systemctl enable -q --now watchyourlan
--- a/ct/wger.sh
+++ b/ct/wger.sh
@ -45,16 +45,13 @@ function update_script() {
    $STD python3 manage.py collectstatic --no-input
    $STD yarn install
    $STD yarn build:css:sass
+    rm -rf "$temp_file"
    echo "${RELEASE}" >/opt/${APP}_version.txt
    msg_ok "Updated $APP to v${RELEASE}"

    msg_info "Starting Service"
    systemctl start wger
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf "$temp_file"
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  else
    msg_ok "No update required. ${APP} is already at v${RELEASE}"
--- a/ct/wikijs.sh
+++ b/ct/wikijs.sh
@ -54,15 +54,12 @@ function update_script() {
    msg_info "Restoring Data"
    cp -R /opt/wikijs-backup/* /opt/wikijs
    $SQLITE_INSTALL && $STD npm rebuild sqlite3
+    rm -rf /opt/wikijs-backup
    msg_ok "Restored Data"

    msg_info "Starting Service"
    systemctl start wikijs
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/wikijs-backup
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/wizarr.sh
+++ b/ct/wizarr.sh
@ -52,19 +52,26 @@ function update_script() {
    $STD npm --prefix app/static run build:css
    mkdir -p ./.cache
    $STD tar -xf "$BACKUP_FILE" --directory=/
-    $STD /usr/local/bin/uv run --frozen flask db upgrade
-    if ! grep -q 'frozen' /opt/wizarr/start.sh; then
-      sed -i 's/run/& --frozen/' /opt/wizarr/start.sh
+    if grep -q 'workers' /opt/wizarr/start.sh; then
+      sed -i 's/--workers 4//' /opt/wizarr/start.sh
    fi
+    if ! grep -qE 'FLASK|WORKERS|VERSION' /opt/wizarr/.env; then
+      {
+        echo "FLASK_ENV=production"
+        echo "GUNICORN_WORKERS=4"
+        echo "APP_VERSION=$(sed 's/^20/v&/' ~/.wizarr)"
+      } >>/opt/wizarr/.env
+    else
+      sed -i "s/_VERSION=v.*$/_VERSION=v$(cat ~/.wizarr)/" /opt/wizarr/.env
+    fi
+    rm -rf "$BACKUP_FILE"
+    export FLASK_SKIP_SCHEDULER=true
+    $STD /usr/local/bin/uv run --frozen flask db upgrade
    msg_ok "Updated Wizarr"

    msg_info "Starting Service"
    systemctl start wizarr
    msg_ok "Started Service"
-
-    msg_info "Cleaning Up"
-    rm -rf "$BACKUP_FILE"
-    msg_ok "Cleanup Completed"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/ct/zabbix.sh
+++ b/ct/zabbix.sh
@ -46,7 +46,20 @@ function update_script() {
  systemctl stop "$AGENT_SERVICE"
  msg_ok "Stopped Services"

-  msg_info "Updating Zabbix"
+  read -rp "Choose Zabbix version [1] 7.0 LTS  [2] 7.4 (Latest Stable)  [3] Latest available (default: 2): " ZABBIX_CHOICE
+  ZABBIX_CHOICE=${ZABBIX_CHOICE:-2}
+  case "$ZABBIX_CHOICE" in
+  1) ZABBIX_VERSION="7.0" ;;
+  2) ZABBIX_VERSION="7.4" ;;
+  3) ZABBIX_VERSION=$(curl -fsSL https://repo.zabbix.com/zabbix/ |
+    grep -oP '(?<=href=")[0-9]+\.[0-9]+(?=/")' | sort -V | tail -n1) ;;
+  *)
+    ZABBIX_VERSION="7.4"
+    echo "Invalid choice. Defaulting to 7.4."
+    ;;
+  esac
+
+  msg_info "Updating Zabbix to $ZABBIX_VERSION"
  mkdir -p /opt/zabbix-backup/
  cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
  cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
@ -54,11 +67,10 @@ function update_script() {

  rm -Rf /etc/apt/sources.list.d/zabbix.list
  cd /tmp
-  curl -fsSL "$(curl -fsSL https://repo.zabbix.com/zabbix/ |
-    grep -oP '(?<=href=")[0-9]+\.[0-9]+(?=/")' | sort -V | tail -n1 |
-    xargs -I{} echo "https://repo.zabbix.com/zabbix/{}/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian13_all.deb")" \
-    -o /tmp/zabbix-release_latest+debian13_all.deb
+  ZABBIX_DEB_URL="https://repo.zabbix.com/zabbix/${ZABBIX_VERSION}/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian13_all.deb"
+  curl -fsSL "$ZABBIX_DEB_URL" -o /tmp/zabbix-release_latest+debian13_all.deb
  $STD dpkg -i zabbix-release_latest+debian13_all.deb
+  rm -rf /tmp/zabbix-release_latest+debian13_all.deb
  $STD apt update

  $STD apt install --only-upgrade zabbix-server-pgsql zabbix-frontend-php php8.4-pgsql
@ -88,13 +100,6 @@ function update_script() {
  systemctl start "$AGENT_SERVICE"
  systemctl restart apache2
  msg_ok "Started Services"
-
-  msg_info "Cleaning Up"
-  rm -rf /tmp/zabbix-release_latest+debian13_all.deb
-  $STD apt -y autoremove
-  $STD apt -y autoclean
-  $STD apt -y clean
-  msg_ok "Cleaned"
  msg_ok "Updated successfully!"
  exit
 }
--- a/ct/zigbee2mqtt.sh
+++ b/ct/zigbee2mqtt.sh
@ -47,18 +47,15 @@ function update_script() {
    rm -rf /opt/zigbee2mqtt/data
    mv /opt/z2m_backup/data /opt/zigbee2mqtt
    cd /opt/zigbee2mqtt
-    grep -q "^packageImportMethod" ./pnpm-workspace.yaml || echo "packageImportMethod: hardlink" >> ./pnpm-workspace.yaml
+    grep -q "^packageImportMethod" ./pnpm-workspace.yaml || echo "packageImportMethod: hardlink" >>./pnpm-workspace.yaml
    $STD pnpm install --frozen-lockfile
    $STD pnpm build
+    rm -rf /opt/z2m_backup
    msg_ok "Updated Zigbee2MQTT"

    msg_info "Starting Service"
    systemctl start zigbee2mqtt
    msg_ok "Started Service"
-
-    msg_info "Cleaning up"
-    rm -rf /opt/z2m_backup
-    msg_ok "Cleaned up"
    msg_ok "Updated successfully!"
  fi
  exit
--- a/docs/DEV_MODE.md
+++ b/docs/DEV_MODE.md
@ -0,0 +1,532 @@
+# Dev Mode - Debugging & Development Guide
+
+Development modes provide powerful debugging and testing capabilities for container creation and installation processes.
+
+## Quick Start
+
+```bash
+# Single mode
+export dev_mode="motd"
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/wallabag.sh)"
+
+# Multiple modes (comma-separated)
+export dev_mode="motd,keep,trace"
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/wallabag.sh)"
+
+# Combine with verbose output
+export var_verbose="yes"
+export dev_mode="pause,logs"
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/wallabag.sh)"
+```
+
+## Available Modes
+
+### 1. **motd** - Early SSH/MOTD Setup
+
+Sets up SSH access and MOTD **before** the main application installation.
+
+**Use Case**:
+
+- Quick access to container for manual debugging
+- Continue installation manually if something goes wrong
+- Verify container networking before main install
+
+**Behavior**:
+
+```
+✔ Container created
+✔ Network configured
+[DEV] Setting up MOTD and SSH before installation
+✔ [DEV] MOTD/SSH ready - container accessible
+# Container is now accessible via SSH while installation proceeds
+```
+
+**Combined with**: `keep`, `breakpoint`, `logs`
+
+---
+
+### 2. **keep** - Preserve Container on Failure
+
+Never delete the container when installation fails. Skips cleanup prompt.
+
+**Use Case**:
+
+- Repeated tests of the same installation
+- Debugging failed installations
+- Manual fix attempts
+
+**Behavior**:
+
+```
+✖ Installation failed in container 107 (exit code: 1)
+✔ Container creation log: /tmp/create-lxc-107-abc12345.log
+✔ Installation log: /tmp/install-lxc-107-abc12345.log
+
+🔧 [DEV] Keep mode active - container 107 preserved
+root@proxmox:~#
+```
+
+**Container remains**: `pct enter 107` to access and debug
+
+**Combined with**: `motd`, `trace`, `logs`
+
+---
+
+### 3. **trace** - Bash Command Tracing
+
+Enables `set -x` for complete command-line tracing. Shows every command before execution.
+
+**Use Case**:
+
+- Deep debugging of installation logic
+- Understanding script flow
+- Identifying where errors occur exactly
+
+**Behavior**:
+
+```
+(/opt/wallabag/bin/console): /opt/wallabag/bin/console cache:warmup
+(/opt/wallabag/bin/console): env APP_ENV=prod /opt/wallabag/bin/console cache:warmup
+(/opt/wallabag/bin/console): [[ -d /opt/wallabag/app/cache ]]
+(/opt/wallabag/bin/console): rm -rf /opt/wallabag/app/cache/*
+```
+
+**⚠️ Warning**: Exposes passwords and secrets in log output! Only use in isolated environments.
+
+**Log Output**: All trace output saved to logs (see `logs` mode)
+
+**Combined with**: `keep`, `pause`, `logs`
+
+---
+
+### 4. **pause** - Step-by-Step Execution
+
+Pauses after each major step (`msg_info`). Requires manual Enter press to continue.
+
+**Use Case**:
+
+- Inspect container state between steps
+- Understand what each step does
+- Identify which step causes problems
+
+**Behavior**:
+
+```
+⏳ Setting up Container OS
+[PAUSE] Press Enter to continue...
+⏳ Updating Container OS
+[PAUSE] Press Enter to continue...
+⏳ Installing Dependencies
+[PAUSE] Press Enter to continue...
+```
+
+**Between pauses**: You can open another terminal and inspect the container
+
+```bash
+# In another terminal while paused
+pct enter 107
+root@container:~# df -h  # Check disk usage
+root@container:~# ps aux # Check running processes
+```
+
+**Combined with**: `motd`, `keep`, `logs`
+
+---
+
+### 5. **breakpoint** - Interactive Shell on Error
+
+Opens interactive shell inside the container when an error occurs instead of cleanup prompt.
+
+**Use Case**:
+
+- Live debugging in the actual container
+- Manual command testing
+- Inspect container state at point of failure
+
+**Behavior**:
+
+```
+✖ Installation failed in container 107 (exit code: 1)
+✔ Container creation log: /tmp/create-lxc-107-abc12345.log
+✔ Installation log: /tmp/install-lxc-107-abc12345.log
+
+🐛 [DEV] Breakpoint mode - opening shell in container 107
+Type 'exit' to return to host
+root@wallabag:~#
+
+# Now you can debug:
+root@wallabag:~# tail -f /root/.install-abc12345.log
+root@wallabag:~# mysql -u root -p$PASSWORD wallabag
+root@wallabag:~# apt-get install -y strace
+root@wallabag:~# exit
+
+Container 107 still running. Remove now? (y/N): n
+🔧 Container 107 kept for debugging
+```
+
+**Combined with**: `keep`, `logs`, `trace`
+
+---
+
+### 6. **logs** - Persistent Logging
+
+Saves all logs to `/var/log/community-scripts/` with timestamps. Logs persist even on successful installation.
+
+**Use Case**:
+
+- Post-mortem analysis
+- Performance analysis
+- Automated testing with log collection
+- CI/CD integration
+
+**Behavior**:
+
+```
+Logs location: /var/log/community-scripts/
+
+create-lxc-abc12345-20251117_143022.log    (host-side creation)
+install-abc12345-20251117_143022.log       (container-side installation)
+```
+
+**Access logs**:
+
+```bash
+# View creation log
+tail -f /var/log/community-scripts/create-lxc-*.log
+
+# Search for errors
+grep ERROR /var/log/community-scripts/*.log
+
+# Analyze performance
+grep "msg_info\|msg_ok" /var/log/community-scripts/create-*.log
+```
+
+**With trace mode**: Creates detailed trace of all commands
+
+```bash
+grep "^+" /var/log/community-scripts/install-*.log
+```
+
+**Combined with**: All other modes (recommended for CI/CD)
+
+---
+
+### 7. **dryrun** - Simulation Mode
+
+Shows all commands that would be executed without actually running them.
+
+**Use Case**:
+
+- Test script logic without making changes
+- Verify command syntax
+- Understand what will happen
+- Pre-flight checks
+
+**Behavior**:
+
+```
+[DRYRUN] apt-get update
+[DRYRUN] apt-get install -y curl
+[DRYRUN] mkdir -p /opt/wallabag
+[DRYRUN] cd /opt/wallabag
+[DRYRUN] git clone https://github.com/wallabag/wallabag.git .
+```
+
+**No actual changes made**: Container/system remains unchanged
+
+**Combined with**: `trace` (shows dryrun trace), `logs` (shows what would run)
+
+---
+
+## Mode Combinations
+
+### Development Workflow
+
+```bash
+# First test: See what would happen
+export dev_mode="dryrun,logs"
+bash -c "$(curl ...)"
+
+# Then test with tracing and pauses
+export dev_mode="pause,trace,logs"
+bash -c "$(curl ...)"
+
+# Finally full debug with early SSH access
+export dev_mode="motd,keep,breakpoint,logs"
+bash -c "$(curl ...)"
+```
+
+### CI/CD Integration
+
+```bash
+# Automated testing with full logging
+export dev_mode="logs"
+export var_verbose="yes"
+bash -c "$(curl ...)"
+
+# Capture logs for analysis
+tar czf installation-logs-$(date +%s).tar.gz /var/log/community-scripts/
+```
+
+### Production-like Testing
+
+```bash
+# Keep containers for manual verification
+export dev_mode="keep,logs"
+for i in {1..5}; do
+  bash -c "$(curl ...)"
+done
+
+# Inspect all created containers
+pct list
+pct enter 100
+```
+
+### Live Debugging
+
+```bash
+# SSH in early, step through installation, debug on error
+export dev_mode="motd,pause,breakpoint,keep"
+bash -c "$(curl ...)"
+```
+
+---
+
+## Environment Variables Reference
+
+### Dev Mode Variables
+
+- `dev_mode` (string): Comma-separated list of modes
+  - Format: `"motd,keep,trace"`
+  - Default: Empty (no dev modes)
+
+### Output Control
+
+- `var_verbose="yes"`: Show all command output (disables silent mode)
+  - Pairs well with: `trace`, `pause`, `logs`
+
+### Examples with vars
+
+```bash
+# Maximum verbosity and debugging
+export var_verbose="yes"
+export dev_mode="motd,trace,pause,logs"
+bash -c "$(curl ...)"
+
+# Silent debug (logs only)
+export dev_mode="keep,logs"
+bash -c "$(curl ...)"
+
+# Interactive debugging
+export var_verbose="yes"
+export dev_mode="motd,breakpoint"
+bash -c "$(curl ...)"
+```
+
+---
+
+## Troubleshooting with Dev Mode
+
+### "Installation failed at step X"
+
+```bash
+export dev_mode="pause,logs"
+# Step through until the failure point
+# Check container state between pauses
+pct enter 107
+```
+
+### "Password/credentials not working"
+
+```bash
+export dev_mode="motd,keep,trace"
+# With trace mode, see exact password handling (be careful with logs!)
+# Use motd to SSH in and test manually
+ssh root@container-ip
+```
+
+### "Permission denied errors"
+
+```bash
+export dev_mode="breakpoint,keep"
+# Get shell at failure point
+# Check file permissions, user context, SELinux status
+ls -la /path/to/file
+whoami
+```
+
+### "Networking issues"
+
+```bash
+export dev_mode="motd"
+# SSH in with motd mode before main install
+ssh root@container-ip
+ping 8.8.8.8
+nslookup example.com
+```
+
+### "Need to manually complete installation"
+
+```bash
+export dev_mode="motd,keep"
+# Container accessible via SSH while installation runs
+# After failure, SSH in and manually continue
+ssh root@container-ip
+# ... manual commands ...
+exit
+# Then use 'keep' mode to preserve container for inspection
+```
+
+---
+
+## Log Files Locations
+
+### Default (without `logs` mode)
+
+- Host creation: `/tmp/create-lxc-<SESSION_ID>.log`
+- Container install: Copied to `/tmp/install-lxc-<CTID>-<SESSION_ID>.log` on failure
+
+### With `logs` mode
+
+- Host creation: `/var/log/community-scripts/create-lxc-<SESSION_ID>-<TIMESTAMP>.log`
+- Container install: `/var/log/community-scripts/install-<SESSION_ID>-<TIMESTAMP>.log`
+
+### View logs
+
+```bash
+# Tail in real-time
+tail -f /var/log/community-scripts/*.log
+
+# Search for errors
+grep -r "exit code [1-9]" /var/log/community-scripts/
+
+# Filter by session
+grep "ed563b19" /var/log/community-scripts/*.log
+```
+
+---
+
+## Best Practices
+
+### ✅ DO
+
+- Use `logs` mode for CI/CD and automated testing
+- Use `motd` for early SSH access during long installations
+- Use `pause` when learning the installation flow
+- Use `trace` when debugging logic issues (watch for secrets!)
+- Combine modes for comprehensive debugging
+- Archive logs after successful tests
+
+### ❌ DON'T
+
+- Use `trace` in production or with untrusted networks (exposes secrets)
+- Leave `keep` mode enabled for unattended scripts (containers accumulate)
+- Use `dryrun` and expect actual changes
+- Commit `dev_mode` exports to production deployment scripts
+- Use `breakpoint` in non-interactive environments (will hang)
+
+---
+
+## Examples
+
+### Example 1: Debug a Failed Installation
+
+```bash
+# Initial test to see the failure
+export dev_mode="keep,logs"
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/wallabag.sh)"
+
+# Container 107 kept, check logs
+tail /var/log/community-scripts/install-*.log
+
+# SSH in to debug
+pct enter 107
+root@wallabag:~# cat /root/.install-*.log | tail -100
+root@wallabag:~# apt-get update  # Retry the failing command
+root@wallabag:~# exit
+
+# Re-run with manual step-through
+export dev_mode="motd,pause,keep"
+bash -c "$(curl ...)"
+```
+
+### Example 2: Verify Installation Steps
+
+```bash
+export dev_mode="pause,logs"
+export var_verbose="yes"
+bash -c "$(curl ...)"
+
+# Press Enter through each step
+# Monitor container in another terminal
+# pct enter 107
+# Review logs in real-time
+```
+
+### Example 3: CI/CD Pipeline Integration
+
+```bash
+#!/bin/bash
+export dev_mode="logs"
+export var_verbose="no"
+
+for app in wallabag nextcloud wordpress; do
+  echo "Testing $app installation..."
+  APP="$app" bash -c "$(curl ...)" || {
+    echo "FAILED: $app"
+    tar czf logs-$app.tar.gz /var/log/community-scripts/
+    exit 1
+  }
+  echo "SUCCESS: $app"
+done
+
+echo "All installations successful"
+tar czf all-logs.tar.gz /var/log/community-scripts/
+```
+
+---
+
+## Advanced Usage
+
+### Custom Log Analysis
+
+```bash
+# Extract all errors
+grep "ERROR\|exit code [1-9]" /var/log/community-scripts/*.log
+
+# Performance timeline
+grep "^$(date +%Y-%m-%d)" /var/log/community-scripts/*.log | grep "msg_"
+
+# Memory usage during install
+grep "free\|available" /var/log/community-scripts/*.log
+```
+
+### Integration with External Tools
+
+```bash
+# Send logs to Elasticsearch
+curl -X POST "localhost:9200/installation-logs/_doc" \
+  -H 'Content-Type: application/json' \
+  -d @/var/log/community-scripts/install-*.log
+
+# Archive for compliance
+tar czf installation-records-$(date +%Y%m).tar.gz \
+  /var/log/community-scripts/
+gpg --encrypt installation-records-*.tar.gz
+```
+
+---
+
+## Support & Issues
+
+When reporting installation issues, always include:
+
+```bash
+# Collect all relevant information
+export dev_mode="logs"
+# Run the failing installation
+# Then provide:
+tar czf debug-logs.tar.gz /var/log/community-scripts/
+```
+
+Include the `debug-logs.tar.gz` when reporting issues for better diagnostics.
--- a/docs/EXIT_CODES.md
+++ b/docs/EXIT_CODES.md
@ -0,0 +1,298 @@
+# Exit Code Reference
+
+Comprehensive documentation of all exit codes used in ProxmoxVE scripts.
+
+## Table of Contents
+
+- [Generic/Shell Errors (1-255)](#genericshell-errors)
+- [Package Manager Errors (100-101, 255)](#package-manager-errors)
+- [Node.js/npm Errors (243-254)](#nodejsnpm-errors)
+- [Python/pip Errors (210-212)](#pythonpip-errors)
+- [Database Errors (231-254)](#database-errors)
+- [Proxmox Custom Codes (200-231)](#proxmox-custom-codes)
+
+---
+
+## Generic/Shell Errors
+
+Standard Unix/Linux exit codes used across all scripts.
+
+| Code    | Description                             | Common Causes                             | Solutions                                      |
+| ------- | --------------------------------------- | ----------------------------------------- | ---------------------------------------------- |
+| **1**   | General error / Operation not permitted | Permission denied, general failure        | Check user permissions, run as root if needed  |
+| **2**   | Misuse of shell builtins                | Syntax error in script                    | Review script syntax, check bash version       |
+| **126** | Command cannot execute                  | Permission problem, not executable        | `chmod +x script.sh` or check file permissions |
+| **127** | Command not found                       | Missing binary, wrong PATH                | Install required package, check PATH variable  |
+| **128** | Invalid argument to exit                | Invalid exit code passed                  | Use exit codes 0-255 only                      |
+| **130** | Terminated by Ctrl+C (SIGINT)           | User interrupted script                   | Expected behavior, no action needed            |
+| **137** | Killed (SIGKILL)                        | Out of memory, forced termination         | Check memory usage, increase RAM allocation    |
+| **139** | Segmentation fault                      | Memory access violation, corrupted binary | Reinstall package, check system stability      |
+| **143** | Terminated (SIGTERM)                    | Graceful shutdown signal                  | Expected during container stops                |
+
+---
+
+## Package Manager Errors
+
+APT, DPKG, and package installation errors.
+
+| Code    | Description                | Common Causes                           | Solutions                                         |
+| ------- | -------------------------- | --------------------------------------- | ------------------------------------------------- |
+| **100** | APT: Package manager error | Broken packages, dependency conflicts   | `apt --fix-broken install`, `dpkg --configure -a` |
+| **101** | APT: Configuration error   | Malformed sources.list, bad repo config | Check `/etc/apt/sources.list`, run `apt update`   |
+| **255** | DPKG: Fatal internal error | Corrupted package database              | `dpkg --configure -a`, restore from backup        |
+
+---
+
+## Node.js/npm Errors
+
+Node.js runtime and package manager errors.
+
+| Code    | Description                                | Common Causes                  | Solutions                                      |
+| ------- | ------------------------------------------ | ------------------------------ | ---------------------------------------------- |
+| **243** | Node.js: Out of memory                     | JavaScript heap exhausted      | Increase `--max-old-space-size`, optimize code |
+| **245** | Node.js: Invalid command-line option       | Wrong Node.js flags            | Check Node.js version, verify CLI options      |
+| **246** | Node.js: Internal JavaScript Parse Error   | Syntax error in JS code        | Review JavaScript syntax, check dependencies   |
+| **247** | Node.js: Fatal internal error              | Node.js runtime crash          | Update Node.js, check for known bugs           |
+| **248** | Node.js: Invalid C++ addon / N-API failure | Native module incompatibility  | Rebuild native modules, update packages        |
+| **249** | Node.js: Inspector error                   | Debug/inspect protocol failure | Disable inspector, check port conflicts        |
+| **254** | npm/pnpm/yarn: Unknown fatal error         | Package manager crash          | Clear cache, reinstall package manager         |
+
+---
+
+## Python/pip Errors
+
+Python runtime and package installation errors.
+
+| Code    | Description                          | Common Causes                           | Solutions                                                |
+| ------- | ------------------------------------ | --------------------------------------- | -------------------------------------------------------- |
+| **210** | Python: Virtualenv missing or broken | venv not created, corrupted environment | `python3 -m venv venv`, recreate virtualenv              |
+| **211** | Python: Dependency resolution failed | Conflicting package versions            | Use `pip install --upgrade`, check requirements.txt      |
+| **212** | Python: Installation aborted         | EXTERNALLY-MANAGED, permission denied   | Use `--break-system-packages` or venv, check permissions |
+
+---
+
+## Database Errors
+
+### PostgreSQL (231-234)
+
+| Code    | Description             | Common Causes                      | Solutions                                             |
+| ------- | ----------------------- | ---------------------------------- | ----------------------------------------------------- |
+| **231** | Connection failed       | Server not running, wrong socket   | `systemctl start postgresql`, check connection string |
+| **232** | Authentication failed   | Wrong credentials                  | Verify username/password, check `pg_hba.conf`         |
+| **233** | Database does not exist | Database not created               | `CREATE DATABASE`, restore from backup                |
+| **234** | Fatal error in query    | Syntax error, constraint violation | Review SQL syntax, check constraints                  |
+
+### MySQL/MariaDB (241-244)
+
+| Code    | Description             | Common Causes                      | Solutions                                            |
+| ------- | ----------------------- | ---------------------------------- | ---------------------------------------------------- |
+| **241** | Connection failed       | Server not running, wrong socket   | `systemctl start mysql`, check connection parameters |
+| **242** | Authentication failed   | Wrong credentials                  | Verify username/password, grant privileges           |
+| **243** | Database does not exist | Database not created               | `CREATE DATABASE`, restore from backup               |
+| **244** | Fatal error in query    | Syntax error, constraint violation | Review SQL syntax, check constraints                 |
+
+### MongoDB (251-254)
+
+| Code    | Description           | Common Causes        | Solutions                                  |
+| ------- | --------------------- | -------------------- | ------------------------------------------ |
+| **251** | Connection failed     | Server not running   | `systemctl start mongod`, check port 27017 |
+| **252** | Authentication failed | Wrong credentials    | Verify username/password, create user      |
+| **253** | Database not found    | Database not created | Database auto-created on first write       |
+| **254** | Fatal query error     | Invalid query syntax | Review MongoDB query syntax                |
+
+---
+
+## Proxmox Custom Codes
+
+Custom exit codes specific to ProxmoxVE scripts.
+
+### Container Creation Errors (200-209)
+
+| Code    | Description                                    | Common Causes                                           | Solutions                                               |
+| ------- | ---------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
+| **200** | Failed to create lock file                     | Permission denied, disk full                            | Check `/tmp` permissions, free disk space               |
+| **203** | Missing CTID variable                          | Script configuration error                              | Set CTID in script or via prompt                        |
+| **204** | Missing PCT_OSTYPE variable                    | Template selection failed                               | Verify template availability                            |
+| **205** | Invalid CTID (<100)                            | CTID below minimum value                                | Use CTID ≥ 100 (1-99 reserved for Proxmox)              |
+| **206** | CTID already in use                            | Container/VM with same ID exists                        | Check `pct list` and `/etc/pve/lxc/`, use different ID  |
+| **207** | Password contains unescaped special characters | Special chars like `-`, `/`, `\`, `*` at start/end      | Avoid leading special chars, use alphanumeric passwords |
+| **208** | Invalid configuration                          | DNS format (`.home` vs `home`), MAC format (`-` vs `:`) | Remove leading dots from DNS, use `:` in MAC addresses  |
+| **209** | Container creation failed                      | Multiple possible causes                                | Check logs in `/tmp/pct_create_*.log`, verify template  |
+
+### Cluster & Storage Errors (210, 214, 217)
+
+| Code    | Description                       | Common Causes                      | Solutions                                                   |
+| ------- | --------------------------------- | ---------------------------------- | ----------------------------------------------------------- |
+| **210** | Cluster not quorate               | Cluster nodes down, network issues | Check cluster status: `pvecm status`, fix node connectivity |
+| **211** | Timeout waiting for template lock | Concurrent download in progress    | Wait for other download to complete (60s timeout)           |
+| **214** | Not enough storage space          | Disk full, quota exceeded          | Free disk space, increase storage allocation                |
+| **217** | Storage does not support rootdir  | Wrong storage type selected        | Use storage supporting containers (dir, zfspool, lvm-thin)  |
+
+### Container Verification Errors (215-216)
+
+| Code    | Description                      | Common Causes                    | Solutions                                                 |
+| ------- | -------------------------------- | -------------------------------- | --------------------------------------------------------- |
+| **215** | Container created but not listed | Ghost state, incomplete creation | Check `/etc/pve/lxc/CTID.conf`, remove manually if needed |
+| **216** | RootFS entry missing in config   | Incomplete container creation    | Delete container, retry creation                          |
+
+### Template Errors (218, 220-223, 225)
+
+| Code    | Description                               | Common Causes                                    | Solutions                                                   |
+| ------- | ----------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------- |
+| **218** | Template file corrupted or incomplete     | Download interrupted, file <1MB, invalid archive | Delete template, run `pveam update && pveam download`       |
+| **220** | Unable to resolve template path           | Template storage not accessible                  | Check storage availability, verify permissions              |
+| **221** | Template file exists but not readable     | Permission denied                                | `chmod 644 template.tar.zst`, check storage permissions     |
+| **222** | Template download failed after 3 attempts | Network issues, storage problems                 | Check internet connectivity, verify storage space           |
+| **223** | Template not available after download     | Storage sync issue, I/O delay                    | Wait a few seconds, verify storage is mounted               |
+| **225** | No template available for OS/Version      | Unsupported OS version, catalog outdated         | Run `pveam update`, check `pveam available -section system` |
+
+### LXC Stack Errors (231)
+
+| Code    | Description                    | Common Causes                               | Solutions                                    |
+| ------- | ------------------------------ | ------------------------------------------- | -------------------------------------------- |
+| **231** | LXC stack upgrade/retry failed | Outdated `pve-container`, Debian 13.1 issue | See [Debian 13.1 Fix Guide](#debian-131-fix) |
+
+---
+
+## Special Case: Debian 13.1 "unsupported version" Error
+
+### Problem
+
+```
+TASK ERROR: unable to create CT 129 - unsupported debian version '13.1'
+```
+
+### Root Cause
+
+Outdated `pve-container` package doesn't recognize Debian 13 (Trixie).
+
+### Solutions
+
+#### Option 1: Full System Upgrade (Recommended)
+
+```bash
+apt update
+apt full-upgrade -y
+reboot
+```
+
+Verify fix:
+
+```bash
+dpkg -l pve-container
+# PVE 8: Should show 5.3.3+
+# PVE 9: Should show 6.0.13+
+```
+
+#### Option 2: Update Only pve-container
+
+```bash
+apt update
+apt install --only-upgrade pve-container -y
+```
+
+**Warning:** If Proxmox fails to boot after this, your system was inconsistent. Perform Option 1 instead.
+
+#### Option 3: Verify Repository Configuration
+
+Many users disable Enterprise repos but forget to add no-subscription repos.
+
+**For PVE 9 (Trixie):**
+
+```bash
+cat /etc/apt/sources.list.d/pve-no-subscription.list
+```
+
+Should contain:
+
+```
+deb http://download.proxmox.com/debian/pve trixie pve-no-subscription
+deb http://download.proxmox.com/debian/ceph-squid trixie no-subscription
+```
+
+**For PVE 8 (Bookworm):**
+
+```
+deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
+deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription
+```
+
+Then:
+
+```bash
+apt update
+apt full-upgrade -y
+```
+
+### Reference
+
+Official discussion: [GitHub #8126](https://github.com/community-scripts/ProxmoxVE/discussions/8126)
+
+---
+
+## Troubleshooting Tips
+
+### Finding Error Details
+
+1. **Check logs:**
+
+   ```bash
+   tail -n 50 /tmp/pct_create_*.log
+   ```
+
+2. **Enable verbose mode:**
+
+   ```bash
+   bash -x script.sh  # Shows every command executed
+   ```
+
+3. **Check container status:**
+
+   ```bash
+   pct list
+   pct status CTID
+   ```
+
+4. **Verify storage:**
+   ```bash
+   pvesm status
+   df -h
+   ```
+
+### Common Patterns
+
+- **Exit 0 with error message:** Configuration validation failed (check DNS, MAC, password format)
+- **Exit 206 but container not visible:** Ghost container state - check `/etc/pve/lxc/` manually
+- **Exit 209 generic error:** Check `/tmp/pct_create_*.log` for specific `pct create` failure reason
+- **Exit 218 or 222:** Template issues - delete and re-download template
+
+---
+
+## Quick Reference Chart
+
+| Exit Code Range | Category           | Typical Issue                               |
+| --------------- | ------------------ | ------------------------------------------- |
+| 1-2, 126-143    | Shell/System       | Permissions, signals, missing commands      |
+| 100-101, 255    | Package Manager    | APT/DPKG errors, broken packages            |
+| 200-209         | Container Creation | CTID, password, configuration               |
+| 210-217         | Storage/Cluster    | Disk space, quorum, storage type            |
+| 218-225         | Templates          | Download, corruption, availability          |
+| 231-254         | Databases/Runtime  | PostgreSQL, MySQL, MongoDB, Node.js, Python |
+
+---
+
+## Contributing
+
+Found an undocumented exit code or have a solution to share? Please:
+
+1. Open an issue on [GitHub](https://github.com/community-scripts/ProxmoxVE/issues)
+2. Include:
+   - Exit code number
+   - Error message
+   - Steps to reproduce
+   - Solution that worked for you
+
+---
+
+_Last updated: November 2025_
+_ProxmoxVE Version: 2.x_
--- a/docs/README.md
+++ b/docs/README.md
@ -0,0 +1,298 @@
+# 📚 ProxmoxVE Documentation
+
+Complete guide to all ProxmoxVE documentation - quickly find what you need.
+
+---
+
+## 🎯 **Quick Navigation by Goal**
+
+### 👤 **I want to...**
+
+**Contribute a new application**
+→ Start with: [contribution/README.md](contribution/README.md)
+→ Then: [ct/DETAILED_GUIDE.md](ct/DETAILED_GUIDE.md) + [install/DETAILED_GUIDE.md](install/DETAILED_GUIDE.md)
+
+**Understand the architecture**
+→ Read: [TECHNICAL_REFERENCE.md](TECHNICAL_REFERENCE.md)
+→ Then: [misc/README.md](misc/README.md)
+
+**Debug a failed installation**
+→ Check: [EXIT_CODES.md](EXIT_CODES.md)
+→ Then: [DEV_MODE.md](DEV_MODE.md)
+→ See also: [misc/error_handler.func/](misc/error_handler.func/)
+
+**Configure system defaults**
+→ Read: [guides/DEFAULTS_SYSTEM_GUIDE.md](guides/DEFAULTS_SYSTEM_GUIDE.md)
+
+**Deploy containers automatically**
+→ Read: [guides/UNATTENDED_DEPLOYMENTS.md](guides/UNATTENDED_DEPLOYMENTS.md)
+
+**Develop a function library**
+→ Study: [misc/](misc/) documentation
+
+---
+
+## 👤 **Quick Start by Role**
+
+### **I'm a...**
+
+**New Contributor**
+→ Start: [contribution/README.md](contribution/README.md)
+→ Then: Choose your path below
+
+**Container Creator**
+→ Read: [ct/README.md](ct/README.md)
+→ Deep Dive: [ct/DETAILED_GUIDE.md](ct/DETAILED_GUIDE.md)
+→ Reference: [misc/build.func/](misc/build.func/)
+
+**Installation Script Developer**
+→ Read: [install/README.md](install/README.md)
+→ Deep Dive: [install/DETAILED_GUIDE.md](install/DETAILED_GUIDE.md)
+→ Reference: [misc/tools.func/](misc/tools.func/)
+
+**VM Provisioner**
+→ Read: [vm/README.md](vm/README.md)
+→ Reference: [misc/cloud-init.func/](misc/cloud-init.func/)
+
+**Tools Developer**
+→ Read: [tools/README.md](tools/README.md)
+→ Reference: [misc/build.func/](misc/build.func/)
+
+**API Integrator**
+→ Read: [api/README.md](api/README.md)
+→ Reference: [misc/api.func/](misc/api.func/)
+
+**System Operator**
+→ Start: [EXIT_CODES.md](EXIT_CODES.md)
+→ Then: [guides/DEFAULTS_SYSTEM_GUIDE.md](guides/DEFAULTS_SYSTEM_GUIDE.md)
+→ Automate: [guides/UNATTENDED_DEPLOYMENTS.md](guides/UNATTENDED_DEPLOYMENTS.md)
+→ Debug: [DEV_MODE.md](DEV_MODE.md)
+
+**Architect**
+→ Read: [TECHNICAL_REFERENCE.md](TECHNICAL_REFERENCE.md)
+→ Deep Dive: [misc/README.md](misc/README.md)
+
+---
+
+## 📂 **Documentation Structure**
+
+### Project-Mirrored Directories
+
+Each major project directory has documentation:
+
+```
+ProxmoxVE/
+├─ ct/                 ↔ docs/ct/ (README.md + DETAILED_GUIDE.md)
+├─ install/           ↔ docs/install/ (README.md + DETAILED_GUIDE.md)
+├─ vm/                ↔ docs/vm/ (README.md)
+├─ tools/            ↔ docs/tools/ (README.md)
+├─ api/              ↔ docs/api/ (README.md)
+├─ misc/             ↔ docs/misc/ (9 function libraries)
+└─ [system-wide]     ↔ docs/guides/ (configuration & deployment guides)
+```
+
+### Core Documentation
+
+| Document | Purpose | Audience |
+|----------|---------|----------|
+| [contribution/README.md](contribution/README.md) | How to contribute | Contributors |
+| [ct/DETAILED_GUIDE.md](ct/DETAILED_GUIDE.md) | Create ct scripts | Container developers |
+| [install/DETAILED_GUIDE.md](install/DETAILED_GUIDE.md) | Create install scripts | Installation developers |
+| [TECHNICAL_REFERENCE.md](TECHNICAL_REFERENCE.md) | Architecture deep-dive | Architects, advanced users |
+| [guides/DEFAULTS_SYSTEM_GUIDE.md](guides/DEFAULTS_SYSTEM_GUIDE.md) | Configuration system | Operators, power users |
+| [guides/CONFIGURATION_REFERENCE.md](guides/CONFIGURATION_REFERENCE.md) | Configuration options reference | Advanced users |
+| [guides/UNATTENDED_DEPLOYMENTS.md](guides/UNATTENDED_DEPLOYMENTS.md) | Automated deployments | DevOps, automation |
+| [EXIT_CODES.md](EXIT_CODES.md) | Exit code reference | Troubleshooters |
+| [DEV_MODE.md](DEV_MODE.md) | Debugging tools | Developers |
+
+---
+
+## 📂 **Directory Guide**
+
+### [ct/](ct/) - Container Scripts
+Documentation for `/ct` - Container creation scripts that run on the Proxmox host.
+
+**Includes**:
+- Overview of container creation process
+- Deep dive: [DETAILED_GUIDE.md](ct/DETAILED_GUIDE.md) - Complete reference with examples
+- Reference to [misc/build.func/](misc/build.func/)
+- Quick start for creating new containers
+
+### [install/](install/) - Installation Scripts
+Documentation for `/install` - Scripts that run inside containers to install applications.
+
+**Includes**:
+- Overview of 10-phase installation pattern
+- Deep dive: [DETAILED_GUIDE.md](install/DETAILED_GUIDE.md) - Complete reference with examples
+- Reference to [misc/tools.func/](misc/tools.func/)
+- Alpine vs Debian differences
+
+### [vm/](vm/) - Virtual Machine Scripts
+Documentation for `/vm` - VM creation scripts using cloud-init provisioning.
+
+**Includes**:
+- Overview of VM provisioning
+- Link to [misc/cloud-init.func/](misc/cloud-init.func/)
+- VM vs Container comparison
+- Cloud-init examples
+
+### [tools/](tools/) - Tools & Utilities
+Documentation for `/tools` - Management tools and add-ons.
+
+**Includes**:
+- Overview of tools structure
+- Integration points
+- Contributing new tools
+- Common operations
+
+### [api/](api/) - API Integration
+Documentation for `/api` - Telemetry and API backend.
+
+**Includes**:
+- API overview
+- Integration methods
+- API endpoints
+- Privacy information
+
+### [misc/](misc/) - Function Libraries
+Documentation for `/misc` - 9 core function libraries with complete references.
+
+**Contains**:
+- **build.func/** - Container orchestration (7 files)
+- **core.func/** - Utilities and messaging (5 files)
+- **error_handler.func/** - Error handling (5 files)
+- **api.func/** - API integration (5 files)
+- **install.func/** - Container setup (5 files)
+- **tools.func/** - Package installation (6 files)
+- **alpine-install.func/** - Alpine setup (5 files)
+- **alpine-tools.func/** - Alpine tools (5 files)
+- **cloud-init.func/** - VM provisioning (5 files)
+
+---
+
+## 🎓 **Learning Paths**
+
+### Path 1: First-Time Contributor (2-3 hours)
+
+1. [contribution/README.md](contribution/README.md) - Quick Start
+2. Pick your area:
+   - Containers → [ct/README.md](ct/README.md) + [ct/DETAILED_GUIDE.md](ct/DETAILED_GUIDE.md)
+   - Installation → [install/README.md](install/README.md) + [install/DETAILED_GUIDE.md](install/DETAILED_GUIDE.md)
+   - VMs → [vm/README.md](vm/README.md)
+3. Study existing similar script
+4. Create your contribution
+5. Submit PR
+
+### Path 2: Intermediate Developer (4-6 hours)
+
+1. [TECHNICAL_REFERENCE.md](TECHNICAL_REFERENCE.md)
+2. Dive into function libraries:
+   - [misc/build.func/README.md](misc/build.func/README.md)
+   - [misc/tools.func/README.md](misc/tools.func/README.md)
+   - [misc/install.func/README.md](misc/install.func/README.md)
+3. Study advanced examples
+4. Create complex applications
+
+### Path 3: Advanced Architect (8+ hours)
+
+1. All of Intermediate Path
+2. Study all 9 function libraries in depth
+3. [guides/DEFAULTS_SYSTEM_GUIDE.md](guides/DEFAULTS_SYSTEM_GUIDE.md) - Configuration system
+4. [DEV_MODE.md](DEV_MODE.md) - Debugging and development
+5. Design new features or function libraries
+
+### Path 4: Troubleshooter (30 minutes - 1 hour)
+
+1. [EXIT_CODES.md](EXIT_CODES.md) - Find error code
+2. [DEV_MODE.md](DEV_MODE.md) - Run with debugging
+3. Check relevant function library docs
+4. Review logs and fix
+
+---
+
+## 📊 **By the Numbers**
+
+| Metric | Count |
+|--------|:---:|
+| **Documentation Files** | 63 |
+| **Total Lines** | 15,000+ |
+| **Function Libraries** | 9 |
+| **Functions Documented** | 150+ |
+| **Code Examples** | 50+ |
+| **Flowcharts** | 15+ |
+| **Do/Don't Sections** | 20+ |
+| **Real-World Examples** | 30+ |
+
+---
+
+## 🔍 **Find It Fast**
+
+### By Feature
+- **How do I create a container?** → [ct/DETAILED_GUIDE.md](ct/DETAILED_GUIDE.md)
+- **How do I create an install script?** → [install/DETAILED_GUIDE.md](install/DETAILED_GUIDE.md)
+- **How do I create a VM?** → [vm/README.md](vm/README.md)
+- **How do I install Node.js?** → [misc/tools.func/](misc/tools.func/)
+- **How do I debug?** → [DEV_MODE.md](DEV_MODE.md)
+
+### By Error
+- **Exit code 206?** → [EXIT_CODES.md](EXIT_CODES.md)
+- **Network failed?** → [misc/install.func/](misc/install.func/)
+- **Package error?** → [misc/tools.func/](misc/tools.func/)
+
+### By Role
+- **Contributor** → [contribution/README.md](contribution/README.md)
+- **Operator** → [guides/DEFAULTS_SYSTEM_GUIDE.md](guides/DEFAULTS_SYSTEM_GUIDE.md)
+- **Automation** → [guides/UNATTENDED_DEPLOYMENTS.md](guides/UNATTENDED_DEPLOYMENTS.md)
+- **Developer** → [TECHNICAL_REFERENCE.md](TECHNICAL_REFERENCE.md)
+- **Architect** → [misc/README.md](misc/README.md)
+
+---
+
+## ✅ **Documentation Features**
+
+- ✅ **Project-mirrored structure** - Organized like the actual project
+- ✅ **Complete function references** - Every function documented
+- ✅ **Real-world examples** - Copy-paste ready code
+- ✅ **Visual flowcharts** - ASCII diagrams of workflows
+- ✅ **Integration guides** - How components connect
+- ✅ **Troubleshooting** - Common issues and solutions
+- ✅ **Best practices** - DO/DON'T sections throughout
+- ✅ **Learning paths** - Structured curriculum by role
+- ✅ **Quick references** - Fast lookup by error code
+- ✅ **Comprehensive navigation** - This page
+
+---
+
+## 🚀 **Start Here**
+
+**New to ProxmoxVE?** → [contribution/README.md](contribution/README.md)
+
+**Looking for something specific?** → Choose your role above or browse by directory
+
+**Need to debug?** → [EXIT_CODES.md](EXIT_CODES.md)
+
+**Want to understand architecture?** → [TECHNICAL_REFERENCE.md](TECHNICAL_REFERENCE.md)
+
+---
+
+## 🤝 **Contributing Documentation**
+
+Found an error? Want to improve docs?
+
+1. See: [contribution/README.md](contribution/README.md) for full contribution guide
+2. Open issue: [GitHub Issues](https://github.com/community-scripts/ProxmoxVE/issues)
+3. Or submit PR with improvements
+
+---
+
+## 📝 **Status**
+
+- **Last Updated**: December 2025
+- **Version**: 2.3 (Consolidated & Reorganized)
+- **Completeness**: ✅ 100% - All components documented
+- **Quality**: ✅ Production-ready
+- **Structure**: ✅ Clean and organized
+
+---
+
+**Welcome to ProxmoxVE! Start with [CONTRIBUTION_GUIDE.md](CONTRIBUTION_GUIDE.md) or choose your role above.** 🚀
--- a/docs/TECHNICAL_REFERENCE.md
+++ b/docs/TECHNICAL_REFERENCE.md
@ -0,0 +1,881 @@
+# Technical Reference: Configuration System Architecture
+
+> **For Developers and Advanced Users**
+> 
+> *Deep dive into how the defaults and configuration system works*
+
+---
+
+## Table of Contents
+
+1. [System Architecture](#system-architecture)
+2. [File Format Specifications](#file-format-specifications)
+3. [Function Reference](#function-reference)
+4. [Variable Precedence](#variable-precedence)
+5. [Data Flow Diagrams](#data-flow-diagrams)
+6. [Security Model](#security-model)
+7. [Implementation Details](#implementation-details)
+
+---
+
+## System Architecture
+
+### Component Overview
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Installation Script                       │
+│  (pihole-install.sh, docker-install.sh, etc.)              │
+└────────────────────┬────────────────────────────────────────┘
+                     │
+                     v
+┌─────────────────────────────────────────────────────────────┐
+│                   build.func Library                         │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  variables()                                         │   │
+│  │  - Initialize NSAPP, var_install, etc.             │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  install_script()                                    │   │
+│  │  - Display mode menu                                │   │
+│  │  - Route to appropriate workflow                    │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  base_settings()                                     │   │
+│  │  - Apply built-in defaults                          │   │
+│  │  - Read environment variables (var_*)               │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  load_vars_file()                                    │   │
+│  │  - Safe file parsing (NO source/eval)              │   │
+│  │  - Whitelist validation                             │   │
+│  │  - Value sanitization                               │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  default_var_settings()                              │   │
+│  │  - Load user defaults                               │   │
+│  │  - Display summary                                  │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  maybe_offer_save_app_defaults()                     │   │
+│  │  - Offer to save current settings                   │   │
+│  │  - Handle updates vs. new saves                     │   │
+│  └──────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────┘
+                     │
+                     v
+┌─────────────────────────────────────────────────────────────┐
+│           Configuration Files (on Disk)                      │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  /usr/local/community-scripts/default.vars          │   │
+│  │  (User global defaults)                             │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  /usr/local/community-scripts/defaults/*.vars       │   │
+│  │  (App-specific defaults)                            │   │
+│  └──────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## File Format Specifications
+
+### User Defaults: `default.vars`
+
+**Location**: `/usr/local/community-scripts/default.vars`
+
+**MIME Type**: `text/plain`
+
+**Encoding**: UTF-8 (no BOM)
+
+**Format Specification**:
+
+```
+# File Format: Simple key=value pairs
+# Purpose: Store global user defaults
+# Security: Sanitized values, whitelist validation
+
+# Comments and blank lines are ignored
+# Line format: var_name=value
+# No spaces around the equals sign
+# String values do not need quoting (but may be quoted)
+
+[CONTENT]
+var_cpu=4
+var_ram=2048
+var_disk=20
+var_hostname=mydefault
+var_brg=vmbr0
+var_gateway=192.168.1.1
+```
+
+**Formal Grammar**:
+
+```
+FILE       := (BLANK_LINE | COMMENT_LINE | VAR_LINE)*
+BLANK_LINE := \n
+COMMENT_LINE := '#' [^\n]* \n
+VAR_LINE   := VAR_NAME '=' VAR_VALUE \n
+VAR_NAME   := 'var_' [a-z_]+
+VAR_VALUE  := [^\n]*  # Any printable characters except newline
+```
+
+**Constraints**:
+
+| Constraint | Value |
+|-----------|-------|
+| Max file size | 64 KB |
+| Max line length | 1024 bytes |
+| Max variables | 100 |
+| Allowed var names | `var_[a-z_]+` |
+| Value validation | Whitelist + Sanitization |
+
+**Example Valid File**:
+
+```bash
+# Global User Defaults
+# Created: 2024-11-28
+
+# Resource defaults
+var_cpu=4
+var_ram=2048
+var_disk=20
+
+# Network defaults
+var_brg=vmbr0
+var_gateway=192.168.1.1
+var_mtu=1500
+var_vlan=100
+
+# System defaults
+var_timezone=Europe/Berlin
+var_hostname=default-container
+
+# Storage
+var_container_storage=local
+var_template_storage=local
+
+# Security
+var_ssh=yes
+var_protection=0
+var_unprivileged=1
+```
+
+### App Defaults: `<app>.vars`
+
+**Location**: `/usr/local/community-scripts/defaults/<appname>.vars`
+
+**Format**: Identical to `default.vars`
+
+**Naming Convention**: `<nsapp>.vars`
+
+- `nsapp` = lowercase app name with spaces removed
+- Examples:
+  - `pihole` → `pihole.vars`
+  - `opnsense` → `opnsense.vars`
+  - `docker compose` → `dockercompose.vars`
+
+**Example App Defaults**:
+
+```bash
+# App-specific defaults for PiHole (pihole)
+# Generated on 2024-11-28T15:32:00Z
+# These override user defaults when installing pihole
+
+var_unprivileged=1
+var_cpu=2
+var_ram=1024
+var_disk=10
+var_brg=vmbr0
+var_net=veth
+var_gateway=192.168.1.1
+var_hostname=pihole
+var_timezone=Europe/Berlin
+var_container_storage=local
+var_template_storage=local
+var_tags=dns,pihole
+```
+
+---
+
+## Function Reference
+
+### `load_vars_file()`
+
+**Purpose**: Safely load variables from .vars files without using `source` or `eval`
+
+**Signature**:
+```bash
+load_vars_file(filepath)
+```
+
+**Parameters**:
+
+| Param | Type | Required | Example |
+|-------|------|----------|---------|
+| filepath | String | Yes | `/usr/local/community-scripts/default.vars` |
+
+**Returns**:
+- `0` on success
+- `1` on error (file missing, parse error, etc.)
+
+**Environment Side Effects**:
+- Sets all parsed `var_*` variables as shell variables
+- Does NOT unset variables if file missing (safe)
+- Does NOT affect other variables
+
+**Implementation Pattern**:
+
+```bash
+load_vars_file() {
+  local file="$1"
+  
+  # File must exist
+  [ -f "$file" ] || return 0
+  
+  # Parse line by line (not with source/eval)
+  local line key val
+  while IFS='=' read -r key val || [ -n "$key" ]; do
+    # Skip comments and empty lines
+    [[ "$key" =~ ^[[:space:]]*# ]] && continue
+    [[ -z "$key" ]] && continue
+    
+    # Validate key is in whitelist
+    _is_whitelisted_key "$key" || continue
+    
+    # Sanitize and export value
+    val="$(_sanitize_value "$val")"
+    [ $? -eq 0 ] && export "$key=$val"
+  done < "$file"
+  
+  return 0
+}
+```
+
+**Usage Examples**:
+
+```bash
+# Load user defaults
+load_vars_file "/usr/local/community-scripts/default.vars"
+
+# Load app-specific defaults
+load_vars_file "$(get_app_defaults_path)"
+
+# Check if successful
+if load_vars_file "$vars_path"; then
+  echo "Settings loaded successfully"
+else
+  echo "Failed to load settings"
+fi
+
+# Values are now available as variables
+echo "Using $var_cpu cores"
+echo "Allocating ${var_ram} MB RAM"
+```
+
+---
+
+### `get_app_defaults_path()`
+
+**Purpose**: Get the full path for app-specific defaults file
+
+**Signature**:
+```bash
+get_app_defaults_path()
+```
+
+**Parameters**: None
+
+**Returns**:
+- String: Full path to app defaults file
+
+**Implementation**:
+
+```bash
+get_app_defaults_path() {
+  local n="${NSAPP:-${APP,,}}"
+  echo "/usr/local/community-scripts/defaults/${n}.vars"
+}
+```
+
+**Usage Examples**:
+
+```bash
+# Get app defaults path
+app_defaults="$(get_app_defaults_path)"
+echo "App defaults at: $app_defaults"
+
+# Check if app defaults exist
+if [ -f "$(get_app_defaults_path)" ]; then
+  echo "App defaults available"
+fi
+
+# Load app defaults
+load_vars_file "$(get_app_defaults_path)"
+```
+
+---
+
+### `default_var_settings()`
+
+**Purpose**: Load and display user global defaults
+
+**Signature**:
+```bash
+default_var_settings()
+```
+
+**Parameters**: None
+
+**Returns**:
+- `0` on success
+- `1` on error
+
+**Workflow**:
+
+```
+1. Find default.vars location
+   (usually /usr/local/community-scripts/default.vars)
+   
+2. Create if missing
+   
+3. Load variables from file
+   
+4. Map var_verbose → VERBOSE variable
+   
+5. Call base_settings (apply to container config)
+   
+6. Call echo_default (display summary)
+```
+
+**Implementation Pattern**:
+
+```bash
+default_var_settings() {
+  local VAR_WHITELIST=(
+    var_apt_cacher var_apt_cacher_ip var_brg var_cpu var_disk var_fuse
+    var_gateway var_hostname var_ipv6_method var_mac var_mtu
+    var_net var_ns var_pw var_ram var_tags var_tun var_unprivileged
+    var_verbose var_vlan var_ssh var_ssh_authorized_key
+    var_container_storage var_template_storage
+  )
+  
+  # Ensure file exists
+  _ensure_default_vars
+  
+  # Find and load
+  local dv="$(_find_default_vars)"
+  load_vars_file "$dv"
+  
+  # Map verbose flag
+  if [[ -n "${var_verbose:-}" ]]; then
+    case "${var_verbose,,}" in
+      1 | yes | true | on) VERBOSE="yes" ;;
+      *) VERBOSE="${var_verbose}" ;;
+    esac
+  fi
+  
+  # Apply and display
+  base_settings "$VERBOSE"
+  echo_default
+}
+```
+
+---
+
+### `maybe_offer_save_app_defaults()`
+
+**Purpose**: Offer to save current settings as app-specific defaults
+
+**Signature**:
+```bash
+maybe_offer_save_app_defaults()
+```
+
+**Parameters**: None
+
+**Returns**: None (side effects only)
+
+**Behavior**:
+
+1. After advanced installation completes
+2. Offers user: "Save as App Defaults for <APP>?"
+3. If yes:
+   - Saves to `/usr/local/community-scripts/defaults/<app>.vars`
+   - Only whitelisted variables included
+   - Previous defaults backed up (if exists)
+4. If no:
+   - No action taken
+
+**Flow**:
+
+```bash
+maybe_offer_save_app_defaults() {
+  local app_vars_path="$(get_app_defaults_path)"
+  
+  # Build current settings from memory
+  local new_tmp="$(_build_current_app_vars_tmp)"
+  
+  # Check if already exists
+  if [ -f "$app_vars_path" ]; then
+    # Show diff and ask: Update? Keep? View Diff?
+    _show_app_defaults_diff_menu "$new_tmp" "$app_vars_path"
+  else
+    # New defaults - just save
+    if whiptail --yesno "Save as App Defaults for $APP?" 10 60; then
+      mv "$new_tmp" "$app_vars_path"
+      chmod 644 "$app_vars_path"
+    fi
+  fi
+}
+```
+
+---
+
+### `_sanitize_value()`
+
+**Purpose**: Remove dangerous characters/patterns from configuration values
+
+**Signature**:
+```bash
+_sanitize_value(value)
+```
+
+**Parameters**:
+
+| Param | Type | Required |
+|-------|------|----------|
+| value | String | Yes |
+
+**Returns**:
+- `0` (success) + sanitized value on stdout
+- `1` (failure) + nothing if dangerous
+
+**Dangerous Patterns**:
+
+| Pattern | Threat | Example |
+|---------|--------|---------|
+| `$(...)` | Command substitution | `$(rm -rf /)` |
+| `` ` ` `` | Command substitution | `` `whoami` `` |
+| `;` | Command separator | `value; rm -rf /` |
+| `&` | Background execution | `value & malicious` |
+| `<(` | Process substitution | `<(cat /etc/passwd)` |
+
+**Implementation**:
+
+```bash
+_sanitize_value() {
+  case "$1" in
+  *'$('* | *'`'* | *';'* | *'&'* | *'<('*)
+    echo ""
+    return 1  # Reject dangerous value
+    ;;
+  esac
+  echo "$1"
+  return 0
+}
+```
+
+**Usage Examples**:
+
+```bash
+# Safe value
+_sanitize_value "192.168.1.1"  # Returns: 192.168.1.1 (status: 0)
+
+# Dangerous value
+_sanitize_value "$(whoami)"     # Returns: (empty) (status: 1)
+
+# Usage in code
+if val="$(_sanitize_value "$user_input")"; then
+  export var_hostname="$val"
+else
+  msg_error "Invalid value: contains dangerous characters"
+fi
+```
+
+---
+
+### `_is_whitelisted_key()`
+
+**Purpose**: Check if variable name is in allowed whitelist
+
+**Signature**:
+```bash
+_is_whitelisted_key(key)
+```
+
+**Parameters**:
+
+| Param | Type | Required | Example |
+|-------|------|----------|---------|
+| key | String | Yes | `var_cpu` |
+
+**Returns**:
+- `0` if key is whitelisted
+- `1` if key is NOT whitelisted
+
+**Implementation**:
+
+```bash
+_is_whitelisted_key() {
+  local k="$1"
+  local w
+  for w in "${VAR_WHITELIST[@]}"; do
+    [ "$k" = "$w" ] && return 0
+  done
+  return 1
+}
+```
+
+**Usage Examples**:
+
+```bash
+# Check if variable can be saved
+if _is_whitelisted_key "var_cpu"; then
+  echo "var_cpu can be saved"
+fi
+
+# Reject unknown variables
+if ! _is_whitelisted_key "var_custom"; then
+  msg_error "var_custom is not supported"
+fi
+```
+
+---
+
+## Variable Precedence
+
+### Loading Order
+
+When a container is being created, variables are resolved in this order:
+
+```
+Step 1: Read ENVIRONMENT VARIABLES
+   ├─ Check if var_cpu is already set in shell environment
+   ├─ Check if var_ram is already set
+   └─ ...all var_* variables
+
+Step 2: Load APP-SPECIFIC DEFAULTS
+   ├─ Check if /usr/local/community-scripts/defaults/pihole.vars exists
+   ├─ Load all var_* from that file
+   └─ These override built-ins but NOT environment variables
+
+Step 3: Load USER GLOBAL DEFAULTS
+   ├─ Check if /usr/local/community-scripts/default.vars exists
+   ├─ Load all var_* from that file
+   └─ These override built-ins but NOT app-specific
+
+Step 4: Use BUILT-IN DEFAULTS
+   └─ Hardcoded in script (lowest priority)
+```
+
+### Precedence Examples
+
+**Example 1: Environment Variable Wins**
+```bash
+# Shell environment has highest priority
+$ export var_cpu=16
+$ bash pihole-install.sh
+
+# Result: Container gets 16 cores
+# (ignores app defaults, user defaults, built-ins)
+```
+
+**Example 2: App Defaults Override User Defaults**
+```bash
+# User Defaults: var_cpu=4
+# App Defaults: var_cpu=2
+$ bash pihole-install.sh
+
+# Result: Container gets 2 cores
+# (app-specific setting takes precedence)
+```
+
+**Example 3: All Defaults Missing (Built-ins Used)**
+```bash
+# No environment variables set
+# No app defaults file
+# No user defaults file
+$ bash pihole-install.sh
+
+# Result: Uses built-in defaults
+# (var_cpu might be 2 by default)
+```
+
+### Implementation in Code
+
+```bash
+# Typical pattern in build.func
+
+base_settings() {
+  # Priority 1: Environment variables (already set if export used)
+  CT_TYPE=${var_unprivileged:-"1"}          # Use existing or default
+  
+  # Priority 2: Load app defaults (may override above)
+  if [ -f "$(get_app_defaults_path)" ]; then
+    load_vars_file "$(get_app_defaults_path)"
+  fi
+  
+  # Priority 3: Load user defaults
+  if [ -f "/usr/local/community-scripts/default.vars" ]; then
+    load_vars_file "/usr/local/community-scripts/default.vars"
+  fi
+  
+  # Priority 4: Apply built-in defaults (lowest)
+  CORE_COUNT=${var_cpu:-"${APP_CPU_DEFAULT:-2}"}
+  RAM_SIZE=${var_ram:-"${APP_RAM_DEFAULT:-1024}"}
+  
+  # Result: var_cpu has been set through precedence chain
+}
+```
+
+---
+
+## Data Flow Diagrams
+
+### Installation Flow: Advanced Settings
+
+```
+┌──────────────┐
+│  Start Script│
+└──────┬───────┘
+       │
+       v
+┌──────────────────────────────┐
+│ Display Installation Mode    │
+│ Menu (5 options)             │
+└──────┬───────────────────────┘
+       │ User selects "Advanced Settings"
+       v
+┌──────────────────────────────────┐
+│ Call: base_settings()            │
+│ (Apply built-in defaults)        │
+└──────┬───────────────────────────┘
+       │
+       v
+┌──────────────────────────────────┐
+│ Call: advanced_settings()        │
+│ (Show 19-step wizard)            │
+│ - Ask CPU, RAM, Disk, Network... │
+└──────┬───────────────────────────┘
+       │
+       v
+┌──────────────────────────────────┐
+│ Show Summary                     │
+│ Review all chosen values         │
+└──────┬───────────────────────────┘
+       │ User confirms
+       v
+┌──────────────────────────────────┐
+│ Create Container                 │
+│ Using current variable values    │
+└──────┬───────────────────────────┘
+       │
+       v
+┌──────────────────────────────────┐
+│ Installation Complete            │
+└──────┬───────────────────────────┘
+       │
+       v
+┌──────────────────────────────────────┐
+│ Offer: Save as App Defaults?         │
+│ (Save current settings)              │
+└──────┬───────────────────────────────┘
+       │
+       ├─ YES → Save to defaults/<app>.vars
+       │
+       └─ NO  → Exit
+```
+
+### Variable Resolution Flow
+
+```
+CONTAINER CREATION STARTED
+         │
+         v
+   ┌─────────────────────┐
+   │ Check ENVIRONMENT   │
+   │ for var_cpu, var_..│
+   └──────┬──────────────┘
+          │ Found? Use them (Priority 1)
+          │ Not found? Continue...
+          v
+   ┌──────────────────────────┐
+   │ Load App Defaults        │
+   │ /defaults/<app>.vars     │
+   └──────┬───────────────────┘
+          │ File exists? Parse & load (Priority 2)
+          │ Not found? Continue...
+          v
+   ┌──────────────────────────┐
+   │ Load User Defaults       │
+   │ /default.vars            │
+   └──────┬───────────────────┘
+          │ File exists? Parse & load (Priority 3)
+          │ Not found? Continue...
+          v
+   ┌──────────────────────────┐
+   │ Use Built-in Defaults    │
+   │ (Hardcoded values)       │
+   └──────┬───────────────────┘
+          │
+          v
+   ┌──────────────────────────┐
+   │ All Variables Resolved   │
+   │ Ready for container      │
+   │ creation                 │
+   └──────────────────────────┘
+```
+
+---
+
+## Security Model
+
+### Threat Model
+
+| Threat | Mitigation |
+|--------|-----------|
+| **Arbitrary Code Execution** | No `source` or `eval`; manual parsing only |
+| **Variable Injection** | Whitelist of allowed variable names |
+| **Command Substitution** | `_sanitize_value()` blocks `$()`, backticks, etc. |
+| **Path Traversal** | Files locked to `/usr/local/community-scripts/` |
+| **Permission Escalation** | Files created with restricted permissions |
+| **Information Disclosure** | Sensitive variables not logged |
+
+### Security Controls
+
+#### 1. Input Validation
+
+```bash
+# Only specific variables allowed
+if ! _is_whitelisted_key "$key"; then
+  skip_this_variable
+fi
+
+# Values sanitized
+if ! val="$(_sanitize_value "$value")"; then
+  reject_entire_line
+fi
+```
+
+#### 2. Safe File Parsing
+
+```bash
+# ❌ DANGEROUS (OLD)
+source /path/to/config.conf
+# Could execute: rm -rf / or any code
+
+# ✅ SAFE (NEW)
+load_vars_file "/path/to/config.conf"
+# Only reads var_name=value pairs, no execution
+```
+
+#### 3. Whitelisting
+
+```bash
+# Only these variables can be configured
+var_cpu, var_ram, var_disk, var_brg, ...
+var_hostname, var_pw, var_ssh, ...
+
+# NOT allowed:
+var_malicious, var_hack, custom_var, ...
+```
+
+#### 4. Value Constraints
+
+```bash
+# No command injection patterns
+if [[ "$value" =~ ($|`|;|&|<\() ]]; then
+  reject_value
+fi
+```
+
+---
+
+## Implementation Details
+
+### Module: `build.func`
+
+**Load Order** (in actual scripts):
+1. `#!/usr/bin/env bash` - Shebang
+2. `source /dev/stdin <<<$(curl ... api.func)` - API functions
+3. `source /dev/stdin <<<$(curl ... build.func)` - Build functions
+4. `variables()` - Initialize variables
+5. `check_root()` - Security check
+6. `install_script()` - Main flow
+
+**Key Sections**:
+
+```bash
+# Section 1: Initialization & Variables
+- variables()
+- NSAPP, var_install, INTEGER pattern, etc.
+
+# Section 2: Storage Management
+- storage_selector()
+- ensure_storage_selection_for_vars_file()
+
+# Section 3: Base Settings
+- base_settings()          # Apply defaults to all var_*
+- echo_default()           # Display current settings
+
+# Section 4: Variable Loading
+- load_vars_file()         # Safe parsing
+- _is_whitelisted_key()    # Validation
+- _sanitize_value()        # Threat mitigation
+
+# Section 5: Defaults Management
+- default_var_settings()   # Load user defaults
+- get_app_defaults_path()  # Get app defaults path
+- maybe_offer_save_app_defaults()  # Save option
+
+# Section 6: Installation Flow
+- install_script()         # Main entry point
+- advanced_settings()      # 19-step wizard
+```
+
+### Regex Patterns Used
+
+| Pattern | Purpose | Example Match |
+|---------|---------|---|
+| `^[0-9]+([.][0-9]+)?$` | Integer validation | `4`, `192.168` |
+| `^var_[a-z_]+$` | Variable name | `var_cpu`, `var_ssh` |
+| `*'$('*` | Command substitution | `$(whoami)` |
+| `*\`*` | Backtick substitution | `` `cat /etc/passwd` `` |
+
+---
+
+## Appendix: Migration Reference
+
+### Old Pattern (Deprecated)
+
+```bash
+# ❌ OLD: config-file.func
+source config-file.conf          # Executes arbitrary code
+if [ "$USE_DEFAULTS" = "yes" ]; then
+  apply_settings_directly
+fi
+```
+
+### New Pattern (Current)
+
+```bash
+# ✅ NEW: load_vars_file()
+if load_vars_file "$(get_app_defaults_path)"; then
+  echo "Settings loaded securely"
+fi
+```
+
+### Function Mapping
+
+| Old | New | Location |
+|-----|-----|----------|
+| `read_config()` | `load_vars_file()` | build.func |
+| `write_config()` | `_build_current_app_vars_tmp()` | build.func |
+| None | `maybe_offer_save_app_defaults()` | build.func |
+| None | `get_app_defaults_path()` | build.func |
+
+---
+
+**End of Technical Reference**
--- a/docs/api/README.md
+++ b/docs/api/README.md
@ -0,0 +1,146 @@
+# API Integration Documentation (/api)
+
+This directory contains comprehensive documentation for API integration and the `/api` directory.
+
+## Overview
+
+The `/api` directory contains the Proxmox Community Scripts API backend for diagnostic reporting, telemetry, and analytics integration.
+
+## Key Components
+
+### Main API Service
+Located in `/api/main.go`:
+- RESTful API for receiving telemetry data
+- Installation statistics tracking
+- Error reporting and analytics
+- Performance monitoring
+
+### Integration with Scripts
+The API is integrated into all installation scripts via `api.func`:
+- Sends installation start/completion events
+- Reports errors and exit codes
+- Collects anonymous usage statistics
+- Enables project analytics
+
+## Documentation Structure
+
+API documentation covers:
+- API endpoint specifications
+- Integration methods
+- Data formats and schemas
+- Error handling
+- Privacy and data handling
+
+## Key Resources
+
+- **[misc/api.func/](../misc/api.func/)** - API function library documentation
+- **[misc/api.func/README.md](../misc/api.func/README.md)** - Quick reference
+- **[misc/api.func/API_FUNCTIONS_REFERENCE.md](../misc/api.func/API_FUNCTIONS_REFERENCE.md)** - Complete function reference
+
+## API Functions
+
+The `api.func` library provides:
+
+### `post_to_api()`
+Send container installation data to API.
+
+**Usage**:
+```bash
+post_to_api CTID STATUS APP_NAME
+```
+
+### `post_update_to_api()`
+Report application update status.
+
+**Usage**:
+```bash
+post_update_to_api CTID APP_NAME VERSION
+```
+
+### `get_error_description()`
+Get human-readable error description from exit code.
+
+**Usage**:
+```bash
+ERROR_DESC=$(get_error_description EXIT_CODE)
+```
+
+## API Integration Points
+
+### In Container Creation (`ct/AppName.sh`)
+- Called by build.func to report container creation
+- Sends initial container setup data
+- Reports success or failure
+
+### In Installation Scripts (`install/appname-install.sh`)
+- Called at start of installation
+- Called on installation completion
+- Called on error conditions
+
+### Data Collected
+- Container/VM ID
+- Application name and version
+- Installation duration
+- Success/failure status
+- Error codes (if failure)
+- Anonymous usage metrics
+
+## Privacy
+
+All API data:
+- ✅ Anonymous (no personal data)
+- ✅ Aggregated for statistics
+- ✅ Used only for project improvement
+- ✅ No tracking of user identities
+- ✅ Can be disabled if desired
+
+## API Architecture
+
+```
+Installation Scripts
+    │
+    ├─ Call: api.func functions
+    │
+    └─ POST to: https://api.community-scripts.org
+                │
+                ├─ Receives data
+                ├─ Validates format
+                ├─ Stores metrics
+                └─ Aggregates statistics
+                    │
+                    └─ Used for:
+                       ├─ Download tracking
+                       ├─ Error trending
+                       ├─ Feature usage stats
+                       └─ Project health monitoring
+```
+
+## Common API Tasks
+
+- **Enable API reporting** → Built-in by default, no configuration needed
+- **Disable API** → Set `api_disable="yes"` before running
+- **View API data** → Visit https://community-scripts.org/stats
+- **Report API errors** → [GitHub Issues](https://github.com/community-scripts/ProxmoxVE/issues)
+
+## Debugging API Issues
+
+If API calls fail:
+1. Check internet connectivity
+2. Verify API endpoint availability
+3. Review error codes in [EXIT_CODES.md](../EXIT_CODES.md)
+4. Check API function logs
+5. Report issues on GitHub
+
+## API Endpoint
+
+**Base URL**: `https://api.community-scripts.org`
+
+**Endpoints**:
+- `POST /install` - Report container installation
+- `POST /update` - Report application update
+- `GET /stats` - Public statistics
+
+---
+
+**Last Updated**: December 2025
+**Maintainers**: community-scripts team
--- a/docs/contribution/CODE-AUDIT.md
+++ b/docs/contribution/CODE-AUDIT.md
@ -0,0 +1,14 @@
+<div align="center">
+<img src="https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/images/logo.png" height="100px" />
+</div>
+<h2><div align="center">Exploring the Scripts and Steps Involved in an Application LXC Installation</div></h2>
+
+1) [adguard.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/adguard.sh): This script collects system parameters. (Also holds the function to update the application.)
+2) [build.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/build.func): Adds user settings and integrates collected information.
+3) [create_lxc.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/create_lxc.sh): Constructs the LXC container.
+4) [adguard-install.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/install/adguard-install.sh): Executes functions from [install.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/install.func), and installs the application.
+5) [adguard.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/adguard.sh) (again): To display the completion message.
+
+The installation process uses reusable scripts: [build.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/build.func), [create_lxc.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/create_lxc.sh), and [install.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/install.func), which are not specific to any particular application.
+
+To gain a better understanding, focus on reviewing [adguard-install.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/install/adguard-install.sh). This script contains the commands and configurations for installing and configuring AdGuard Home within the LXC container.
--- a/docs/contribution/CONTRIBUTING.md
+++ b/docs/contribution/CONTRIBUTING.md
@ -0,0 +1,106 @@
+
+# Community Scripts Contribution Guide
+
+## **Welcome to the communty-scripts Repository!** 
+
+📜 These documents outline the essential coding standards for all our scripts and JSON files. Adhering to these standards ensures that our codebase remains consistent, readable, and maintainable. By following these guidelines, we can improve collaboration, reduce errors, and enhance the overall quality of our project.
+
+### Why Coding Standards Matter
+
+Coding standards are crucial for several reasons:
+
+1. **Consistency**: Consistent code is easier to read, understand, and maintain. It helps new team members quickly get up to speed and reduces the learning curve.
+2. **Readability**: Clear and well-structured code is easier to debug and extend. It allows developers to quickly identify and fix issues.
+3. **Maintainability**: Code that follows a standard structure is easier to refactor and update. It ensures that changes can be made with minimal risk of introducing new bugs.
+4. **Collaboration**: When everyone follows the same standards, it becomes easier to collaborate on code. It reduces friction and misunderstandings during code reviews and merges.
+
+### Scope of These Documents
+
+These documents cover the coding standards for the following types of files in our project:
+
+- **`install/$AppName-install.sh` Scripts**: These scripts are responsible for the installation of applications.
+- **`ct/$AppName.sh` Scripts**: These scripts handle the creation and updating of containers.
+- **`json/$AppName.json`**: These files store structured data and are used for the website.
+
+Each section provides detailed guidelines on various aspects of coding, including shebang usage, comments, variable naming, function naming, indentation, error handling, command substitution, quoting, script structure, and logging. Additionally, examples are provided to illustrate the application of these standards.
+
+By following the coding standards outlined in this document, we ensure that our scripts and JSON files are of high quality, making our project more robust and easier to manage. Please refer to this guide whenever you create or update scripts and JSON files to maintain a high standard of code quality across the project. 📚🔍
+
+Let's work together to keep our codebase clean, efficient, and maintainable! 💪🚀
+
+
+## Getting Started
+
+Before contributing, please ensure that you have the following setup:
+
+1. **Visual Studio Code** (recommended for script development)
+2. **Recommended VS Code Extensions:**
+   - [Shell Syntax](https://marketplace.visualstudio.com/items?itemName=bmalehorn.shell-syntax)
+   - [ShellCheck](https://marketplace.visualstudio.com/items?itemName=timonwong.shellcheck)
+   - [Shell Format](https://marketplace.visualstudio.com/items?itemName=foxundermoon.shell-format)
+
+### Important Notes
+- Use [AppName.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/ct/AppName.sh) and [AppName-install.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/install/AppName-install.sh) as templates when creating new scripts.
+
+---
+
+# 🚀 The Application Script (ct/AppName.sh)
+
+- You can find all coding standards, as well as the structure for this file [here](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/ct/AppName.md).
+- These scripts are responsible for container creation, setting the necessary variables and handling the update of the application once installed.
+
+---
+
+# 🛠 The Installation Script (install/AppName-install.sh)
+
+- You can find all coding standards, as well as the structure for this file [here](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/install/AppName-install.md).
+- These scripts are responsible for the installation of the application.
+
+---
+
+## 🚀 Building Your Own Scripts
+
+Start with the [template script](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/install/AppName-install.sh)
+
+---
+
+## 🤝 Contribution Process
+
+### 1. Fork the repository
+Fork to your GitHub account
+
+### 2. Clone your fork on your local environment 
+```bash
+git clone https://github.com/yourUserName/ForkName
+```
+
+### 3. Create a new branch
+```bash
+git switch -c your-feature-branch
+```
+
+### 4. Change paths in build.func install.func and AppName.sh
+To be able to develop from your own branch you need to change `https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main` to `https://raw.githubusercontent.com/[USER]/[REPOSITORY]/refs/heads/[BRANCH]`. You need to make this change atleast in misc/build.func misc/install.func and in your ct/AppName.sh. This change is only for testing. Before opening a Pull Request you should change this line change all this back to point to `https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main`.
+
+### 4. Commit changes (without build.func and install.func!)
+```bash
+git commit -m "Your commit message"
+```
+
+### 5. Push to your fork
+```bash
+git push origin your-feature-branch
+```
+
+### 6. Create a Pull Request
+Open a Pull Request from your feature branch to the main repository branch. You must only include your **$AppName.sh**, **$AppName-install.sh** and **$AppName.json** files in the pull request.
+
+---
+
+## 📚 Pages
+
+- [CT Template: AppName.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/ct/AppName.sh)
+- [Install Template: AppName-install.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/install/AppName-install.sh)
+- [JSON Template: AppName.json](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/json/AppName.json)
+
+
--- a/docs/contribution/FORK_SETUP.md
+++ b/docs/contribution/FORK_SETUP.md
@ -0,0 +1,186 @@
+# 🍴 Fork Setup Guide
+
+**Just forked ProxmoxVE? Run this first!**
+
+## Quick Start
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
+cd ProxmoxVE
+
+# Run setup script (auto-detects your username from git)
+bash setup-fork.sh
+```
+
+That's it! ✅
+
+---
+
+## What Does It Do?
+
+The `setup-fork.sh` script automatically:
+
+1. **Detects** your GitHub username from git config
+2. **Updates** 22 hardcoded links in documentation to point to your fork
+3. **Creates** `.git-setup-info` with recommended git workflows
+4. **Backs up** all modified files (*.backup)
+
+---
+
+## Usage
+
+### Auto-Detect (Recommended)
+```bash
+bash setup-fork.sh
+```
+Automatically reads your GitHub username from `git remote origin url`
+
+### Specify Username
+```bash
+bash setup-fork.sh john
+```
+Updates links to `github.com/john/ProxmoxVE`
+
+### Custom Repository Name
+```bash
+bash setup-fork.sh john my-fork
+```
+Updates links to `github.com/john/my-fork`
+
+---
+
+## What Gets Updated?
+
+The script updates these documentation files:
+- `docs/CONTRIBUTION_GUIDE.md` (4 links)
+- `docs/README.md` (1 link)
+- `docs/INDEX.md` (3 links)
+- `docs/EXIT_CODES.md` (2 links)
+- `docs/DEFAULTS_SYSTEM_GUIDE.md` (2 links)
+- `docs/api/README.md` (1 link)
+- `docs/APP-ct.md` (1 link)
+- `docs/APP-install.md` (1 link)
+- `docs/alpine-install.func.md` (2 links)
+- `docs/install.func.md` (1 link)
+- And code examples in documentation
+
+---
+
+## After Setup
+
+1. **Review changes**
+   ```bash
+   git diff docs/
+   ```
+
+2. **Read git workflow tips**
+   ```bash
+   cat .git-setup-info
+   ```
+
+3. **Start contributing**
+   ```bash
+   git checkout -b feature/my-app
+   # Make your changes...
+   git commit -m "feat: add my awesome app"
+   ```
+
+4. **Follow the guide**
+   ```bash
+   cat docs/CONTRIBUTION_GUIDE.md
+   ```
+
+---
+
+## Common Workflows
+
+### Keep Your Fork Updated
+```bash
+# Add upstream if you haven't already
+git remote add upstream https://github.com/community-scripts/ProxmoxVE.git
+
+# Get latest from upstream
+git fetch upstream
+git rebase upstream/main
+git push origin main
+```
+
+### Create a Feature Branch
+```bash
+git checkout -b feature/docker-improvements
+# Make changes...
+git push origin feature/docker-improvements
+# Then create PR on GitHub
+```
+
+### Sync Before Contributing
+```bash
+git fetch upstream
+git rebase upstream/main
+git push -f origin main  # Update your fork's main
+git checkout -b feature/my-feature
+```
+
+---
+
+## Troubleshooting
+
+### "Git is not installed" or "not a git repository"
+```bash
+# Make sure you cloned the repo first
+git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
+cd ProxmoxVE
+bash setup-fork.sh
+```
+
+### "Could not auto-detect GitHub username"
+```bash
+# Your git origin URL isn't set up correctly
+git remote -v
+# Should show your fork URL, not community-scripts
+
+# Fix it:
+git remote set-url origin https://github.com/YOUR_USERNAME/ProxmoxVE.git
+bash setup-fork.sh
+```
+
+### "Permission denied"
+```bash
+# Make script executable
+chmod +x setup-fork.sh
+bash setup-fork.sh
+```
+
+### Reverted Changes by Accident?
+```bash
+# Backups are created automatically
+git checkout docs/*.backup
+# Or just re-run setup-fork.sh
+```
+
+---
+
+## Next Steps
+
+1. ✅ Run `bash setup-fork.sh`
+2. 📖 Read [docs/CONTRIBUTION_GUIDE.md](docs/CONTRIBUTION_GUIDE.md)
+3. 🍴 Choose your contribution path:
+   - **Containers** → [docs/ct/README.md](docs/ct/README.md)
+   - **Installation** → [docs/install/README.md](docs/install/README.md)
+   - **VMs** → [docs/vm/README.md](docs/vm/README.md)
+   - **Tools** → [docs/tools/README.md](docs/tools/README.md)
+4. 💻 Create your feature branch and contribute!
+
+---
+
+## Questions?
+
+- **Fork Setup Issues?** → See [Troubleshooting](#troubleshooting) above
+- **How to Contribute?** → [docs/CONTRIBUTION_GUIDE.md](docs/CONTRIBUTION_GUIDE.md)
+- **Git Workflows?** → `cat .git-setup-info`
+- **Project Structure?** → [docs/README.md](docs/README.md)
+
+---
+
+**Happy Contributing! 🚀**
--- a/docs/contribution/GUIDE.md
+++ b/docs/contribution/GUIDE.md
--- a/docs/contribution/README.md
+++ b/docs/contribution/README.md
@ -0,0 +1,341 @@
+# 🤝 Contributing to ProxmoxVE
+
+Complete guide to contributing to the ProxmoxVE project - from your first fork to submitting your pull request.
+
+---
+
+## 📋 Table of Contents
+
+- [Quick Start](#quick-start)
+- [Setting Up Your Fork](#setting-up-your-fork)
+- [Coding Standards](#coding-standards)
+- [Code Audit](#code-audit)
+- [Guides & Resources](#guides--resources)
+- [FAQ](#faq)
+
+---
+
+## 🚀 Quick Start
+
+### 60 Seconds to Contributing
+
+```bash
+# 1. Fork on GitHub
+# Visit: https://github.com/community-scripts/ProxmoxVE → Fork (top right)
+
+# 2. Clone your fork
+git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
+cd ProxmoxVE
+
+# 3. Auto-configure your fork
+bash docs/contribution/setup-fork.sh
+
+# 4. Create a feature branch
+git checkout -b feature/my-awesome-app
+
+# 5. Read the guides
+cat docs/README.md              # Documentation overview
+cat docs/ct/DETAILED_GUIDE.md   # For container scripts
+cat docs/install/DETAILED_GUIDE.md  # For install scripts
+
+# 6. Create your contribution
+cp ct/example.sh ct/myapp.sh
+cp install/example-install.sh install/myapp-install.sh
+# ... edit files ...
+
+# 7. Test and commit
+bash ct/myapp.sh
+git add ct/myapp.sh install/myapp-install.sh
+git commit -m "feat: add MyApp"
+git push origin feature/my-awesome-app
+
+# 8. Create Pull Request on GitHub
+```
+
+---
+
+## 🍴 Setting Up Your Fork
+
+### Automatic Setup (Recommended)
+
+When you clone your fork, run the setup script to automatically configure everything:
+
+```bash
+bash docs/contribution/setup-fork.sh
+```
+
+This will:
+- Auto-detect your GitHub username
+- Update all documentation links to point to your fork
+- Create `.git-setup-info` with recommended git workflows
+
+**See**: [FORK_SETUP.md](FORK_SETUP.md) for detailed instructions
+
+### Manual Setup
+
+If the script doesn't work, manually configure:
+
+```bash
+# Set git user
+git config user.name "Your Name"
+git config user.email "your.email@example.com"
+
+# Add upstream remote for syncing
+git remote add upstream https://github.com/community-scripts/ProxmoxVE.git
+
+# Verify remotes
+git remote -v
+```
+
+---
+
+## 📖 Coding Standards
+
+All scripts and configurations must follow our coding standards to ensure consistency and quality.
+
+### Available Guides
+
+- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Essential coding standards and best practices
+- **[CODE_AUDIT.md](CODE_AUDIT.md)** - Code review checklist and audit procedures
+- **Container Scripts** - `/ct/` templates and guidelines
+- **Install Scripts** - `/install/` templates and guidelines
+- **JSON Configurations** - `/json/` structure and format
+
+### Quick Checklist
+
+- ✅ Use `/ct/example.sh` as template for container scripts
+- ✅ Use `/install/example-install.sh` as template for install scripts
+- ✅ Follow naming conventions: `appname.sh` and `appname-install.sh`
+- ✅ Include proper shebang: `#!/usr/bin/env bash`
+- ✅ Add copyright header with author
+- ✅ Handle errors properly with `msg_error`, `msg_ok`, etc.
+- ✅ Test before submitting PR
+- ✅ Update documentation if needed
+
+---
+
+## 🔍 Code Audit
+
+Before submitting a pull request, ensure your code passes our audit:
+
+**See**: [CODE_AUDIT.md](CODE_AUDIT.md) for complete audit checklist
+
+Key points:
+- Code consistency with existing scripts
+- Proper error handling
+- Correct variable naming
+- Adequate comments and documentation
+- Security best practices
+
+---
+
+## 📚 Guides & Resources
+
+### Documentation
+
+- **[docs/README.md](../README.md)** - Main documentation hub
+- **[docs/ct/README.md](../ct/README.md)** - Container scripts overview
+- **[docs/install/README.md](../install/README.md)** - Installation scripts overview
+- **[docs/ct/DETAILED_GUIDE.md](../ct/DETAILED_GUIDE.md)** - Complete ct/ script reference
+- **[docs/install/DETAILED_GUIDE.md](../install/DETAILED_GUIDE.md)** - Complete install/ script reference
+- **[docs/TECHNICAL_REFERENCE.md](../TECHNICAL_REFERENCE.md)** - Architecture deep-dive
+- **[docs/EXIT_CODES.md](../EXIT_CODES.md)** - Exit codes reference
+- **[docs/DEV_MODE.md](../DEV_MODE.md)** - Debugging guide
+
+### Community Guides
+
+See [USER_SUBMITTED_GUIDES.md](USER_SUBMITTED_GUIDES.md) for excellent community-written guides:
+- Home Assistant installation and configuration
+- Frigate setup on Proxmox
+- Docker and Portainer installation
+- Database setup and optimization
+- And many more!
+
+### Templates
+
+Use these templates when creating new scripts:
+
+```bash
+# Container script
+cp ct/example.sh ct/my-app.sh
+
+# Installation script
+cp install/example-install.sh install/my-app-install.sh
+
+# JSON configuration (if needed)
+cp json/example.json json/my-app.json
+```
+
+---
+
+## 🔄 Git Workflow
+
+### Keep Your Fork Updated
+
+```bash
+# Fetch latest from upstream
+git fetch upstream
+
+# Rebase your work on latest main
+git rebase upstream/main
+
+# Push to your fork
+git push -f origin main
+```
+
+### Create Feature Branch
+
+```bash
+# Create and switch to new branch
+git checkout -b feature/my-feature
+
+# Make changes...
+git add .
+git commit -m "feat: description of changes"
+
+# Push to your fork
+git push origin feature/my-feature
+
+# Create Pull Request on GitHub
+```
+
+### Before Submitting PR
+
+1. **Sync with upstream**
+   ```bash
+   git fetch upstream
+   git rebase upstream/main
+   ```
+
+2. **Test your changes**
+   ```bash
+   bash ct/my-app.sh
+   # Follow prompts and test the container
+   ```
+
+3. **Check code standards**
+   - [ ] Follows template structure
+   - [ ] Proper error handling
+   - [ ] Documentation updated (if needed)
+   - [ ] No hardcoded values
+   - [ ] Version tracking implemented
+
+4. **Push final changes**
+   ```bash
+   git push origin feature/my-feature
+   ```
+
+---
+
+## 📋 Pull Request Checklist
+
+Before opening a PR:
+
+- [ ] Code follows coding standards (see CONTRIBUTING.md)
+- [ ] All templates used correctly
+- [ ] Tested on Proxmox VE
+- [ ] Error handling implemented
+- [ ] Documentation updated (if applicable)
+- [ ] No merge conflicts
+- [ ] Synced with upstream/main
+- [ ] Clear PR title and description
+
+---
+
+## ❓ FAQ
+
+### How do I test my changes?
+
+```bash
+# For container scripts
+bash ct/my-app.sh
+
+# For install scripts (runs inside container)
+# The ct script will call it automatically
+
+# For advanced debugging
+VERBOSE=yes bash ct/my-app.sh
+```
+
+### What if my PR has conflicts?
+
+```bash
+# Sync with upstream
+git fetch upstream
+git rebase upstream/main
+
+# Resolve conflicts in your editor
+git add .
+git rebase --continue
+git push -f origin your-branch
+```
+
+### How do I keep my fork updated?
+
+See "Keep Your Fork Updated" section above, or run:
+
+```bash
+bash docs/contribution/setup-fork.sh
+```
+
+### Where do I ask questions?
+
+- **GitHub Issues**: For bugs and feature requests
+- **GitHub Discussions**: For general questions
+- **Discord**: Community-scripts server
+
+---
+
+## 🎓 Learning Resources
+
+### For First-Time Contributors
+
+1. Read: [docs/README.md](../README.md) - Documentation overview
+2. Read: [docs/contribution/FORK_SETUP.md](FORK_SETUP.md) - Fork setup guide
+3. Choose your path:
+   - Containers → [docs/ct/DETAILED_GUIDE.md](../ct/DETAILED_GUIDE.md)
+   - Installation → [docs/install/DETAILED_GUIDE.md](../install/DETAILED_GUIDE.md)
+4. Study existing scripts in same category
+5. Create your contribution
+
+### For Experienced Developers
+
+1. Review [CONTRIBUTING.md](CONTRIBUTING.md) - Coding standards
+2. Review [CODE_AUDIT.md](CODE_AUDIT.md) - Audit checklist
+3. Check templates in `/ct/` and `/install/`
+4. Submit PR with confidence
+
+### For Reviewers/Maintainers
+
+1. Use [CODE_AUDIT.md](CODE_AUDIT.md) as review guide
+2. Reference [docs/TECHNICAL_REFERENCE.md](../TECHNICAL_REFERENCE.md) for architecture
+3. Check [docs/EXIT_CODES.md](../EXIT_CODES.md) for error handling
+
+---
+
+## 🚀 Ready to Contribute?
+
+1. **Fork** the repository
+2. **Clone** your fork and **setup** with `bash docs/contribution/setup-fork.sh`
+3. **Choose** your contribution type (container, installation, tools, etc.)
+4. **Read** the appropriate detailed guide
+5. **Create** your feature branch
+6. **Develop** and **test** your changes
+7. **Commit** with clear messages
+8. **Push** to your fork
+9. **Create** Pull Request
+
+---
+
+## 📞 Contact & Support
+
+- **GitHub**: https://github.com/community-scripts/ProxmoxVE
+- **Issues**: https://github.com/community-scripts/ProxmoxVE/issues
+- **Discussions**: https://github.com/community-scripts/ProxmoxVE/discussions
+- **Discord**: [Join Server](https://discord.gg/UHrpNWGwkH)
+
+---
+
+**Thank you for contributing to ProxmoxVE!** 🙏
+
+Your efforts help make Proxmox VE automation accessible to everyone. Happy coding! 🚀
--- a/Show More
+++ b/Show More