docs(contribution): update templates with modern patterns

Based on analysis of latest 30 scripts (koel, wallabag, invoiceninja, etc.)

Templates updated to reflect current best practices:

ct/AppName.sh:
- Use check_for_gh_release + fetch_and_deploy_gh_release pattern
- CLEAN_INSTALL=1 for updates
- Proper backup/restore workflow
- Simplified configuration comments

install/AppName-install.sh:
- fetch_and_deploy_gh_release as primary download method (no separate RELEASE variable)
- Real-world examples from Node.js, Python, PHP apps
- import_local_ip called early
- Setup runtimes/databases before app installation
- cleanup_lxc at the end

HELPER_FUNCTIONS.md:
- fetch_and_deploy_gh_release as preferred method (documented first)
- CLEAN_INSTALL=1 environment variable documented
- prebuild type with asset_pattern documented
- Clarified when to use get_latest_github_release vs fetch_and_deploy

Closes #10194

.github/pull_request_template.md

@@ -3,6 +3,7 @@ PRs without prior testing will be closed. -->
 
 ## ✍️ Description
 
+
 ## 🔗 Related Issue
 
 Fixes #

CHANGELOG.md

@@ -10,8 +10,265 @@
 > [!CAUTION]
 Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit the project's popularity for potentially malicious purposes.
 
+## 2025-12-22
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Kometa: Fix update procedure [@tremor021](https://github.com/tremor021) ([#10217](https://github.com/community-scripts/ProxmoxVE/pull/10217))
+
+### ❔ Uncategorized
+
+  - Invoice ninja [@DragoQC](https://github.com/DragoQC) ([#10223](https://github.com/community-scripts/ProxmoxVE/pull/10223))
+
+## 2025-12-21
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Typo fix in Heimdall install script [@Turcid-uwu](https://github.com/Turcid-uwu) ([#10187](https://github.com/community-scripts/ProxmoxVE/pull/10187))
+
+  - #### ✨ New Features
+
+    - recyclarr: add default daily cron job for recyclarr sync [@MickLesk](https://github.com/MickLesk) ([#10208](https://github.com/community-scripts/ProxmoxVE/pull/10208))
+
+  - #### 🔧 Refactor
+
+    - Optimize Jotty installation with standalone mode [@MickLesk](https://github.com/MickLesk) ([#10207](https://github.com/community-scripts/ProxmoxVE/pull/10207))
+    - unifi: remove mongodb 4.4 support | bump to java 21 [@MickLesk](https://github.com/MickLesk) ([#10206](https://github.com/community-scripts/ProxmoxVE/pull/10206))
+    - Refactor: Backrest [@tremor021](https://github.com/tremor021) ([#10193](https://github.com/community-scripts/ProxmoxVE/pull/10193))
+
+### 💾 Core
+
+  - #### ✨ New Features
+
+    - Fix AMD GPU firmware installation by adding non-free repositories [@MickLesk](https://github.com/MickLesk) ([#10205](https://github.com/community-scripts/ProxmoxVE/pull/10205))
+
+### 🧰 Tools
+
+  - pihole-exporter ([#10091](https://github.com/community-scripts/ProxmoxVE/pull/10091))
+
+## 2025-12-20
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Update Technitium DNS and Restart Service [@DrEVILish](https://github.com/DrEVILish) ([#10181](https://github.com/community-scripts/ProxmoxVE/pull/10181))
+    - bump: ersatztv: deb13 [@CrazyWolf13](https://github.com/CrazyWolf13) ([#10174](https://github.com/community-scripts/ProxmoxVE/pull/10174))
+
+## 2025-12-19
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Update Reitti to Java 25 for 3.0.0 compatibility [@Copilot](https://github.com/Copilot) ([#10164](https://github.com/community-scripts/ProxmoxVE/pull/10164))
+    - Bump Bar-Assistant to php 8.4 [@MickLesk](https://github.com/MickLesk) ([#10138](https://github.com/community-scripts/ProxmoxVE/pull/10138))
+    - Zabbix: Add version-specific SQL script path for 7.0 LTS [@MickLesk](https://github.com/MickLesk) ([#10142](https://github.com/community-scripts/ProxmoxVE/pull/10142))
+    - InfluxDB: Fix update function [@Liganic](https://github.com/Liganic) ([#10151](https://github.com/community-scripts/ProxmoxVE/pull/10151))
+
+  - #### ✨ New Features
+
+    - Bump Immich to v2.4.1 [@vhsdream](https://github.com/vhsdream) ([#10154](https://github.com/community-scripts/ProxmoxVE/pull/10154))
+
+  - #### 🔧 Refactor
+
+    - Refactor: Cosmos: + Upgrade to Debian 13  [@MickLesk](https://github.com/MickLesk) ([#10147](https://github.com/community-scripts/ProxmoxVE/pull/10147))
+    - Refactor: Proxmox-Mail-Gateway [@tremor021](https://github.com/tremor021) ([#10070](https://github.com/community-scripts/ProxmoxVE/pull/10070))
+
+### 💾 Core
+
+  - #### ✨ New Features
+
+    - core: Auto-cleanup after all update_script executions [@MickLesk](https://github.com/MickLesk) ([#10141](https://github.com/community-scripts/ProxmoxVE/pull/10141))
+
+### 🧰 Tools
+
+  - #### 🔧 Refactor
+
+    - fix: removed verbose option to avoid unnecessary output [@wolle604](https://github.com/wolle604) ([#10144](https://github.com/community-scripts/ProxmoxVE/pull/10144))
+
+### ❔ Uncategorized
+
+  - Update paymenter.json(#10133) [@DragoQC](https://github.com/DragoQC) ([#10134](https://github.com/community-scripts/ProxmoxVE/pull/10134))
+
+## 2025-12-18
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - [HOTFIX] Fix Scanopy release check [@vhsdream](https://github.com/vhsdream) ([#10097](https://github.com/community-scripts/ProxmoxVE/pull/10097))
+    - Fix cleanup issues in npm cache and rustup toolchain [@MickLesk](https://github.com/MickLesk) ([#10107](https://github.com/community-scripts/ProxmoxVE/pull/10107))
+    - Fix Zabbix 7.0 repository URL structure [@MickLesk](https://github.com/MickLesk) ([#10106](https://github.com/community-scripts/ProxmoxVE/pull/10106))
+
+  - #### ✨ New Features
+
+    - bump pihole to debian 13 [@mschabhuettl](https://github.com/mschabhuettl) ([#10118](https://github.com/community-scripts/ProxmoxVE/pull/10118))
+    - Immich: v2.4.0 [@vhsdream](https://github.com/vhsdream) ([#10095](https://github.com/community-scripts/ProxmoxVE/pull/10095))
+
+### 💾 Core
+
+  - #### 🔧 Refactor
+
+    - tools.func: hardening/Improve error handling and cleanup in shell functions [@MickLesk](https://github.com/MickLesk) ([#10116](https://github.com/community-scripts/ProxmoxVE/pull/10116))
+
+### 🧰 Tools
+
+  - qbittorrent-exporter ([#10090](https://github.com/community-scripts/ProxmoxVE/pull/10090))
+
+  - #### 🐞 Bug Fixes
+
+    - Improved error handling when a command does not exist [@wolle604](https://github.com/wolle604) ([#10089](https://github.com/community-scripts/ProxmoxVE/pull/10089))
+
+## 2025-12-17
+
+### 🚀 Updated Scripts
+
+  - Tracktor: updated environment variables for latest release [@javedh-dev](https://github.com/javedh-dev) ([#10067](https://github.com/community-scripts/ProxmoxVE/pull/10067))
+
+  - #### 🐞 Bug Fixes
+
+    - Semaphore: Fix release binary package fetching [@tremor021](https://github.com/tremor021) ([#10055](https://github.com/community-scripts/ProxmoxVE/pull/10055))
+    - update github repo for endurain [@johanngrobe](https://github.com/johanngrobe) ([#10074](https://github.com/community-scripts/ProxmoxVE/pull/10074))
+
+  - #### ✨ New Features
+
+    - use setup_hwaccel for robust hardware acceleration [@MickLesk](https://github.com/MickLesk) ([#10054](https://github.com/community-scripts/ProxmoxVE/pull/10054))
+    - add hardware acceleration support for 17 additional apps [@MickLesk](https://github.com/MickLesk) ([#10061](https://github.com/community-scripts/ProxmoxVE/pull/10061))
+
+  - #### 🔧 Refactor
+
+    - Telegraf: Small refactor [@tremor021](https://github.com/tremor021) ([#10056](https://github.com/community-scripts/ProxmoxVE/pull/10056))
+    - Refactor: Salt [@tremor021](https://github.com/tremor021) ([#10057](https://github.com/community-scripts/ProxmoxVE/pull/10057))
+    - Refactor: Resilio Sync [@tremor021](https://github.com/tremor021) ([#10058](https://github.com/community-scripts/ProxmoxVE/pull/10058))
+    - Refactor: Reitti [@tremor021](https://github.com/tremor021) ([#10059](https://github.com/community-scripts/ProxmoxVE/pull/10059))
+    - Refactor: Redis [@tremor021](https://github.com/tremor021) ([#10060](https://github.com/community-scripts/ProxmoxVE/pull/10060))
+    - Refactor: Reactive-Resume [@tremor021](https://github.com/tremor021) ([#10062](https://github.com/community-scripts/ProxmoxVE/pull/10062))
+    - Refactor: RDTClient [@tremor021](https://github.com/tremor021) ([#10064](https://github.com/community-scripts/ProxmoxVE/pull/10064))
+    - Refactor: RabbitMQ [@tremor021](https://github.com/tremor021) ([#10065](https://github.com/community-scripts/ProxmoxVE/pull/10065))
+    - Qdrant: Code cleanup [@tremor021](https://github.com/tremor021) ([#10066](https://github.com/community-scripts/ProxmoxVE/pull/10066))
+    - Refactor: Pterodactyl Wings [@tremor021](https://github.com/tremor021) ([#10069](https://github.com/community-scripts/ProxmoxVE/pull/10069))
+
+## 2025-12-16
+
+### 🆕 New Scripts
+
+  - [REFACTOR]: NetVisor => Scanopy [@vhsdream](https://github.com/vhsdream) ([#10011](https://github.com/community-scripts/ProxmoxVE/pull/10011))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - zabbix: fix repo url after change [@MickLesk](https://github.com/MickLesk) ([#10042](https://github.com/community-scripts/ProxmoxVE/pull/10042))
+    - Fix: mariadb repo in update_scripts [@MickLesk](https://github.com/MickLesk) ([#10034](https://github.com/community-scripts/ProxmoxVE/pull/10034))
+    - 2fauth: update PHP version from 8.3 to 8.4 in update_script [@MickLesk](https://github.com/MickLesk) ([#10035](https://github.com/community-scripts/ProxmoxVE/pull/10035))
+    - pdm: add rsyslog to fix /dev/log Connection refused errors [@MickLesk](https://github.com/MickLesk) ([#10018](https://github.com/community-scripts/ProxmoxVE/pull/10018))
+    - 2fauth: bump to php8.4 [@MickLesk](https://github.com/MickLesk) ([#10019](https://github.com/community-scripts/ProxmoxVE/pull/10019))
+    - Miniflux: use correct systemctl to check service instead of file path [@MickLesk](https://github.com/MickLesk) ([#10024](https://github.com/community-scripts/ProxmoxVE/pull/10024))
+    - PhotoPrism: export env variables for CLI tools [@MickLesk](https://github.com/MickLesk) ([#10023](https://github.com/community-scripts/ProxmoxVE/pull/10023))
+
+### 💾 Core
+
+  - #### ✨ New Features
+
+    - core: IP-Range-Scan Support (app.vars / default.vars)  [@MickLesk](https://github.com/MickLesk) ([#10038](https://github.com/community-scripts/ProxmoxVE/pull/10038))
+    - tools.func: add optional enabled parameter to setup_deb822_repo [@MickLesk](https://github.com/MickLesk) ([#10017](https://github.com/community-scripts/ProxmoxVE/pull/10017))
+    - core: map Etc/* timezones to 'host' for pct compatibility [@MickLesk](https://github.com/MickLesk) ([#10020](https://github.com/community-scripts/ProxmoxVE/pull/10020))
+
+### 🌐 Website
+
+  - website: bump deps & prevent security issues [@MickLesk](https://github.com/MickLesk) ([#10045](https://github.com/community-scripts/ProxmoxVE/pull/10045))
+
+## 2025-12-15
+
+### 🆕 New Scripts
+
+  - Koel ([#9972](https://github.com/community-scripts/ProxmoxVE/pull/9972))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Fix DiscoPanel build [@PouletteMC](https://github.com/PouletteMC) ([#10009](https://github.com/community-scripts/ProxmoxVE/pull/10009))
+    - fix:ct/openwebui.sh adding progressbar and minimize service downtime [@jobben-2025](https://github.com/jobben-2025) ([#9894](https://github.com/community-scripts/ProxmoxVE/pull/9894))
+    - homarr: add: temp note aboute deb13 requirement [@CrazyWolf13](https://github.com/CrazyWolf13) ([#9992](https://github.com/community-scripts/ProxmoxVE/pull/9992))
+    - paperless-ai: backup data and recreate venv during update [@MickLesk](https://github.com/MickLesk) ([#9987](https://github.com/community-scripts/ProxmoxVE/pull/9987))
+    - fix(booklore): add setup_yq to update script [@MickLesk](https://github.com/MickLesk) ([#9989](https://github.com/community-scripts/ProxmoxVE/pull/9989))
+    - fix(pangolin-install): add network-online dependency [@worried-networking](https://github.com/worried-networking) ([#9984](https://github.com/community-scripts/ProxmoxVE/pull/9984))
+
+  - #### ✨ New Features
+
+    - OPNsense: dynamic crawl latest stable FreeBSD [@austindsmith](https://github.com/austindsmith) ([#9831](https://github.com/community-scripts/ProxmoxVE/pull/9831))
+
+  - #### 🔧 Refactor
+
+    - Refactor: Heimdall Dashboard [@tremor021](https://github.com/tremor021) ([#9959](https://github.com/community-scripts/ProxmoxVE/pull/9959))
+
+### 💾 Core
+
+  - #### 🐞 Bug Fixes
+
+    - tools: prevent awk errors in setup_rust on restricted containers [@MickLesk](https://github.com/MickLesk) ([#9985](https://github.com/community-scripts/ProxmoxVE/pull/9985))
+    - core: App Defaults force mode and prevent unbound variables [@MickLesk](https://github.com/MickLesk) ([#9971](https://github.com/community-scripts/ProxmoxVE/pull/9971))
+    - core: load app defaults before applying base_settings / fix composer cleanup after install/update [@MickLesk](https://github.com/MickLesk) ([#9965](https://github.com/community-scripts/ProxmoxVE/pull/9965))
+
+  - #### ✨ New Features
+
+    - tools: handle flat repositories in setup_deb822_repo [@MickLesk](https://github.com/MickLesk) ([#9994](https://github.com/community-scripts/ProxmoxVE/pull/9994))
+
+### 📚 Documentation
+
+  - (github) remove old files and assets [@MickLesk](https://github.com/MickLesk) ([#9991](https://github.com/community-scripts/ProxmoxVE/pull/9991))
+- README; add project statistics / formatting [@MickLesk](https://github.com/MickLesk) ([#9967](https://github.com/community-scripts/ProxmoxVE/pull/9967))
+
+## 2025-12-14
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - SonarQube: Fix database variables [@tremor021](https://github.com/tremor021) ([#9946](https://github.com/community-scripts/ProxmoxVE/pull/9946))
+
+  - #### 💥 Breaking Changes
+
+    - refactor: homarr  [@CrazyWolf13](https://github.com/CrazyWolf13) ([#9948](https://github.com/community-scripts/ProxmoxVE/pull/9948))
+
+### 🌐 Website
+
+  - Update dependencies and remove unused files [@BramSuurdje](https://github.com/BramSuurdje) ([#9945](https://github.com/community-scripts/ProxmoxVE/pull/9945))
+
 ## 2025-12-13
 
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Umami: Use `pnpm` [@tremor021](https://github.com/tremor021) ([#9937](https://github.com/community-scripts/ProxmoxVE/pull/9937))
+    - Tunarr: Switch to prebuild archive [@tremor021](https://github.com/tremor021) ([#9920](https://github.com/community-scripts/ProxmoxVE/pull/9920))
+    - [HOTFIX] NetVisor: backup OIDC config before update [@vhsdream](https://github.com/vhsdream) ([#9895](https://github.com/community-scripts/ProxmoxVE/pull/9895))
+    - Update OPNsense download URL to version 14.3 [@jaredcarling42-design](https://github.com/jaredcarling42-design) ([#9899](https://github.com/community-scripts/ProxmoxVE/pull/9899))
+
+  - #### ✨ New Features
+
+    - Add optional TLS setup to Valkey installer [@pshankinclarke](https://github.com/pshankinclarke) ([#9789](https://github.com/community-scripts/ProxmoxVE/pull/9789))
+
+  - #### 🔧 Refactor
+
+    - Refactor: Spoolman [@tremor021](https://github.com/tremor021) ([#9873](https://github.com/community-scripts/ProxmoxVE/pull/9873))
+
+### 🧰 Tools
+
+  - AdGuardHome-Sync ([#9783](https://github.com/community-scripts/ProxmoxVE/pull/9783))
+
+### ❔ Uncategorized
+
+  - Update category value in glance.json and adguard-home.json [@Bensonheimer992](https://github.com/Bensonheimer992) ([#9932](https://github.com/community-scripts/ProxmoxVE/pull/9932))
+- Change category ID from 6 to 3 in coolify.json and dokploy.json [@Bensonheimer992](https://github.com/Bensonheimer992) ([#9930](https://github.com/community-scripts/ProxmoxVE/pull/9930))
+
 ## 2025-12-12
 
 ### 🆕 New Scripts

README.md

@@ -30,8 +30,8 @@
 
   <br />
 
-> **Simplify your Proxmox VE setup with community-driven automation scripts**  
+ **Simplify your Proxmox VE setup with community-driven automation scripts**  
-> Originally created by tteck, now maintained and expanded by the community
+ Originally created by tteck, now maintained and expanded by the community
 
 </div>
 
@@ -239,17 +239,34 @@ This project is maintained by volunteers in memory of tteck. Your support helps
 
 ---
 
-## 📈 Project Growth
+## 📈 Project Statistics
+<p align="center">
+  <img
+    src="https://repobeats.axiom.co/api/embed/57edde03e00f88d739bdb5b844ff7d07dd079375.svg"
+    alt="Repobeats analytics"
+    width="650"
+  />
+</p>
 
-<div align="center">
+<p align="center">
   <a href="https://star-history.com/#community-scripts/ProxmoxVE&Date">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=community-scripts/ProxmoxVE&type=Date&theme=dark" />
+      <source
-      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=community-scripts/ProxmoxVE&type=Date" />
+        media="(prefers-color-scheme: dark)"
-      <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=community-scripts/ProxmoxVE&type=Date" />
+        srcset="https://api.star-history.com/svg?repos=community-scripts/ProxmoxVE&type=Date&theme=dark"
+      />
+      <source
+        media="(prefers-color-scheme: light)"
+        srcset="https://api.star-history.com/svg?repos=community-scripts/ProxmoxVE&type=Date"
+      />
+      <img
+        alt="Star History Chart"
+        src="https://api.star-history.com/svg?repos=community-scripts/ProxmoxVE&type=Date"
+        width="650"
+      />
     </picture>
   </a>
-</div>
+</p>
 
 ---
 

ct/2fauth.sh

@@ -28,20 +28,21 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if check_for_gh_release "2fauth" "Bubka/2FAuth"; then
     $STD apt update
     $STD apt -y upgrade
 
     msg_info "Creating Backup"
     mv "/opt/2fauth" "/opt/2fauth-backup"
-    if ! dpkg -l | grep -q 'php8.3'; then
+    if ! dpkg -l | grep -q 'php8.4'; then
       cp /etc/nginx/conf.d/2fauth.conf /etc/nginx/conf.d/2fauth.conf.bak
     fi
     msg_ok "Backup Created"
 
-    if ! dpkg -l | grep -q 'php8.3'; then
+    if ! dpkg -l | grep -q 'php8.4'; then
-      PHP_VERSION="8.3" PHP_MODULE="common,ctype,fileinfo,mysql,cli,tokenizer,dom,redis,session,openssl" PHP_FPM="YES" setup_php
+      PHP_VERSION="8.4" 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
+      sed -i 's/php8\.[0-9]/php8.4/g' /etc/nginx/conf.d/2fauth.conf
     fi
     fetch_and_deploy_gh_release "2fauth" "Bubka/2FAuth"
     setup_composer

ct/agentdvr.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-ubuntu}"
 var_version="${var_version:-24.04}"
 var_unprivileged="${var_unprivileged:-0}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/apache-guacamole.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_error "Currently we don't provide an update function for this ${APP}."
   exit
 }

ct/backrest.sh

@@ -27,28 +27,18 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  RELEASE=$(curl -fsSL https://api.github.com/repos/garethgeorge/backrest/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
+  if check_for_gh_release "backrest" "garethgeorge/backrest"; then
     msg_info "Stopping Service"
     systemctl stop backrest
     msg_ok "Stopped Service"
 
-    msg_info "Updating ${APP} to ${RELEASE}"
+    fetch_and_deploy_gh_release "backrest" "garethgeorge/backrest" "prebuild" "latest" "/opt/backrest/bin" "backrest_Linux_x86_64.tar.gz"
-    temp_file=$(mktemp)
-    rm -f /opt/backrest/bin/backrest
-    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_ok "Updated successfully!"
-  else
-    msg_ok "No update required. ${APP} is already at ${RELEASE}"
   fi
   exit
 }

ct/bar-assistant.sh

@@ -34,6 +34,8 @@ function update_script() {
     systemctl stop nginx
     msg_ok "Stopped nginx"
 
+    PHP_VERSION="8.4" PHP_FPM=YES PHP_MODULE="ffi,opcache,redis,zip,pdo-sqlite,bcmath,pdo,curl,dom,fpm" setup_php
+
     msg_info "Backing up Bar Assistant"
     mv /opt/bar-assistant /opt/bar-assistant-backup
     msg_ok "Backed up Bar Assistant"

ct/booklore.sh

@@ -28,6 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if check_for_gh_release "booklore" "booklore-app/BookLore"; then
     msg_info "Stopping Service"
     systemctl stop booklore
@@ -46,6 +47,7 @@ function update_script() {
     msg_ok "Built Frontend"
 
     JAVA_VERSION="21" setup_java
+    setup_yq
 
     msg_info "Building Backend"
     cd /opt/booklore/booklore-api

ct/bookstack.sh

@@ -28,6 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if check_for_gh_release "bookstack" "BookStackApp/BookStack"; then
     msg_info "Stopping Apache2"
     systemctl stop apache2

ct/calibre-web.sh

@@ -1,138 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2025 tteck
-# Author: tteck (tteckster) | Co-Author: remz1337
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/janeczku/calibre-web
-
-APP="Calibre-Web"
-var_tags="${var_tags:-eBook}"
-var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-2048}"
-var_disk="${var_disk:-4}"
-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 [[ ! -f /etc/systemd/system/cps.service ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-  msg_info "Stopping Service"
-  systemctl stop cps
-  msg_ok "Stopped Service"
-
-  msg_info "Updating ${APP}"
-  cd /opt/kepubify
-  rm -rf kepubify-linux-64bit
-  curl -fsSLO https://github.com/pgaskin/kepubify/releases/latest/download/kepubify-linux-64bit
-  chmod +x kepubify-linux-64bit
-  menu_array=("1" "Enables gdrive as storage backend for your ebooks" OFF
-    "2" "Enables sending emails via a googlemail account without enabling insecure apps" OFF
-    "3" "Enables displaying of additional author infos on the authors page" OFF
-    "4" "Enables login via LDAP server" OFF
-    "5" "Enables login via google or github oauth" OFF
-    "6" "Enables extracting of metadata from epub, fb2, pdf files, and also extraction of covers from cbr, cbz, cbt files" OFF
-    "7" "Enables extracting of metadata from cbr, cbz, cbt files" OFF
-    "8" "Enables syncing with your kobo reader" OFF)
-  if [ -f "/opt/calibre-web/options.txt" ]; then
-    cps_options="$(cat /opt/calibre-web/options.txt)"
-    IFS=',' read -ra ADDR <<<"$cps_options"
-    for i in "${ADDR[@]}"; do
-      if [ $i == "gdrive" ]; then
-        line=0
-      elif [ $i == "gmail" ]; then
-        line=1
-      elif [ $i == "goodreads" ]; then
-        line=2
-      elif [ $i == "ldap" ]; then
-        line=3
-      elif [ $i == "oauth" ]; then
-        line=4
-      elif [ $i == "metadata" ]; then
-        line=5
-      elif [ $i == "comics" ]; then
-        line=6
-      elif [ $i == "kobo" ]; then
-        line=7
-      fi
-      array_index=$((3 * line + 2))
-      menu_array[$array_index]=ON
-    done
-  fi
-  if [ -n "$SPINNER_PID" ] && ps -p $SPINNER_PID >/dev/null; then kill $SPINNER_PID >/dev/null; fi
-  CHOICES=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "CALIBRE-WEB OPTIONS" --separate-output --checklist "Choose Additional Options" 15 125 8 "${menu_array[@]}" 3>&1 1>&2 2>&3)
-  spinner &
-  SPINNER_PID=$!
-  options=()
-  if [ ! -z "$CHOICES" ]; then
-    for CHOICE in $CHOICES; do
-      case "$CHOICE" in
-      "1")
-        options+=(gdrive)
-        ;;
-      "2")
-        options+=(gmail)
-        ;;
-      "3")
-        options+=(goodreads)
-        ;;
-      "4")
-        options+=(ldap)
-        apt-get install -qqy libldap2-dev libsasl2-dev
-        ;;
-      "5")
-        options+=(oauth)
-        ;;
-      "6")
-        options+=(metadata)
-        ;;
-      "7")
-        options+=(comics)
-        ;;
-      "8")
-        options+=(kobo)
-        ;;
-      *)
-        echo "Unsupported item $CHOICE!" >&2
-        exit
-        ;;
-      esac
-    done
-  fi
-  if [ ${#options[@]} -gt 0 ]; then
-    cps_options=$(
-      IFS=,
-      echo "${options[*]}"
-    )
-    echo $cps_options >/opt/calibre-web/options.txt
-    $STD pip install --upgrade calibreweb[$cps_options]
-  else
-    rm -rf /opt/calibre-web/options.txt
-    $STD pip install --upgrade calibreweb
-  fi
-
-  msg_info "Starting Service"
-  systemctl start cps
-  msg_ok "Started Service"
-  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}:8083${CL}"

ct/comfyui.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-25}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/convertx.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-20}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-12}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/cosmos.sh

@@ -5,14 +5,15 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 # Source: https://https://cosmos-cloud.io/
 
-APP="cosmos"
+APP="Cosmos"
-var_tags="${var_tags:-os,docker}"
+var_tags="${var_tags:-cloud;docker}"
 var_cpu="${var_cpu:-2}"
 var_ram="${var_ram:-2048}"
 var_disk="${var_disk:-8}"
 var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
+var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_fuse="${var_fuse:-yes}"
 
 header_info "$APP"
 variables

ct/discopanel.sh

@@ -49,6 +49,8 @@ function update_script() {
     CLEAN_INSTALL=1 fetch_and_deploy_gh_release "discopanel" "nickheyer/discopanel" "tarball" "latest" "/opt/discopanel"
 
     msg_info "Setting up DiscoPanel"
+    cd /opt/discopanel
+    $STD make gen
     cd /opt/discopanel/web/discopanel
     $STD npm install
     $STD npm run build

ct/dispatcharr.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/dolibarr.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_error "To update ${APP}, use the applications web interface."
   exit
 }

ct/domain-monitor.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
 
   if ! grep -Fq "root /usr/bin/php /opt/domain-monitor/cron/check_domains.php" /etc/crontab; then
     echo "0 0 * * * root /usr/bin/php /opt/domain-monitor/cron/check_domains.php" >>/etc/crontab

ct/endurain.sh

@@ -28,7 +28,7 @@ function update_script() {
     msg_error "No ${APP} installation found!"
     exit 1
   fi
-  if check_for_gh_release "endurain" "joaovitoriasilva/endurain"; then
+  if check_for_gh_release "endurain" "endurain-project/endurain"; then
     msg_info "Stopping Service"
     systemctl stop endurain
     msg_ok "Stopped Service"
@@ -38,7 +38,7 @@ function update_script() {
     cp /opt/endurain/frontend/app/dist/env.js /opt/endurain.env.js
     msg_ok "Created Backup"
 
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "endurain" "joaovitoriasilva/endurain" "tarball" "latest" "/opt/endurain"
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "endurain" "endurain-project/endurain" "tarball" "latest" "/opt/endurain"
 
     msg_info "Preparing Update"
     cd /opt/endurain

ct/ersatztv.sh

@@ -11,7 +11,7 @@ var_cpu="${var_cpu:-2}"
 var_ram="${var_ram:-1024}"
 var_disk="${var_disk:-5}"
 var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
+var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
 var_gpu="${var_gpu:-yes}"
 

ct/firefly.sh

@@ -28,7 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-
+  setup_mariadb
   if check_for_gh_release "firefly" "firefly-iii/firefly-iii"; then
     systemctl stop apache2
     cp /opt/firefly/.env /opt/.env

ct/ghost.sh

@@ -23,6 +23,7 @@ function update_script() {
   header_info
   check_container_storage
   check_container_resources
+  setup_mariadb
 
   NODE_VERSION="22" setup_nodejs
 

ct/glpi.sh

@@ -28,6 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   RELEASE=$(curl -fsSL https://api.github.com/repos/glpi-project/glpi/releases/latest | grep '"tag_name"' | sed -E 's/.*"tag_name": "([^"]+)".*/\1/')
   if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
     msg_error "Currently we don't provide an update function for this ${APP}."

ct/go2rtc.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-4}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-12}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/headers/calibre-web

@@ -1,6 +0,0 @@
-   ______      ___ __                  _       __     __  
-  / ____/___ _/ (_) /_  ________      | |     / /__  / /_ 
- / /   / __ `/ / / __ \/ ___/ _ \_____| | /| / / _ \/ __ \
-/ /___/ /_/ / / / /_/ / /  /  __/_____/ |/ |/ /  __/ /_/ /
-\____/\__,_/_/_/_.___/_/   \___/      |__/|__/\___/_.___/ 
-                                                          

ct/headers/cosmos

@@ -1,6 +1,6 @@
-                                       
+   ______                               
-  _________  _________ ___  ____  _____
+  / ____/___  _________ ___  ____  _____
- / ___/ __ \/ ___/ __ `__ \/ __ \/ ___/
+ / /   / __ \/ ___/ __ `__ \/ __ \/ ___/
-/ /__/ /_/ (__  ) / / / / / /_/ (__  ) 
+/ /___/ /_/ (__  ) / / / / / /_/ (__  ) 
-\___/\____/____/_/ /_/ /_/\____/____/  
+\____/\____/____/_/ /_/ /_/\____/____/  
                                         

ct/headers/koel

@@ -0,0 +1,6 @@
+    __ __           __
+   / //_/___  ___  / /
+  / ,< / __ \/ _ \/ / 
+ / /| / /_/ /  __/ /  
+/_/ |_\____/\___/_/   
+                      

ct/headers/netvisor

@@ -1,6 +1,6 @@
-    _   __     __ _    ___                
+   _____                                   
-   / | / /__  / /| |  / (_)________  _____
+  / ___/_________ _____  ____  ____  __  __
-  /  |/ / _ \/ __/ | / / / ___/ __ \/ ___/
+  \__ \/ ___/ __ `/ __ \/ __ \/ __ \/ / / /
- / /|  /  __/ /_ | |/ / (__  ) /_/ / /    
+ ___/ / /__/ /_/ / / / / /_/ / /_/ / /_/ / 
-/_/ |_/\___/\__/ |___/_/____/\____/_/     
+/____/\___/\__,_/_/ /_/\____/ .___/\__, /  
-                                          
+                           /_/    /____/   

ct/headers/scanopy

@@ -0,0 +1,6 @@
+   _____                                   
+  / ___/_________ _____  ____  ____  __  __
+  \__ \/ ___/ __ `/ __ \/ __ \/ __ \/ / / /
+ ___/ / /__/ /_/ / / / / /_/ / /_/ / /_/ / 
+/____/\___/\__,_/_/ /_/\____/ .___/\__, /  
+                           /_/    /____/   

ct/heimdall-dashboard.sh

@@ -11,7 +11,7 @@ var_cpu="${var_cpu:-1}"
 var_ram="${var_ram:-512}"
 var_disk="${var_disk:-2}"
 var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
+var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
 
 header_info "$APP"
@@ -27,45 +27,45 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  RELEASE=$(curl -fsSL "https://api.github.com/repos/linuxserver/Heimdall/releases/latest" | awk '/tag_name/{print $4;exit}' FS='[""]')
+
-  if [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]] || [[ ! -f /opt/${APP}_version.txt ]]; then
+  if check_for_gh_release "Heimdall" "linuxserver/Heimdall"; then
     msg_info "Stopping Service"
     systemctl stop heimdall
     sleep 1
     msg_ok "Stopped Service"
+
     msg_info "Backing up Data"
     cp -R /opt/Heimdall/database database-backup
     cp -R /opt/Heimdall/public public-backup
     sleep 1
     msg_ok "Backed up Data"
-    msg_info "Updating Heimdall Dashboard to ${RELEASE}"
+
-    curl -fsSL "https://github.com/linuxserver/Heimdall/archive/${RELEASE}.tar.gz" -o $(basename "https://github.com/linuxserver/Heimdall/archive/${RELEASE}.tar.gz")
+    setup_composer
-    tar xzf "${RELEASE}".tar.gz
+    fetch_and_deploy_gh_release "Heimdall" "linuxserver/Heimdall" "tarball"
-    VER=$(curl -fsSL https://api.github.com/repos/linuxserver/Heimdall/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
+
-    cp -R Heimdall-"${VER}"/* /opt/Heimdall
+    msg_info "Updating Heimdall-Dashboard"
     cd /opt/Heimdall
-    $STD apt-get install -y composer
     export COMPOSER_ALLOW_SUPERUSER=1
     $STD composer dump-autoload
-    echo "${RELEASE}" >/opt/${APP}_version.txt
+    msg_ok "Updated Heimdall-Dashboard"
-    msg_ok "Updated Heimdall Dashboard to ${RELEASE}"
+
     msg_info "Restoring Data"
     cd ~
     cp -R database-backup/* /opt/Heimdall/database
     cp -R public-backup/* /opt/Heimdall/public
     sleep 1
     msg_ok "Restored Data"
-    msg_info "Cleanup"
+
-    rm -rf {"${RELEASE}".tar.gz,Heimdall-"${VER}",public-backup,database-backup,Heimdall}
+    msg_info "Cleaning Up"
+    rm -rf {public-backup,database-backup}
     sleep 1
-    msg_ok "Cleaned"
+    msg_ok "Cleaned Up"
+
     msg_info "Starting Service"
     systemctl start heimdall.service
     sleep 2
     msg_ok "Started Service"
     msg_ok "Updated successfully!"
-  else
-    msg_ok "No update required.  ${APP} is already at ${RELEASE}."
   fi
   exit
 }

ct/homarr.sh

@@ -1,21 +1,20 @@
 #!/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: CrazyWolf13
+# Author: MickLesk (CanbiZ) | Co-Author: CrazyWolf13
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 # Source: https://homarr.dev/
 
 APP="homarr"
 var_tags="${var_tags:-arr;dashboard}"
-var_cpu="${var_cpu:-3}"
+var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-6144}"
+var_ram="${var_ram:-1024}"
 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
@@ -28,69 +27,32 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  if [[ -f /opt/homarr/database/db.sqlite ]]; then
-    msg_error "Old Homarr detected due to existing database file (/opt/homarr/database/db.sqlite)."
-    msg_error "Update not supported. Refer to:"
-    msg_error " - https://github.com/community-scripts/ProxmoxVE/discussions/1551"
-    msg_error " - https://homarr.dev/docs/getting-started/after-the-installation/#importing-a-zip-from-version-before-100"
-    exit
-  fi
-  if [[ ! -f /opt/run_homarr.sh ]]; then
-    msg_info "Detected outdated and missing service files"
-    msg_error "Warning - The port of homarr changed from 3000 to 7575"
-    $STD apt-get install -y nginx gettext openssl gpg
-    sed -i '/^NODE_ENV=/d' /opt/homarr/.env && echo "NODE_ENV='production'" >>/opt/homarr/.env
-    sed -i '/^DB_DIALECT=/d' /opt/homarr/.env && echo "DB_DIALECT='sqlite'" >>/opt/homarr/.env
-    cat <<'EOF' >/opt/run_homarr.sh
-#!/bin/bash
-set -a
-source /opt/homarr/.env
-set +a
-export DB_DIALECT='sqlite'
-export AUTH_SECRET=$(openssl rand -base64 32)
-export CRON_JOB_API_KEY=$(openssl rand -base64 32)
-node /opt/homarr_db/migrations/$DB_DIALECT/migrate.cjs /opt/homarr_db/migrations/$DB_DIALECT
-for dir in $(find /opt/homarr_db/migrations/migrations -mindepth 1 -maxdepth 1 -type d); do
-  dirname=$(basename "$dir")
-  mkdir -p "/opt/homarr_db/migrations/$dirname"
-  cp -r "$dir"/* "/opt/homarr_db/migrations/$dirname/" 2>/dev/null || true
-done
-export HOSTNAME=$(ip route get 1.1.1.1 | grep -oP 'src \K[^ ]+')
-envsubst '${HOSTNAME}' < /etc/nginx/templates/nginx.conf > /etc/nginx/nginx.conf
-nginx -g 'daemon off;' &
-redis-server /opt/homarr/packages/redis/redis.conf &
-node apps/tasks/tasks.cjs &
-node apps/websocket/wssServer.cjs &
-node apps/nextjs/server.js & PID=$!
-wait $PID
-EOF
-    chmod +x /opt/run_homarr.sh
-    rm /etc/systemd/system/homarr.service
-    cat <<EOF >/etc/systemd/system/homarr.service
-[Unit]
-Description=Homarr Service
-After=network.target
-[Service]
-Type=exec
-WorkingDirectory=/opt/homarr
-EnvironmentFile=-/opt/homarr/.env
-ExecStart=/opt/run_homarr.sh
-[Install]
-WantedBy=multi-user.target
-EOF
-    msg_ok "Updated Services"
-    systemctl daemon-reload
-  fi
 
   if check_for_gh_release "homarr" "homarr-labs/homarr"; then
     msg_info "Stopping Services (Patience)"
     systemctl stop homarr
+    systemctl stop redis-server
     msg_ok "Services Stopped"
 
-    msg_info "Backup Data"
+    if ! { grep -q '^REDIS_IS_EXTERNAL=' /opt/homarr/.env 2>/dev/null || grep -q '^REDIS_IS_EXTERNAL=' /opt/homarr.env 2>/dev/null; }; then
-    mkdir -p /opt/homarr-data-backup
+      msg_info "Fixing old structure"
-    cp /opt/homarr/.env /opt/homarr-data-backup/.env
+      systemctl disable -q --now nginx
-    msg_ok "Backup Data"
+      cp /opt/homarr/.env /opt/homarr.env
+      echo "REDIS_IS_EXTERNAL='true'" >> /opt/homarr.env
+      sed -i '/^\[Unit\]/a Requires=redis-server.service\nAfter=redis-server.service' /etc/systemd/system/homarr.service
+      sed -i 's|^ExecStart=.*|ExecStart=/opt/homarr/run.sh|' /etc/systemd/system/homarr.service
+      sed -i 's|^EnvironmentFile=.*|EnvironmentFile=-/opt/homarr.env|' /etc/systemd/system/homarr.service
+      chown -R redis:redis /appdata/redis
+      chmod 744 /appdata/redis
+      mkdir -p /etc/systemd/system/redis-server.service.d/
+      cat <<EOF >/etc/systemd/system/redis-server.service.d/override.conf
+[Service]
+ReadWritePaths=-/appdata/redis -/var/lib/redis -/var/log/redis -/var/run/redis -/etc/redis
+EOF
+      systemctl daemon-reload
+      rm /opt/run_homarr.sh
+      msg_ok "Fixed old structure"
+    fi
 
     msg_info "Updating Nodejs"
     $STD apt update
@@ -98,69 +60,21 @@ EOF
     msg_ok "Updated Nodejs"
 
     NODE_VERSION=$(curl -s https://raw.githubusercontent.com/homarr-labs/homarr/dev/package.json | jq -r '.engines.node | split(">=")[1] | split(".")[0]')
-    NODE_MODULE="pnpm@$(curl -s https://raw.githubusercontent.com/homarr-labs/homarr/dev/package.json | jq -r '.packageManager | split("@")[1]')"
     setup_nodejs
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "homarr" "homarr-labs/homarr" "prebuild" "latest" "/opt/homarr" "build-debian-amd64.tar.gz"
 
-    rm -rf /opt/homarr
+    msg_info "Updating Homarr"
-    fetch_and_deploy_gh_release "homarr" "homarr-labs/homarr"
+    cp /opt/homarr/redis.conf /etc/redis/redis.conf
-
-    msg_info "Updating and rebuilding ${APP} (Patience)"
-    rm /opt/run_homarr.sh
-    cat <<'EOF' >/opt/run_homarr.sh
-#!/bin/bash
-set -a
-source /opt/homarr/.env
-set +a
-export DB_DIALECT='sqlite'
-export AUTH_SECRET=$(openssl rand -base64 32)
-export CRON_JOB_API_KEY=$(openssl rand -base64 32)
-node /opt/homarr_db/migrations/$DB_DIALECT/migrate.cjs /opt/homarr_db/migrations/$DB_DIALECT
-for dir in $(find /opt/homarr_db/migrations/migrations -mindepth 1 -maxdepth 1 -type d); do
-  dirname=$(basename "$dir")
-  mkdir -p "/opt/homarr_db/migrations/$dirname"
-  cp -r "$dir"/* "/opt/homarr_db/migrations/$dirname/" 2>/dev/null || true
-done
-export HOSTNAME=$(ip route get 1.1.1.1 | grep -oP 'src \K[^ ]+')
-envsubst '${HOSTNAME}' < /etc/nginx/templates/nginx.conf > /etc/nginx/nginx.conf
-nginx -g 'daemon off;' &
-redis-server /opt/homarr/packages/redis/redis.conf &
-node apps/tasks/tasks.cjs &
-node apps/websocket/wssServer.cjs &
-node apps/nextjs/server.js & PID=$!
-wait $PID
-EOF
-    chmod +x /opt/run_homarr.sh
-    mv /opt/homarr-data-backup/.env /opt/homarr/.env
-    cd /opt/homarr
-    $STD pnpm install --recursive --frozen-lockfile --shamefully-hoist
-    $STD pnpm build
-    cp /opt/homarr/apps/nextjs/next.config.ts .
-    cp /opt/homarr/apps/nextjs/package.json .
-    cp -r /opt/homarr/packages/db/migrations /opt/homarr_db/migrations
-    cp -r /opt/homarr/apps/nextjs/.next/standalone/* /opt/homarr
-    mkdir -p /appdata/redis
-    cp /opt/homarr/packages/redis/redis.conf /opt/homarr/redis.conf
     rm /etc/nginx/nginx.conf
-    mkdir -p /etc/nginx/templates
     cp /opt/homarr/nginx.conf /etc/nginx/templates/nginx.conf
-
+    msg_ok "Updated Homarr"
-    mkdir -p /opt/homarr/apps/cli
-    cp /opt/homarr/packages/cli/cli.cjs /opt/homarr/apps/cli/cli.cjs
-    echo $'#!/bin/bash\ncd /opt/homarr/apps/cli && node ./cli.cjs "$@"' >/usr/bin/homarr
-    chmod +x /usr/bin/homarr
-
-    mkdir /opt/homarr/build
-    cp ./node_modules/better-sqlite3/build/Release/better_sqlite3.node ./build/better_sqlite3.node
-    msg_ok "Updated ${APP}"
 
     msg_info "Starting Services"
+    chmod +x /opt/homarr/run.sh
     systemctl start homarr
+    systemctl start redis-server
     msg_ok "Started Services"
     msg_ok "Updated successfully!"
-    read -p "${TAB3}It's recommended to reboot the LXC after an update, would you like to reboot the LXC now ? (y/n): " choice
-    if [[ "$choice" =~ ^[Yy]$ ]]; then
-      reboot
-    fi
   fi
   exit
 }

ct/hortusfox.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if check_for_gh_release "hortusfox" "danielbrendel/hortusfox-web"; then
     msg_info "Stopping Service"
     systemctl stop apache2

ct/hyperhdr.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-4}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-12}"
 var_unprivileged="${var_unprivileged:-0}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/hyperion.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-2}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/immich.sh

@@ -74,23 +74,28 @@ EOF
   STAGING_DIR=/opt/staging
   BASE_DIR=${STAGING_DIR}/base-images
   SOURCE_DIR=${STAGING_DIR}/image-source
-  cd /root
+  cd /tmp
   if [[ -f ~/.intel_version ]]; then
-    curl -fsSLO https://raw.githubusercontent.com/immich-app/immich/refs/heads/main/machine-learning/Dockerfile
+    curl -fsSLO https://raw.githubusercontent.com/immich-app/base-images/refs/heads/main/server/Dockerfile
-    readarray -t INTEL_URLS < <(sed -n "/intel/p" ./Dockerfile | awk '{print $3}')
+    readarray -t INTEL_URLS < <(
-    INTEL_RELEASE="$(grep "intel-opencl-icd" ./Dockerfile | awk -F '_' '{print $2}')"
+      sed -n "/intel-[igc|opencl]/p" ./Dockerfile | awk '{print $2}'
+      sed -n "/libigdgmm12/p" ./Dockerfile | awk '{print $3}'
+    )
+    INTEL_RELEASE="$(grep "intel-opencl-icd_" ./Dockerfile | awk -F '_' '{print $2}')"
     if [[ "$INTEL_RELEASE" != "$(cat ~/.intel_version)" ]]; then
       msg_info "Updating Intel iGPU dependencies"
       for url in "${INTEL_URLS[@]}"; do
         curl -fsSLO "$url"
       done
       $STD apt-mark unhold libigdgmm12
+      $STD apt install -y ./libigdgmm12*.deb
+      rm ./libigdgmm12*.deb
       $STD apt install -y ./*.deb
       rm ./*.deb
       $STD apt-mark hold libigdgmm12
       msg_ok "Intel iGPU dependencies updated"
     fi
-    rm ~/Dockerfile
+    rm ./Dockerfile
   fi
   if [[ -f ~/.immich_library_revisions ]]; then
     libraries=("libjxl" "libheif" "libraw" "imagemagick" "libvips")
@@ -103,7 +108,7 @@ EOF
     msg_ok "Image-processing libraries up to date"
   fi
 
-  RELEASE="2.3.1"
+  RELEASE="2.4.1"
   if check_for_gh_release "immich" "immich-app/immich" "${RELEASE}"; then
     msg_info "Stopping Services"
     systemctl stop immich-web

ct/influxdb.sh

@@ -23,7 +23,7 @@ function update_script() {
   header_info
   check_container_storage
   check_container_resources
-  if [[ ! -f /etc/apt/sources.list.d/influxdata.list ]]; then
+  if [[ ! -f /usr/bin/influxd ]]; then
     msg_error "No ${APP} Installation Found!"
     exit
   fi

ct/invoiceninja.sh

@@ -28,7 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-
+  setup_mariadb
   if check_for_gh_release "invoiceninja" "invoiceninja/invoiceninja"; then
     msg_info "Stopping Services"
     systemctl stop supervisor nginx php8.4-fpm

ct/itsm-ng.sh

@@ -28,6 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit 1
   fi
+  setup_mariadb
 
   msg_info "Updating LXC"
   $STD apt update

ct/jotty.sh

@@ -48,6 +48,17 @@ function update_script() {
     $STD yarn --frozen-lockfile
     $STD yarn next telemetry disable
     $STD yarn build
+
+    [ -d "public" ] && cp -r public .next/standalone/
+    [ -d "howto" ] && cp -r howto .next/standalone/
+    mkdir -p .next/standalone/.next
+    cp -r .next/static .next/standalone/.next/
+
+    mv .next/standalone /tmp/jotty_standalone
+    rm -rf * .next .git .gitignore .yarn
+    mv /tmp/jotty_standalone/* .
+    mv /tmp/jotty_standalone/.[!.]* . 2>/dev/null || true
+    rm -rf /tmp/jotty_standalone
     msg_ok "Updated jotty"
 
     msg_info "Restoring configuration & data"
@@ -55,6 +66,24 @@ function update_script() {
     $STD tar -xf /opt/data_config.tar
     msg_ok "Restored configuration & data"
 
+    msg_info "Updating Service"
+    cat <<EOF >/etc/systemd/system/jotty.service
+[Unit]
+Description=jotty server
+After=network.target
+
+[Service]
+WorkingDirectory=/opt/jotty
+EnvironmentFile=/opt/jotty/.env
+ExecStart=/usr/bin/node server.js
+Restart=on-abnormal
+
+[Install]
+WantedBy=multi-user.target
+EOF
+    systemctl daemon-reload
+    msg_ok "Updated Service"
+
     msg_info "Starting Service"
     systemctl start jotty
     msg_ok "Started Service"

ct/kimai.sh

@@ -30,6 +30,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
 
   PHP_VERSION="8.4" PHP_MODULE="mysql" PHP_APACHE="YES" setup_php
   setup_composer

ct/koel.sh

@@ -0,0 +1,81 @@
+#!/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://koel.dev/
+
+APP="Koel"
+var_tags="${var_tags:-music;streaming}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-2048}"
+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 [[ ! -d /opt/koel ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_release "koel" "koel/koel"; then
+    msg_info "Stopping Services"
+    systemctl stop nginx php8.4-fpm
+    msg_ok "Stopped Services"
+
+    msg_info "Creating Backup"
+    mkdir -p /tmp/koel_backup
+    cp /opt/koel/.env /tmp/koel_backup/
+    cp -r /opt/koel/storage /tmp/koel_backup/ 2>/dev/null || true
+    cp -r /opt/koel/public/img /tmp/koel_backup/ 2>/dev/null || true
+    msg_ok "Created Backup"
+
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "koel" "koel/koel" "prebuild" "latest" "/opt/koel" "koel-*.tar.gz"
+
+    msg_info "Restoring Data"
+    cp /tmp/koel_backup/.env /opt/koel/
+    cp -r /tmp/koel_backup/storage/* /opt/koel/storage/ 2>/dev/null || true
+    cp -r /tmp/koel_backup/img/* /opt/koel/public/img/ 2>/dev/null || true
+    rm -rf /tmp/koel_backup
+    msg_ok "Restored Data"
+
+    msg_info "Running Migrations"
+    cd /opt/koel
+    export COMPOSER_ALLOW_SUPERUSER=1
+    $STD composer install --no-interaction --no-dev --optimize-autoloader
+    $STD php artisan migrate --force
+    $STD php artisan config:clear
+    $STD php artisan cache:clear
+    $STD php artisan view:clear
+    $STD php artisan koel:init --no-assets --no-interaction
+    chown -R www-data:www-data /opt/koel
+    chmod -R 775 /opt/koel/storage
+    msg_ok "Ran Migrations"
+
+    msg_info "Starting Services"
+    systemctl start php8.4-fpm nginx
+    msg_ok "Started Services"
+    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}${CL}"

ct/kometa.sh

@@ -41,6 +41,7 @@ function update_script() {
     fetch_and_deploy_gh_release "kometa" "Kometa-Team/Kometa"
 
     msg_info "Updating Kometa"
+    cd /opt/kometa
     $STD uv pip install -r requirements.txt --system
     mkdir -p config/assets
     cp /opt/config.yml config/config.yml

ct/leantime.sh

@@ -28,7 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-
+  setup_mariadb
   if check_for_gh_release "leantime" "Leantime/leantime"; then
     msg_info "Creating Backup"
     mariadb-dump leantime >"/opt/${APP}_db_backup_$(date +%F).sql"

ct/librenms.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_info "Updating LibreNMS"
   su librenms
   cd /opt/librenms

ct/libretranslate.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-20}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/limesurvey.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
 
   msg_warn "Application is updated via Web Interface"
   exit

ct/linkwarden.sh

@@ -52,7 +52,7 @@ 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 ~/.cargo/registry ~/.cargo/git ~/.cargo/.package-cache
     rm -rf /root/.cache/yarn
     rm -rf /opt/linkwarden/.next/cache
     msg_ok "Updated ${APP}"

ct/managemydamnlife.sh

@@ -28,6 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if check_for_gh_release "mmdl" "intri-in/manage-my-damn-life-nextjs"; then
     msg_info "Stopping service"
     systemctl stop mmdl

ct/mariadb.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_info "Updating ${APP} LXC"
   $STD apt update
   $STD apt -y upgrade

ct/mediamtx.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-4}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/miniflux.sh

@@ -23,7 +23,7 @@ function update_script() {
   header_info
   check_container_storage
   check_container_resources
-  if [[ ! -f /etc/systemd/system/miniflux.service ]]; then
+  if ! systemctl -q is-enabled miniflux 2>/dev/null; then
     msg_error "No ${APP} Installation Found!"
     exit
   fi

ct/monica.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
 
   NODE_VERSION="22" NODE_MODULE="yarn@latest" setup_nodejs
 

ct/motioneye.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/netvisor.sh

@@ -3,9 +3,9 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 # Copyright (c) 2021-2025 community-scripts ORG
 # Author: vhsdream
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/netvisor-io/netvisor
+# Source: https://github.com/scanopy/scanopy
 
-APP="NetVisor"
+APP="Scanopy"
 var_tags="${var_tags:-analytics}"
 var_cpu="${var_cpu:-2}"
 var_ram="${var_ram:-3072}"
@@ -29,16 +29,12 @@ function update_script() {
     exit
   fi
 
-  if check_for_gh_release "netvisor" "netvisor-io/netvisor"; then
   msg_info "Stopping services"
-    systemctl stop netvisor-daemon netvisor-server
+  systemctl -q disable --now netvisor-daemon netvisor-server
   msg_ok "Stopped services"
 
-    msg_info "Backing up configurations"
+  NODE_VERSION="24" setup_nodejs
-    cp /opt/netvisor/.env /opt/netvisor.env.bak
+  CLEAN_INSTALL=1 fetch_and_deploy_gh_release "scanopy" "scanopy/scanopy" "tarball" "latest" "/opt/scanopy"
-    msg_ok "Backed up configurations"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "netvisor" "netvisor-io/netvisor" "tarball" "latest" "/opt/netvisor"
 
   if ! dpkg -l | grep -q "pkg-config"; then
     $STD apt install -y pkg-config
@@ -46,48 +42,61 @@ function update_script() {
   if ! dpkg -l | grep -q "libssl-dev"; then
     $STD apt install -y libssl-dev
   fi
-    TOOLCHAIN="$(grep "channel" /opt/netvisor/backend/rust-toolchain.toml | awk -F\" '{print $2}')"
+  TOOLCHAIN="$(grep "channel" /opt/scanopy/backend/rust-toolchain.toml | awk -F\" '{print $2}')"
   RUST_TOOLCHAIN=$TOOLCHAIN setup_rust
 
-    cp /opt/netvisor.env.bak /opt/netvisor/.env
+  mv /opt/netvisor/.env /opt/scanopy/.env
-    LOCAL_IP="$(hostname -I | awk '{print $1}')"
+  if [[ -f /opt/netvisor/oidc.toml ]]; then
-    if ! grep -q "PUBLIC_URL" /opt/netvisor/.env; then
+    mv /opt/netvisor/oidc.toml /opt/scanopy/oidc.toml
-      sed -i "\|_PATH=|a\NETVISOR_PUBLIC_URL=http://${LOCAL_IP}:60072" /opt/netvisor/.env
   fi
-    sed -i 's|_TARGET=.*$|_URL=http://127.0.0.1:60072|' /opt/netvisor/.env
+  LOCAL_IP="$(hostname -I | awk '{print $1}')"
+  if ! grep -q "PUBLIC_URL" /opt/scanopy/.env; then
+    sed -i "\|_PATH=|a\NETVISOR_PUBLIC_URL=http://${LOCAL_IP}:60072" /opt/scanopy/.env
+  fi
+  sed -i 's|_TARGET=.*$|_URL=http://127.0.0.1:60072|' /opt/scanopy/.env
+  sed -i 's/NETVISOR/SCANOPY/g; s|netvisor/|scanopy/|' /opt/scanopy/.env
 
   msg_info "Creating frontend UI"
   export PUBLIC_SERVER_HOSTNAME=default
   export PUBLIC_SERVER_PORT=""
-    cd /opt/netvisor/ui
+  cd /opt/scanopy/ui
   $STD npm ci --no-fund --no-audit
   $STD npm run build
   msg_ok "Created frontend UI"
 
-    msg_info "Building Netvisor-server (patience)"
+  msg_info "Building Scanopy-server (patience)"
-    cd /opt/netvisor/backend
+  cd /opt/scanopy/backend
   $STD cargo build --release --bin server
-    mv ./target/release/server /usr/bin/netvisor-server
+  mv ./target/release/server /usr/bin/scanopy-server
-    msg_ok "Built Netvisor-server"
+  msg_ok "Built Scanopy-server"
 
-    msg_info "Building Netvisor-daemon"
+  msg_info "Building Scanopy-daemon"
   $STD cargo build --release --bin daemon
-    cp ./target/release/daemon /usr/bin/netvisor-daemon
+  cp ./target/release/daemon /usr/bin/scanopy-daemon
-    msg_ok "Built Netvisor-daemon"
+  msg_ok "Built Scanopy-daemon"
 
+  sed -i '/^  \"server_target.*$/d' /root/.config/daemon/config.json
   sed -i -e 's|-target|-url|' \
     -e 's| --server-port |:|' \
+    -e 's/NetVisor/Scanopy/' \
+    -e 's/netvisor/scanopy/' \
     /etc/systemd/system/netvisor-daemon.service
-    sed -i '/^  \"server_target.*$/d' /root/.config/daemon/config.json
+  mv /etc/systemd/system/netvisor-daemon.service /etc/systemd/system/scanopy-daemon.service
-    if ! grep -q "WorkingD" /etc/systemd/system/netvisor-server.service; then
+  sed -i -e 's/NetVisor/Scanopy/' \
-      sed -i '\|simple$|a\WorkingDirectory=/opt/netvisor/backend' /etc/systemd/system/netvisor-server.service
+    -e 's/netvisor/scanopy/g' \
-    fi
+    /etc/systemd/system/netvisor-server.service
+  mv /etc/systemd/system/netvisor-server.service /etc/systemd/system/scanopy-server.service
   systemctl daemon-reload
 
   msg_info "Starting services"
-    systemctl start netvisor-server netvisor-daemon
+  systemctl -q enable --now scanopy-server scanopy-daemon
   msg_ok "Updated successfully!"
-  fi
+
+  sed -i 's/netvisor/scanopy/' /usr/bin/update
+  mv ~/NetVisor.creds ~/scanopy.creds
+  rm ~/.netvisor
+  rm -rf /opt/netvisor
+
   exit
 }
 

ct/nextpvr.sh

@@ -14,6 +14,7 @@ var_disk="${var_disk:-5}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/nxwitness.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-ubuntu}"
 var_version="${var_version:-24.04}"
 var_unprivileged="${var_unprivileged:-0}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/openwebui.sh

@@ -88,22 +88,36 @@ EOF
   fi
 
   if [ -x "/usr/bin/ollama" ]; then
-    msg_info "Updating Ollama"
+    msg_info "Checking for Ollama Update"
     OLLAMA_VERSION=$(ollama -v | awk '{print $NF}')
     RELEASE=$(curl -s https://api.github.com/repos/ollama/ollama/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4)}')
     if [ "$OLLAMA_VERSION" != "$RELEASE" ]; then
-      msg_info "Stopping Service"
+      msg_info "Ollama update available: v$OLLAMA_VERSION -> v$RELEASE"
+      msg_info "Downloading Ollama v$RELEASE \n"
+      curl -fS#LO https://ollama.com/download/ollama-linux-amd64.tgz
+      msg_ok "Download Complete"
+
+      if [ -f "ollama-linux-amd64.tgz" ]; then
+
+        msg_info "Stopping Ollama Service"
         systemctl stop ollama
         msg_ok "Stopped Service"
-      curl -fsSLO -C - https://ollama.com/download/ollama-linux-amd64.tgz
+
+        msg_info "Installing Ollama"
         rm -rf /usr/lib/ollama
         rm -rf /usr/bin/ollama
         tar -C /usr -xzf ollama-linux-amd64.tgz
         rm -rf ollama-linux-amd64.tgz
-      msg_info "Starting Service"
+        msg_ok "Installed Ollama"
+
+        msg_info "Starting Ollama Service"
         systemctl start ollama
-      msg_info "Started Service"
+        msg_ok "Started Service"
+
         msg_ok "Ollama updated to version $RELEASE"
+      else
+        msg_error "Ollama download failed. Aborting update."
+      fi
     else
       msg_ok "Ollama is already up to date."
     fi

ct/owncast.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-2}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/paperless-ai.sh

@@ -33,10 +33,23 @@ function update_script() {
     systemctl stop paperless-ai paperless-rag
     msg_ok "Stopped Service"
 
+    msg_info "Backing up data"
+    cp -r /opt/paperless-ai/data /opt/paperless-ai-data-backup
+    msg_ok "Backed up data"
+
     fetch_and_deploy_gh_release "paperless-ai" "clusterzx/paperless-ai"
 
+    msg_info "Restoring data"
+    cp -r /opt/paperless-ai-data-backup/* /opt/paperless-ai/data/
+    rm -rf /opt/paperless-ai-data-backup
+    msg_ok "Restored data"
+
     msg_info "Updating Paperless-AI"
     cd /opt/paperless-ai
+    if [[ ! -d /opt/paperless-ai/venv ]]; then
+      msg_info "Recreating Python venv"
+      $STD python3 -m venv /opt/paperless-ai/venv
+    fi
     source /opt/paperless-ai/venv/bin/activate
     $STD pip install --upgrade pip
     $STD pip install --no-cache-dir -r requirements.txt

ct/passbolt.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_info "Updating $APP LXC"
   $STD apt update
   $STD apt upgrade -y

ct/paymenter.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
 
   CURRENT_PHP=$(php -v 2>/dev/null | awk '/^PHP/{print $2}' | cut -d. -f1,2)
   if [[ "$CURRENT_PHP" != "8.3" ]]; then

ct/pelican-panel.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   CURRENT_PHP=$(php -v 2>/dev/null | awk '/^PHP/{print $2}' | cut -d. -f1,2)
 
   if [[ "$CURRENT_PHP" != "8.4" ]]; then

ct/photoprism.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables
@@ -32,6 +33,13 @@ function update_script() {
     systemctl stop photoprism
     msg_ok "Stopped PhotoPrism"
 
+    if ! grep -q "photoprism/config/.env" ~/.bashrc 2>/dev/null; then
+      msg_info "Adding environment export for CLI tools"
+      echo '# Load PhotoPrism environment variables for CLI tools' >>~/.bashrc
+      echo 'export $(grep -v "^#" /opt/photoprism/config/.env | xargs)' >>~/.bashrc
+      msg_ok "Added environment export"
+    fi
+
     fetch_and_deploy_gh_release "photoprism" "photoprism/photoprism" "prebuild" "latest" "/opt/photoprism" "*linux-amd64.tar.gz"
 
     LIBHEIF_URL=$(curl -fsSL "https://dl.photoprism.app/dist/libheif/" | grep -oP "libheif-bookworm-amd64-v[0-9\.]+\.tar\.gz" | sort -V | tail -n 1)

ct/phpipam.sh

@@ -27,7 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-
+  setup_mariadb
   if check_for_gh_release "phpipam" "phpipam/phpipam"; then
     msg_info "Stopping Service"
     systemctl stop apache2

ct/pihole.sh

@@ -11,7 +11,7 @@ var_cpu="${var_cpu:-1}"
 var_ram="${var_ram:-512}"
 var_disk="${var_disk:-2}"
 var_os="${var_os:-debian}"
-var_version="${var_version:-12}"
+var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
 
 header_info "$APP"

ct/plant-it.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if check_for_gh_release "plant-it" "MDeLuise/plant-it"; then
     msg_info "Stopping Service"
     systemctl stop plant-it

ct/projectsend.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
 
   if check_for_gh_release "projectsend" "projectsend/projectsend"; then
     msg_info "Stopping Service"

ct/proxmox-mail-gateway.sh

@@ -27,10 +27,11 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  msg_info "Updating ${APP}"
+
+  msg_info "Updating Proxmox-Mail-Gateway"
   $STD apt update
-  $STD apt -y upgrade
+  $STD apt upgrade -y
-  msg_ok "Updated ${APP}"
+  msg_ok "Updated Proxmox-Mail-Gateway"
   msg_ok "Updated successfully!"
   exit
 }

ct/pterodactyl-panel.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   CURRENT_PHP=$(php -v 2>/dev/null | awk '/^PHP/{print $2}' | cut -d. -f1,2)
 
   if [[ "$CURRENT_PHP" != "8.4" ]]; then

ct/pterodactyl-wings.sh

@@ -23,29 +23,23 @@ function update_script() {
   header_info
   check_container_storage
   check_container_resources
-  if [[ ! -f /usr/local/bin/wings ]]; then
+  if [[ ! -x /usr/local/bin/wings ]]; then
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  RELEASE=$(curl -fsSL https://api.github.com/repos/pterodactyl/wings/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
+  if check_for_gh_release "wings" "pterodactyl/wings"; then
     msg_info "Stopping Service"
     systemctl stop wings
     msg_ok "Stopped Service"
 
-    msg_info "Updating ${APP} to v${RELEASE}"
     rm /usr/local/bin/wings
-    curl -fsSL "https://github.com/pterodactyl/wings/releases/download/v${RELEASE}/wings_linux_amd64" -o "/usr/local/bin/wings"
+    fetch_and_deploy_gh_release "wings" "pterodactyl/wings" "singlefile" "latest" "/usr/local/bin" "wings_linux_amd64"
-    chmod u+x /usr/local/bin/wings
-    echo "${RELEASE}" >/opt/${APP}_version.txt
-    msg_ok "Updated $APP to v${RELEASE}"
 
     msg_info "Starting Service"
     systemctl start wings
     msg_ok "Started Service"
     msg_ok "Updated successfully!"
-  else
-    msg_ok "No update required. ${APP} is already at v${RELEASE}"
   fi
   exit
 }

ct/rabbitmq.sh

@@ -29,16 +29,11 @@ function update_script() {
   fi
   if grep -q "dl.cloudsmith.io" /etc/apt/sources.list.d/rabbitmq.list; then
     rm -f /etc/apt/sources.list.d/rabbitmq.list
-    cat <<EOF >/etc/apt/sources.list.d/rabbitmq.list
+    setup_deb822_repo \
-## Modern Erlang/OTP releases
+      "rabbitmq" \
-deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-erlang/debian/trixie trixie main
+      "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" \
-deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-erlang/debian/trixie trixie main
+      "https://deb1.rabbitmq.com/rabbitmq-server/debian/trixie" \
-
+      "trixie"
-## Provides modern RabbitMQ releases
-deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
-deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
-EOF
-    $STD apt update
   fi
 
   msg_info "Stopping Service"

ct/rdtclient.sh

@@ -41,7 +41,7 @@ function update_script() {
     cp -R /opt/rdtc-backup/appsettings.json /opt/rdtc/
     if dpkg-query -W dotnet-sdk-8.0 >/dev/null 2>&1; then
       $STD apt remove --purge -y dotnet-sdk-8.0
-      $STD apt install -y dotnet-sdk-9.0
+      $STD apt install -y aspnetcore-runtime-9.0
     fi
     rm -rf /opt/rdtc-backup
 

ct/reactive-resume.sh

@@ -33,12 +33,11 @@ function update_script() {
     systemctl stop Reactive-Resume
     msg_ok "Stopped services"
 
-    cp /opt/"$APP"/.env /opt/rxresume.env
+    cp /opt/Reactive-Resume/.env /opt/rxresume.env
-
     fetch_and_deploy_gh_release "Reactive-Resume" "lazy-media/Reactive-Resume" "tarball" "latest" "/opt/Reactive-Resume"
 
-    msg_info "Updating $APP"
+    msg_info "Updating Reactive-Resume"
-    cd /opt/"$APP"
+    cd /opt/Reactive-Resume
     export PUPPETEER_SKIP_DOWNLOAD="true"
     export NEXT_TELEMETRY_DISABLED=1
     export CI="true"
@@ -46,8 +45,8 @@ function update_script() {
     $STD pnpm install --frozen-lockfile
     $STD pnpm run build
     $STD pnpm run prisma:generate
-    mv /opt/rxresume.env /opt/"$APP"/.env
+    mv /opt/rxresume.env /opt/Reactive-Resume/.env
-    msg_ok "Updated $APP"
+    msg_ok "Updated Reactive-Resume"
 
     msg_info "Updating Minio"
     systemctl stop minio

ct/redis.sh

@@ -27,9 +27,10 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+
   msg_info "Updating $APP LXC"
   $STD apt update
-  $STD apt -y upgrade
+  $STD apt upgrade -y
   msg_ok "Updated $APP LXC"
   msg_ok "Updated successfully!"
   exit

ct/reitti.sh

@@ -32,6 +32,8 @@ function update_script() {
     systemctl stop reitti
     msg_ok "Stopped Service"
 
+    JAVA_VERSION="25" setup_java
+
     rm -f /opt/reitti/reitti.jar
     USE_ORIGINAL_FILENAME="true" fetch_and_deploy_gh_release "reitti" "dedicatedcode/reitti" "singlefile" "latest" "/opt/reitti" "reitti-app.jar"
     mv /opt/reitti/reitti-*.jar /opt/reitti/reitti.jar

ct/resiliosync.sh

@@ -27,9 +27,9 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-    msg_info "Updating ${APP} LXC"
+  msg_info "Updating Resilio Sync"
   $STD apt update
-    $STD apt -y upgrade
+  $STD apt upgrade -y
   msg_ok "Updated successfully!"
   exit
 }

ct/salt.sh

@@ -29,16 +29,14 @@ function update_script() {
     exit
   fi
 
-  RELEASE=$(curl -fsSL https://api.github.com/repos/saltstack/salt/releases/latest | jq -r .tag_name | sed 's/^v//')
+  RELEASE=$(get_latest_github_release "saltstack/salt")
-  if [[ ! -f /~.salt ]] || [[ "${RELEASE}" != "$(cat /~.salt)" ]]; then
+  if check_for_gh_release "salt" "saltstack/salt"; then
-    msg_info "Updating $APP to ${RELEASE}"
+    msg_info "Updating Salt"
     sed -i "s/^\(Pin: version \).*/\1${RELEASE}/" /etc/apt/preferences.d/salt-pin-1001
     $STD apt update
     $STD apt upgrade -y
     echo "${RELEASE}" >/~.salt
     msg_ok "Updated successfully!"
-  else
-    msg_ok "${APP} is already up to date (${RELEASE})"
   fi
   exit
 }

ct/scanopy.sh

@@ -0,0 +1,99 @@
+#!/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: vhsdream
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/scanopy/scanopy
+
+APP="Scanopy"
+var_tags="${var_tags:-analytics}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-3072}"
+var_disk="${var_disk:-6}"
+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/scanopy ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_release "scanopy" "scanopy/scanopy"; then
+    msg_info "Stopping services"
+    systemctl stop scanopy-daemon scanopy-server
+    msg_ok "Stopped services"
+
+    msg_info "Backing up configurations"
+    cp /opt/scanopy/.env /opt/scanopy.env.bak
+    if [[ -f /opt/scanopy/oidc.toml ]]; then
+      cp /opt/scanopy/oidc.toml /opt/scanopy.oidc.toml
+    fi
+    msg_ok "Backed up configurations"
+
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "scanopy" "scanopy/scanopy" "tarball" "latest" "/opt/scanopy"
+
+    if ! dpkg -l | grep -q "pkg-config"; then
+      $STD apt install -y pkg-config
+    fi
+    if ! dpkg -l | grep -q "libssl-dev"; then
+      $STD apt install -y libssl-dev
+    fi
+    TOOLCHAIN="$(grep "channel" /opt/scanopy/backend/rust-toolchain.toml | awk -F\" '{print $2}')"
+    RUST_TOOLCHAIN=$TOOLCHAIN setup_rust
+
+    mv /opt/scanopy.env.bak /opt/scanopy/.env
+    if [[ -f /opt/scanopy.oidc.toml ]]; then
+      mv /opt/scanopy.oidc.toml /opt/scanopy/oidc.toml
+    fi
+    LOCAL_IP="$(hostname -I | awk '{print $1}')"
+    if ! grep -q "PUBLIC_URL" /opt/scanopy/.env; then
+      sed -i "\|_PATH=|a\scanopy_PUBLIC_URL=http://${LOCAL_IP}:60072" /opt/scanopy/.env
+    fi
+    sed -i 's|_TARGET=.*$|_URL=http://127.0.0.1:60072|' /opt/scanopy/.env
+
+    msg_info "Creating frontend UI"
+    export PUBLIC_SERVER_HOSTNAME=default
+    export PUBLIC_SERVER_PORT=""
+    cd /opt/scanopy/ui
+    $STD npm ci --no-fund --no-audit
+    $STD npm run build
+    msg_ok "Created frontend UI"
+
+    msg_info "Building scanopy-server (patience)"
+    cd /opt/scanopy/backend
+    $STD cargo build --release --bin server
+    mv ./target/release/server /usr/bin/scanopy-server
+    msg_ok "Built scanopy-server"
+
+    msg_info "Building scanopy-daemon"
+    $STD cargo build --release --bin daemon
+    cp ./target/release/daemon /usr/bin/scanopy-daemon
+    msg_ok "Built scanopy-daemon"
+
+    msg_info "Starting services"
+    systemctl start scanopy-server scanopy-daemon
+    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}:60072${CL}"
+echo -e "${INFO}${YW} Then create your account, and run the 'configure_daemon.sh' script to setup the daemon.${CL}"

ct/semaphore.sh

@@ -33,7 +33,7 @@ function update_script() {
     systemctl stop semaphore
     msg_ok "Stopped Service"
 
-    fetch_and_deploy_gh_release "semaphore" "semaphoreui/semaphore" "binary"
+    fetch_and_deploy_gh_release "semaphore" "semaphoreui/semaphore" "binary" "latest" "/opt/semaphore" "semaphore_*_linux_amd64.deb"
 
     msg_info "Starting Service"
     systemctl start semaphore

ct/shinobi.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-ubuntu}"
 var_version="${var_version:-24.04}"
 var_unprivileged="${var_unprivileged:-0}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables
@@ -27,6 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_info "Updating Shinobi"
   cd /opt/Shinobi
   $STD sh UPDATE.sh

ct/snipeit.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   if ! grep -q "client_max_body_size[[:space:]]\+100M;" /etc/nginx/conf.d/snipeit.conf; then
     sed -i '/index index.php;/i \        client_max_body_size 100M;' /etc/nginx/conf.d/snipeit.conf
   fi

ct/spoolman.sh

@@ -27,32 +27,29 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  RELEASE=$(curl -fsSL https://github.com/Donkie/Spoolman/releases/latest | grep "title>Release" | cut -d " " -f 4)
-  if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
 
+  if check_for_gh_release "spoolman" "Donkie/Spoolman"; then
     msg_info "Stopping Service"
     systemctl stop spoolman
     msg_ok "Stopped Service"
 
-    msg_info "Updating ${APP} to ${RELEASE}"
+    msg_info "Creating Backup"
-    cd /opt
+    [ -d /opt/spoolman_bak ] && rm -rf /opt/spoolman_bak
-    rm -rf spoolman_bak
+    mv /opt/spoolman /opt/spoolman_bak
-    mv spoolman spoolman_bak
+    msg_ok "Created Backup"
-    curl -fsSL "https://github.com/Donkie/Spoolman/releases/download/${RELEASE}/spoolman.zip" -o $(basename "https://github.com/Donkie/Spoolman/releases/download/${RELEASE}/spoolman.zip")
+
-    $STD unzip spoolman.zip -d spoolman
+    fetch_and_deploy_gh_release "spoolman" "Donkie/Spoolman" "prebuild" "latest" "/opt/spoolman" "spoolman.zip"
-    cd spoolman
+
+    msg_info "Updating Spoolman"
+    cd /opt/spoolman
     $STD pip3 install -r requirements.txt
-    curl -fsSL "https://raw.githubusercontent.com/Donkie/Spoolman/master/.env.example" -o ".env"
+    cp /opt/spoolman_bak/.env /opt/spoolman
-    rm -rf /opt/spoolman.zip
+    msg_ok "Updated Spoolman"
-    echo "${RELEASE}" >/opt/${APP}_version.txt
-    msg_ok "Updated ${APP} to ${RELEASE}"
 
     msg_info "Starting Service"
     systemctl start spoolman
     msg_ok "Started Service"
     msg_ok "Updated successfully!"
-  else
-    msg_ok "No update required. ${APP} is already at ${RELEASE}"
   fi
   exit
 }

ct/technitiumdns.sh

@@ -47,6 +47,8 @@ function update_script() {
     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/
     rm -f /opt/DnsServerPortable.tar.gz
+    echo "${RELEASE}" >~/.technitium
+    systemctl restart technitium
     msg_ok "Updated Technitium DNS"
     msg_ok "Updated successfully!"
   else

ct/telegraf.sh

@@ -34,7 +34,7 @@ function update_script() {
 
   msg_info "Updating Telegraf"
   $STD apt update
-  $STD apt upgrade telegraf -y
+  $STD apt upgrade -y telegraf
   msg_ok "Updated Telegraf"
 
   msg_info "Starting Service"

ct/threadfin.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-4}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/tracktor.sh

@@ -34,38 +34,39 @@ function update_script() {
     msg_ok "Stopped Service"
 
     msg_info "Correcting Services"
-    if [ -f /opt/tracktor/app/backend/.env ]; then
-      mv /opt/tracktor/app/backend/.env /opt/tracktor.env
-      echo 'AUTH_PIN=123456' >>/opt/tracktor.env
-      sed -i 's|^EnvironmentFile=.*|EnvironmentFile=/opt/tracktor.env|' /etc/systemd/system/tracktor.service
-      systemctl daemon-reload
-    fi
     if [ ! -d "/opt/tracktor-data/uploads" ]; then
       mkdir -p /opt/tracktor-data/{uploads,logs}
-      EXISTING_AUTH_PIN=$(grep '^AUTH_PIN=' /opt/tracktor.env 2>/dev/null | cut -d'=' -f2)
+    fi
-      AUTH_PIN=${EXISTING_AUTH_PIN:-123456}
+    if ! grep -qxF 'BODY_SIZE_LIMIT=Infinity' /opt/tracktor.env; then
+      rm /opt/tracktor.env
+    cat <<EOF >/opt/tracktor.env
 cat <<EOF >/opt/tracktor.env
 NODE_ENV=production
+# Set this to the path of the database file. Default - ./tracktor.db
 DB_PATH=/opt/tracktor-data/tracktor.db
+# Set this to the path of the uploads directory. Default - ./uploads
 UPLOADS_DIR="/opt/tracktor-data/uploads"
+# Set this to the path of the logs directory. Default - ./logs
 LOG_DIR="/opt/tracktor-data/logs"
-# If server host is not set by default it will run on all interfaces - 0.0.0.0
+# Hostname to bind the server to. Default - 0.0.0.0
-# SERVER_HOST="" 
+#HOST="0.0.0.0"
-SERVER_PORT=3000
+# Port to bind the server to. Default - 3000
-# Set this if you want to secure your endpoints otherwise default will be "*"
+#PORT=3000
-CORS_ORIGINS="*"
+# Set this to remove upload size limitations. Default - 512 Kb
-# Set this if you are using backend and frontend separately.
+BODY_SIZE_LIMIT=Infinity
-# PUBLIC_API_BASE_URL=""
+# Enable request logging. Default - true
-LOG_REQUESTS=true
+#LOG_REQUESTS=true
-LOG_LEVEL="info"
+# Set the logging level. Options - error, warn, info, verbose, debug, silly. Default - info
-AUTH_PIN=${AUTH_PIN}
+#LOG_LEVEL="info"
-# PUBLIC_DEMO_MODE=false
+# Enable demo mode. Default - false
+#TRACKTOR_DEMO_MODE=false
+# Force reseeding of data on every startup. Default - false
 #FORCE_DATA_SEED=false
 EOF
     fi
     msg_ok "Corrected Services"
 
-    NODE_VERSION="22" setup_nodejs
+    NODE_VERSION="24" setup_nodejs
     CLEAN_INSTALL=1 fetch_and_deploy_gh_release "tracktor" "javedh-dev/tracktor" "tarball" "latest" "/opt/tracktor"
 
     msg_info "Updating tracktor"

ct/tunarr.sh

@@ -40,7 +40,9 @@ function update_script() {
       msg_error "Backup failed: /usr/local/share/tunarr does not exist"
     fi
 
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "tunarr" "chrisbenincasa/tunarr" "singlefile" "latest" "/opt/tunarr" "*linux-x64"
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "tunarr" "chrisbenincasa/tunarr" "prebuild" "latest" "/opt/tunarr" "*linux-x64.tar.gz"
+    cd /opt/tunarr
+    mv tunarr* tunarr
 
     msg_info "Starting Service"
     systemctl start tunarr

ct/uhf.sh

@@ -13,6 +13,7 @@ var_disk="${var_disk:-8}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-13}"
 var_unprivileged="${var_unprivileged:-1}"
+var_gpu="${var_gpu:-yes}"
 
 header_info "$APP"
 variables

ct/umami.sh

@@ -37,8 +37,8 @@ function update_script() {
 
     msg_info "Updating Umami"
     cd /opt/umami
-    $STD yarn install
+    $STD pnpm install
-    $STD yarn run build
+    $STD pnpm run build
     msg_ok "Updated Umami"
 
     msg_info "Starting Service"

ct/unifi.sh

@@ -28,6 +28,8 @@ function update_script() {
     exit
   fi
 
+  JAVA_VERSION="21" setup_java
+
   msg_info "Updating ${APP}"
   $STD apt update --allow-releaseinfo-change
   $STD apt install -y unifi

ct/wallabag.sh

@@ -28,7 +28,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-
+  setup_mariadb
   if check_for_gh_release "wallabag" "wallabag/wallabag"; then
     msg_info "Stopping Services"
     systemctl stop nginx php8.3-fpm

ct/wavelog.sh

@@ -27,7 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-
+  setup_mariadb
   if check_for_gh_release "wavelog" "wavelog/wavelog"; then
     msg_info "Stopping Services"
     systemctl stop apache2

ct/wordpress.sh

@@ -27,6 +27,7 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
+  setup_mariadb
   msg_error "Wordpress should be updated via the user interface."
   exit
 }

ct/zabbix.sh

@@ -67,10 +67,18 @@ function update_script() {
 
   rm -Rf /etc/apt/sources.list.d/zabbix.list
   cd /tmp
+
+  if [[ "$ZABBIX_VERSION" == "7.0" ]]; then
+    ZABBIX_DEB_URL="https://repo.zabbix.com/zabbix/${ZABBIX_VERSION}/debian/pool/main/z/zabbix-release/zabbix-release_latest_${ZABBIX_VERSION}+debian13_all.deb"
+    ZABBIX_DEB_FILE="zabbix-release_latest_${ZABBIX_VERSION}+debian13_all.deb"
+  else
     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
+    ZABBIX_DEB_FILE="zabbix-release_latest+debian13_all.deb"
-  $STD dpkg -i zabbix-release_latest+debian13_all.deb
+  fi
-  rm -rf /tmp/zabbix-release_latest+debian13_all.deb
+
+  curl -fsSL "$ZABBIX_DEB_URL" -o /tmp/"$ZABBIX_DEB_FILE"
+  $STD dpkg -i /tmp/"$ZABBIX_DEB_FILE"
+  rm -rf /tmp/zabbix-release_*.deb
   $STD apt update
 
   $STD apt install --only-upgrade zabbix-server-pgsql zabbix-frontend-php php8.4-pgsql

docs/contribution/HELPER_FUNCTIONS.md

@@ -0,0 +1,690 @@
+# 🛠️ Helper Functions Reference
+
+**Quick reference for all helper functions available in `tools.func`**
+
+> These functions are automatically available in install scripts via `$FUNCTIONS_FILE_PATH`
+
+---
+
+## 📋 Table of Contents
+
+- [Scripts to Watch](#scripts-to-watch)
+- [Runtime & Language Setup](#runtime--language-setup)
+- [Database Setup](#database-setup)
+- [GitHub Release Helpers](#github-release-helpers)
+- [Tools & Utilities](#tools--utilities)
+- [SSL/TLS](#ssltls)
+- [Utility Functions](#utility-functions)
+- [Package Management](#package-management)
+
+---
+
+## 📚 Scripts to Watch
+
+**Learn from real, well-implemented scripts. Each app requires TWO files that work together:**
+
+| File               | Location                     | Purpose                                                                  |
+| ------------------ | ---------------------------- | ------------------------------------------------------------------------ |
+| **CT Script**      | `ct/appname.sh`              | Runs on **Proxmox host** - creates container, contains `update_script()` |
+| **Install Script** | `install/appname-install.sh` | Runs **inside container** - installs and configures the app              |
+
+> ⚠️ **Both files are ALWAYS required!** The CT script calls the install script automatically during container creation.
+
+### Node.js + PostgreSQL
+
+**Koel** - Music streaming with PHP + Node.js + PostgreSQL
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/koel.sh](../../ct/koel.sh) |
+| Install | [install/koel-install.sh](../../install/koel-install.sh) |
+
+**Actual Budget** - Finance app with npm global install
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/actualbudget.sh](../../ct/actualbudget.sh) |
+| Install | [install/actualbudget-install.sh](../../install/actualbudget-install.sh) |
+
+### Python + uv
+
+**MeTube** - YouTube downloader with Python uv + Node.js + Deno
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/metube.sh](../../ct/metube.sh) |
+| Install | [install/metube-install.sh](../../install/metube-install.sh) |
+
+**Endurain** - Fitness tracker with Python uv + PostgreSQL/PostGIS
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/endurain.sh](../../ct/endurain.sh) |
+| Install | [install/endurain-install.sh](../../install/endurain-install.sh) |
+
+### PHP + MariaDB/MySQL
+
+**Wallabag** - Read-it-later with PHP + MariaDB + Redis + Nginx
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/wallabag.sh](../../ct/wallabag.sh) |
+| Install | [install/wallabag-install.sh](../../install/wallabag-install.sh) |
+
+**InvoiceNinja** - Invoicing with PHP + MariaDB + Supervisor
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/invoiceninja.sh](../../ct/invoiceninja.sh) |
+| Install | [install/invoiceninja-install.sh](../../install/invoiceninja-install.sh) |
+
+**BookStack** - Wiki/Docs with PHP + MariaDB + Apache
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/bookstack.sh](../../ct/bookstack.sh) |
+| Install | [install/bookstack-install.sh](../../install/bookstack-install.sh) |
+
+### PHP + SQLite (Simple)
+
+**Speedtest Tracker** - Speedtest with PHP + SQLite + Nginx
+| File | Link |
+|------|------|
+| CT (update logic) | [ct/speedtest-tracker.sh](../../ct/speedtest-tracker.sh) |
+| Install | [install/speedtest-tracker-install.sh](../../install/speedtest-tracker-install.sh) |
+
+---
+
+## Runtime & Language Setup
+
+### `setup_nodejs`
+
+Install Node.js from NodeSource repository.
+
+```bash
+# Default (Node.js 22)
+setup_nodejs
+
+# Specific version
+NODE_VERSION="20" setup_nodejs
+NODE_VERSION="22" setup_nodejs
+NODE_VERSION="24" setup_nodejs
+```
+
+### `setup_go`
+
+Install Go programming language (latest stable).
+
+```bash
+setup_go
+
+# Use in script
+setup_go
+cd /opt/myapp
+$STD go build -o myapp .
+```
+
+### `setup_rust`
+
+Install Rust via rustup.
+
+```bash
+setup_rust
+
+# Use in script
+setup_rust
+source "$HOME/.cargo/env"
+$STD cargo build --release
+```
+
+### `setup_uv`
+
+Install Python uv package manager (fast pip/venv replacement).
+
+```bash
+setup_uv
+
+# Use in script
+setup_uv
+cd /opt/myapp
+$STD uv sync --locked
+```
+
+### `setup_ruby`
+
+Install Ruby from official repositories.
+
+```bash
+setup_ruby
+```
+
+### `setup_php`
+
+Install PHP with configurable modules and FPM/Apache support.
+
+```bash
+# Basic PHP
+setup_php
+
+# Full configuration
+PHP_VERSION="8.3" \
+PHP_MODULE="mysqli,gd,curl,mbstring,xml,zip,ldap" \
+PHP_FPM="YES" \
+PHP_APACHE="YES" \
+setup_php
+```
+
+**Environment Variables:**
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PHP_VERSION` | `8.3` | PHP version to install |
+| `PHP_MODULE` | `""` | Comma-separated list of modules |
+| `PHP_FPM` | `NO` | Install PHP-FPM |
+| `PHP_APACHE` | `NO` | Install Apache module |
+
+### `setup_composer`
+
+Install PHP Composer package manager.
+
+```bash
+setup_php
+setup_composer
+
+# Use in script
+$STD composer install --no-dev
+```
+
+### `setup_java`
+
+Install Java (OpenJDK).
+
+```bash
+# Default (Java 21)
+setup_java
+
+# Specific version
+JAVA_VERSION="17" setup_java
+JAVA_VERSION="21" setup_java
+```
+
+---
+
+## Database Setup
+
+### `setup_mariadb`
+
+Install MariaDB server.
+
+```bash
+setup_mariadb
+```
+
+### `setup_mariadb_db`
+
+Create a MariaDB database and user. Sets `$MARIADB_DB_PASS` with the generated password.
+
+```bash
+setup_mariadb
+MARIADB_DB_NAME="myapp_db" MARIADB_DB_USER="myapp_user" setup_mariadb_db
+
+# After calling, these variables are available:
+# $MARIADB_DB_NAME - Database name
+# $MARIADB_DB_USER - Database user
+# $MARIADB_DB_PASS - Generated password (saved to ~/[appname].creds)
+```
+
+### `setup_mysql`
+
+Install MySQL server.
+
+```bash
+setup_mysql
+```
+
+### `setup_postgresql`
+
+Install PostgreSQL server.
+
+```bash
+# Default (PostgreSQL 17)
+setup_postgresql
+
+# Specific version
+PG_VERSION="16" setup_postgresql
+PG_VERSION="17" setup_postgresql
+```
+
+### `setup_postgresql_db`
+
+Create a PostgreSQL database and user. Sets `$PG_DB_PASS` with the generated password.
+
+```bash
+PG_VERSION="17" setup_postgresql
+PG_DB_NAME="myapp_db" PG_DB_USER="myapp_user" setup_postgresql_db
+
+# After calling, these variables are available:
+# $PG_DB_NAME - Database name
+# $PG_DB_USER - Database user
+# $PG_DB_PASS - Generated password (saved to ~/[appname].creds)
+```
+
+### `setup_mongodb`
+
+Install MongoDB server.
+
+```bash
+setup_mongodb
+```
+
+### `setup_clickhouse`
+
+Install ClickHouse analytics database.
+
+```bash
+setup_clickhouse
+```
+
+---
+
+## GitHub Release Helpers
+
+> **Note**: `fetch_and_deploy_gh_release` is the **preferred method** for downloading GitHub releases. It handles version tracking automatically. Only use `get_latest_github_release` if you need the version number separately.
+
+### `fetch_and_deploy_gh_release`
+
+**Primary method** for downloading and extracting GitHub releases. Handles version tracking automatically.
+
+```bash
+# Basic usage - downloads tarball to /opt/appname
+fetch_and_deploy_gh_release "appname" "owner/repo"
+
+# With explicit parameters
+fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
+
+# Pre-built release with specific asset pattern
+fetch_and_deploy_gh_release "koel" "koel/koel" "prebuild" "latest" "/opt/koel" "koel-*.tar.gz"
+
+# Clean install (removes old directory first) - used in update_script
+CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
+```
+
+**Parameters:**
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `name` | required | App name (for version tracking) |
+| `repo` | required | GitHub repo (`owner/repo`) |
+| `type` | `tarball` | Release type: `tarball`, `zipball`, `prebuild`, `binary` |
+| `version` | `latest` | Version tag or `latest` |
+| `dest` | `/opt/[name]` | Destination directory |
+| `asset_pattern` | `""` | For `prebuild`: glob pattern to match asset (e.g. `app-*.tar.gz`) |
+
+**Environment Variables:**
+| Variable | Description |
+|----------|-------------|
+| `CLEAN_INSTALL=1` | Remove destination directory before extracting (for updates) |
+
+### `check_for_gh_release`
+
+Check if a newer version is available. Returns 0 if update needed, 1 if already at latest. **Use in `update_script()` function.**
+
+```bash
+# In update_script() function in ct/appname.sh
+if check_for_gh_release "appname" "owner/repo"; then
+  msg_info "Updating..."
+  # Stop services, backup, update, restore, start
+  CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo"
+  msg_ok "Updated successfully"
+fi
+```
+
+### `get_latest_github_release`
+
+Get the latest release version from a GitHub repository. **Only use if you need the version number separately** (e.g., for manual download or display).
+
+```bash
+RELEASE=$(get_latest_github_release "owner/repo")
+echo "Latest version: $RELEASE"
+```
+
+# Examples
+
+fetch_and_deploy_gh_release "bookstack" "BookStackApp/BookStack"
+fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/myapp"
+
+````
+
+**Parameters:**
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `name` | required | App name (for version tracking) |
+| `repo` | required | GitHub repo (`owner/repo`) |
+| `type` | `tarball` | Release type: `tarball`, `zipball`, `binary` |
+| `version` | `latest` | Version tag or `latest` |
+| `dest` | `/opt/[name]` | Destination directory |
+
+---
+
+## Tools & Utilities
+
+### `setup_yq`
+
+Install yq YAML processor.
+
+```bash
+setup_yq
+
+# Use in script
+yq '.server.port = 8080' -i config.yaml
+````
+
+### `setup_ffmpeg`
+
+Install FFmpeg with common codecs.
+
+```bash
+setup_ffmpeg
+```
+
+### `setup_hwaccel`
+
+Setup GPU hardware acceleration (Intel/AMD/NVIDIA).
+
+```bash
+# Only runs if GPU passthrough is detected (/dev/dri, /dev/nvidia0, /dev/kfd)
+setup_hwaccel
+```
+
+### `setup_imagemagick`
+
+Install ImageMagick 7 from source.
+
+```bash
+setup_imagemagick
+```
+
+### `setup_docker`
+
+Install Docker Engine.
+
+```bash
+setup_docker
+```
+
+### `setup_adminer`
+
+Install Adminer for database management.
+
+```bash
+setup_mariadb
+setup_adminer
+
+# Access at http://IP/adminer
+```
+
+---
+
+## SSL/TLS
+
+### `create_self_signed_cert`
+
+Create a self-signed SSL certificate.
+
+```bash
+create_self_signed_cert
+
+# Creates files at:
+# /etc/ssl/[appname]/[appname].key
+# /etc/ssl/[appname]/[appname].crt
+```
+
+---
+
+## Utility Functions
+
+### `import_local_ip`
+
+Set the `$LOCAL_IP` variable with the container's IP address.
+
+```bash
+import_local_ip
+echo "Container IP: $LOCAL_IP"
+
+# Use in config files
+sed -i "s/localhost/$LOCAL_IP/g" /opt/myapp/config.yaml
+```
+
+### `ensure_dependencies`
+
+Ensure packages are installed (installs if missing).
+
+```bash
+ensure_dependencies "jq" "unzip" "curl"
+```
+
+### `msg_info` / `msg_ok` / `msg_error` / `msg_warn`
+
+Display formatted messages.
+
+```bash
+msg_info "Installing application..."
+# ... do work ...
+msg_ok "Installation complete"
+
+msg_warn "Optional feature not available"
+msg_error "Installation failed"
+```
+
+---
+
+## Package Management
+
+### `cleanup_lxc`
+
+Final cleanup function - call at end of install script.
+
+```bash
+# At the end of your install script
+motd_ssh
+customize
+cleanup_lxc  # Handles autoremove, autoclean, cache cleanup
+```
+
+### `install_packages_with_retry`
+
+Install packages with automatic retry on failure.
+
+```bash
+install_packages_with_retry "package1" "package2" "package3"
+```
+
+### `prepare_repository_setup`
+
+Prepare system for adding new repositories (cleanup old repos, keyrings).
+
+```bash
+prepare_repository_setup "mariadb" "mysql"
+```
+
+---
+
+## Complete Examples
+
+### Example 1: Node.js App with PostgreSQL (install script)
+
+```bash
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: YourUsername
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/example/myapp
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Installing Dependencies"
+$STD apt install -y nginx
+msg_ok "Installed Dependencies"
+
+# Setup runtimes and databases FIRST
+NODE_VERSION="22" setup_nodejs
+PG_VERSION="17" setup_postgresql
+PG_DB_NAME="myapp" PG_DB_USER="myapp" setup_postgresql_db
+import_local_ip
+
+# Download app using fetch_and_deploy (handles version tracking)
+fetch_and_deploy_gh_release "myapp" "example/myapp" "tarball" "latest" "/opt/myapp"
+
+msg_info "Setting up MyApp"
+cd /opt/myapp
+$STD npm ci --production
+msg_ok "Setup MyApp"
+
+msg_info "Configuring MyApp"
+cat <<EOF >/opt/myapp/.env
+DATABASE_URL=postgresql://${PG_DB_USER}:${PG_DB_PASS}@localhost/${PG_DB_NAME}
+HOST=${LOCAL_IP}
+PORT=3000
+EOF
+msg_ok "Configured MyApp"
+
+msg_info "Creating Service"
+cat <<EOF >/etc/systemd/system/myapp.service
+[Unit]
+Description=MyApp
+After=network.target postgresql.service
+
+[Service]
+Type=simple
+WorkingDirectory=/opt/myapp
+ExecStart=/usr/bin/node /opt/myapp/server.js
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl enable -q --now myapp
+msg_ok "Created Service"
+
+motd_ssh
+customize
+cleanup_lxc
+```
+
+### Example 2: Matching Container Script (ct script)
+
+```bash
+#!/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: YourUsername
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/example/myapp
+
+APP="MyApp"
+var_tags="${var_tags:-webapp}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-2048}"
+var_disk="${var_disk:-6}"
+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/myapp ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  # check_for_gh_release returns true if update available
+  if check_for_gh_release "myapp" "example/myapp"; then
+    msg_info "Stopping Service"
+    systemctl stop myapp
+    msg_ok "Stopped Service"
+
+    msg_info "Creating Backup"
+    cp /opt/myapp/.env /tmp/myapp_env.bak
+    msg_ok "Created Backup"
+
+    # CLEAN_INSTALL=1 removes old dir before extracting
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "myapp" "example/myapp" "tarball" "latest" "/opt/myapp"
+
+    msg_info "Restoring Config & Rebuilding"
+    cp /tmp/myapp_env.bak /opt/myapp/.env
+    rm /tmp/myapp_env.bak
+    cd /opt/myapp
+    $STD npm ci --production
+    msg_ok "Restored Config & Rebuilt"
+
+    msg_info "Starting Service"
+    systemctl start myapp
+    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}"
+```
+
+### Example 3: PHP App with MariaDB (install script)
+
+```bash
+#!/usr/bin/env bash
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Installing Dependencies"
+$STD apt install -y nginx
+msg_ok "Installed Dependencies"
+
+# PHP with FPM and common modules
+PHP_VERSION="8.4" PHP_FPM="YES" PHP_MODULE="bcmath,curl,gd,intl,mbstring,mysql,xml,zip" setup_php
+setup_composer
+setup_mariadb
+MARIADB_DB_NAME="myapp" MARIADB_DB_USER="myapp" setup_mariadb_db
+import_local_ip
+
+# Download pre-built release (with asset pattern)
+fetch_and_deploy_gh_release "myapp" "example/myapp" "prebuild" "latest" "/opt/myapp" "myapp-*.tar.gz"
+
+msg_info "Configuring MyApp"
+cd /opt/myapp
+cp .env.example .env
+sed -i "s|APP_URL=.*|APP_URL=http://${LOCAL_IP}|" .env
+sed -i "s|DB_DATABASE=.*|DB_DATABASE=${MARIADB_DB_NAME}|" .env
+sed -i "s|DB_USERNAME=.*|DB_USERNAME=${MARIADB_DB_USER}|" .env
+sed -i "s|DB_PASSWORD=.*|DB_PASSWORD=${MARIADB_DB_PASS}|" .env
+$STD composer install --no-dev --no-interaction
+$STD php artisan key:generate --force
+$STD php artisan migrate --force
+chown -R www-data:www-data /opt/myapp
+msg_ok "Configured MyApp"
+
+# ... nginx config, service creation ...
+
+motd_ssh
+customize
+cleanup_lxc
+```

docs/contribution/README.md

@@ -65,6 +65,7 @@ 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
@@ -97,6 +98,8 @@ All scripts and configurations must follow our coding standards to ensure consis
 
 - **[CONTRIBUTING.md](CONTRIBUTING.md)** - Essential coding standards and best practices
 - **[CODE_AUDIT.md](CODE_AUDIT.md)** - Code review checklist and audit procedures
+- **[GUIDE.md](GUIDE.md)** - Comprehensive contribution guide
+- **[HELPER_FUNCTIONS.md](HELPER_FUNCTIONS.md)** - Reference for all tools.func helper functions
 - **Container Scripts** - `/ct/` templates and guidelines
 - **Install Scripts** - `/install/` templates and guidelines
 - **JSON Configurations** - `/json/` structure and format
@@ -121,6 +124,7 @@ 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
@@ -145,6 +149,7 @@ Key points:
 ### 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
@@ -156,16 +161,24 @@ See [USER_SUBMITTED_GUIDES.md](USER_SUBMITTED_GUIDES.md) for excellent community
 Use these templates when creating new scripts:
 
 ```bash
-# Container script
+# Container script template
-cp ct/example.sh ct/my-app.sh
+cp docs/contribution/templates_ct/AppName.sh ct/my-app.sh
 
-# Installation script
+# Installation script template
-cp install/example-install.sh install/my-app-install.sh
+cp docs/contribution/templates_install/AppName-install.sh install/my-app-install.sh
 
-# JSON configuration (if needed)
+# JSON configuration template
-cp json/example.json json/my-app.json
+cp docs/contribution/templates_json/AppName.json frontend/public/json/my-app.json
 ```
 
+**Template Features:**
+
+- Updated to match current codebase patterns
+- Includes all available helper functions from `tools.func`
+- Examples for Node.js, Python, PHP, Go applications
+- Database setup examples (MariaDB, PostgreSQL)
+- Proper service creation and cleanup
+
 ---
 
 ## 🔄 Git Workflow
@@ -202,18 +215,21 @@ git push origin feature/my-feature
 ### 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)

docs/contribution/templates_ct/AppName.sh

@@ -1,27 +1,31 @@
 #!/usr/bin/env bash
-source <(curl -s https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
 # Copyright (c) 2021-2025 community-scripts ORG
-# Author: [YourUserName]
+# Author: [YourGitHubUsername]
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: [SOURCE_URL]
+# Source: [SOURCE_URL e.g. https://github.com/example/app]
 
 # App Default Values
-APP="[APP_NAME]"
+APP="[AppName]"
-# Name of the app (e.g. Google, Adventurelog, Apache-Guacamole"
+var_tags="${var_tags:-[category]}"
-var_tags="[TAGS]"
+var_cpu="${var_cpu:-2}"
-# Tags for Proxmox VE, maximum 2 pcs., no spaces allowed, separated by a semicolon ; (e.g. database | adblock;dhcp)
+var_ram="${var_ram:-2048}"
-var_cpu="[CPU]"
+var_disk="${var_disk:-4}"
-# Number of cores (1-X) (e.g. 4) - default are 2
+var_os="${var_os:-debian}"
-var_ram="[RAM]"
+var_version="${var_version:-12}"
-# Amount of used RAM in MB (e.g. 2048 or 4096)
+var_unprivileged="${var_unprivileged:-1}"
-var_disk="[DISK]"
+
-# Amount of used disk space in GB (e.g. 4 or 10)
+# =============================================================================
-var_os="[OS]"
+# CONFIGURATION GUIDE
-# Default OS (e.g. debian, ubuntu, alpine)
+# =============================================================================
-var_version="[VERSION]"
+# APP           - Display name, title case (e.g. "Koel", "Wallabag", "Actual Budget")
-# Default OS version (e.g. 12 for debian, 24.04 for ubuntu, 3.20 for alpine)
+# var_tags      - Max 2 tags, semicolon separated (e.g. "music;streaming", "finance")
-var_unprivileged="[UNPRIVILEGED]"
+# var_cpu       - CPU cores: 1-4 typical
-# 1 = unprivileged container, 0 = privileged container
+# var_ram       - RAM in MB: 512, 1024, 2048, 4096 typical
+# var_disk      - Disk in GB: 4, 6, 8, 10, 20 typical
+# var_os        - OS: debian, ubuntu, alpine
+# var_version   - OS version: 12/13 (debian), 22.04/24.04 (ubuntu), 3.20/3.21 (alpine)
+# var_unprivileged - 1 = unprivileged (secure, default), 0 = privileged (for docker etc.)
 
 header_info "$APP"
 variables
@@ -33,45 +37,49 @@ function update_script() {
   check_container_storage
   check_container_resources
 
-    # Check if installation is present | -f for file, -d for folder
+  # Check if installation exists
-    if [[ ! -f [INSTALLATION_CHECK_PATH] ]]; then
+  if [[ ! -d /opt/[appname] ]]; then
     msg_error "No ${APP} Installation Found!"
     exit
   fi
 
-    # Crawling the new version and checking whether an update is required
+  # check_for_gh_release returns 0 (true) if update available, 1 (false) if not
-    RELEASE=$(curl -fsSL [RELEASE_URL] | [PARSE_RELEASE_COMMAND])
+  if check_for_gh_release "[appname]" "[owner/repo]"; then
-    if [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]] || [[ ! -f /opt/${APP}_version.txt ]]; then
+    msg_info "Stopping Services"
-        # Stopping Services
+    systemctl stop [appname]
-        msg_info "Stopping $APP"
+    msg_ok "Stopped Services"
-        systemctl stop [SERVICE_NAME]
-        msg_ok "Stopped $APP"
 
-        # Creating Backup
+    # Optional: Backup important data before update
     msg_info "Creating Backup"
-        tar -czf "/opt/${APP}_backup_$(date +%F).tar.gz" [IMPORTANT_PATHS]
+    mkdir -p /tmp/[appname]_backup
-        msg_ok "Backup Created"
+    cp /opt/[appname]/.env /tmp/[appname]_backup/ 2>/dev/null || true
+    cp -r /opt/[appname]/data /tmp/[appname]_backup/ 2>/dev/null || true
+    msg_ok "Created Backup"
 
-        # Execute Update
+    # CLEAN_INSTALL=1 removes old directory before extracting new version
-        msg_info "Updating $APP to v${RELEASE}"
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "[appname]" "[owner/repo]" "tarball" "latest" "/opt/[appname]"
-        [UPDATE_COMMANDS]
-        msg_ok "Updated $APP to v${RELEASE}"
 
-        # Starting Services
+    # Restore configuration and data
-        msg_info "Starting $APP"
+    msg_info "Restoring Data"
-        systemctl start [SERVICE_NAME]
+    cp /tmp/[appname]_backup/.env /opt/[appname]/ 2>/dev/null || true
-        msg_ok "Started $APP"
+    cp -r /tmp/[appname]_backup/data/* /opt/[appname]/data/ 2>/dev/null || true
+    rm -rf /tmp/[appname]_backup
+    msg_ok "Restored Data"
 
-        # Cleaning up
+    # Optional: Run any post-update commands
-        msg_info "Cleaning Up"
+    msg_info "Running Post-Update Tasks"
-        rm -rf [TEMP_FILES]
+    cd /opt/[appname]
-        msg_ok "Cleanup Completed"
+    # Examples:
+    # $STD npm ci --production
+    # $STD php artisan migrate --force
+    # $STD composer install --no-dev
+    msg_ok "Ran Post-Update Tasks"
 
-        # Last Action
+    msg_info "Starting Services"
-        echo "${RELEASE}" >/opt/${APP}_version.txt
+    systemctl start [appname]
-        msg_ok "Update Successful"
+    msg_ok "Started Services"
-    else
+
-        msg_ok "No update required. ${APP} is already at v${RELEASE}"
+    msg_ok "Updated Successfully"
   fi
   exit
 }

docs/contribution/templates_install/AppName-install.sh

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
 
 # Copyright (c) 2021-2025 community-scripts ORG
-# Author: [YourUserName]
+# Author: [YourGitHubUsername]
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: [SOURCE_URL]
+# Source: [SOURCE_URL e.g. https://github.com/example/app]
 
-# Import Functions und Setup
+# Import Functions and Setup
 source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
 color
 verb_ip6
@@ -14,70 +14,177 @@ setting_up_container
 network_check
 update_os
 
-# Installing Dependencies with the 3 core dependencies (curl;sudo;mc)
+# =============================================================================
+# DEPENDENCIES
+# =============================================================================
+# Only install what's actually needed - curl/sudo/mc are already in the base image
+
 msg_info "Installing Dependencies"
-$STD apt-get install -y \
+$STD apt install -y \
-  curl \
+  nginx \
-  sudo \
+  build-essential
-  mc \
-  [PACKAGE_1] \
-  [PACKAGE_2] \
-  [PACKAGE_3]
 msg_ok "Installed Dependencies"
 
-# Template: MySQL Database
+# =============================================================================
-msg_info "Setting up Database"
+# HELPER FUNCTIONS FROM tools.func
-DB_NAME=[DB_NAME]
+# =============================================================================
-DB_USER=[DB_USER]
+# These functions are available via $FUNCTIONS_FILE_PATH (tools.func)
-DB_PASS=$(openssl rand -base64 18 | tr -dc 'a-zA-Z0-9' | head -c13)
+# Call them with optional environment variables for configuration
-$STD mysql -u root -e "CREATE DATABASE $DB_NAME;"
-$STD mysql -u root -e "CREATE USER '$DB_USER'@'localhost' IDENTIFIED WITH mysql_native_password AS PASSWORD('$DB_PASS');"
-$STD mysql -u root -e "GRANT ALL ON $DB_NAME.* TO '$DB_USER'@'localhost'; FLUSH PRIVILEGES;"
-{
-  echo "${APPLICATION} Credentials"
-  echo "Database User: $DB_USER"
-  echo "Database Password: $DB_PASS"
-  echo "Database Name: $DB_NAME"
-} >>~/$APP_NAME.creds
-msg_ok "Set up Database"
-
-# Temp
-
-# Setup App
-msg_info "Setup ${APPLICATION}"
-RELEASE=$(curl -s https://api.github.com/repos/[REPO]/releases/latest | grep "tag_name" | awk '{print substr($2, 2, length($2)-3) }')
-curl -fsSL "https://github.com/[REPO]/archive/refs/tags/${RELEASE}.zip"
-unzip -q ${RELEASE}.zip
-mv ${APPLICATION}-${RELEASE}/ /opt/${APPLICATION}
 #
+# --- Runtime & Language Setup ---
+# NODE_VERSION="22" setup_nodejs           # Install Node.js (22, 24)
+# NODE_VERSION="24" NODE_MODULE="pnpm" setup_nodejs  # With pnpm
+# PYTHON_VERSION="3.13" setup_uv           # Python with uv package manager
+# setup_go                                 # Install Go (latest)
+# setup_rust                               # Install Rust via rustup
+# setup_ruby                               # Install Ruby
+# PHP_VERSION="8.4" PHP_FPM="YES" PHP_MODULE="mysqli,gd" setup_php
+# PHP_VERSION="8.3" PHP_FPM="YES" PHP_APACHE="YES" PHP_MODULE="bcmath,curl,gd,intl,mbstring,mysql,xml,zip" setup_php
+# setup_composer                           # Install PHP Composer
+# JAVA_VERSION="21" setup_java             # Install Java (17, 21)
 #
+# --- Database Setup ---
+# setup_mariadb                            # Install MariaDB server
+# MARIADB_DB_NAME="mydb" MARIADB_DB_USER="myuser" setup_mariadb_db
+# setup_mysql                              # Install MySQL server
+# PG_VERSION="17" setup_postgresql         # Install PostgreSQL (16, 17)
+# PG_VERSION="17" PG_MODULES="postgis" setup_postgresql  # With extensions
+# PG_DB_NAME="mydb" PG_DB_USER="myuser" setup_postgresql_db
+# setup_mongodb                            # Install MongoDB
 #
-echo "${RELEASE}" >/opt/${APPLICATION}_version.txt
+# --- GitHub Release (PREFERRED METHOD) ---
-msg_ok "Setup ${APPLICATION}"
+# fetch_and_deploy_gh_release "appname" "owner/repo"  # Downloads, extracts, tracks version
+# fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
+# fetch_and_deploy_gh_release "appname" "owner/repo" "prebuild" "latest" "/opt/appname" "app-*.tar.gz"
+#
+# --- Tools & Utilities ---
+# import_local_ip                          # Sets $LOCAL_IP variable (call early!)
+# setup_ffmpeg                             # Install FFmpeg with codecs
+# setup_hwaccel                            # Setup GPU hardware acceleration
+# setup_imagemagick                        # Install ImageMagick 7
+# setup_docker                             # Install Docker Engine
+# setup_adminer                            # Install Adminer for DB management
+# create_self_signed_cert                  # Creates cert in /etc/ssl/[appname]/
+
+# =============================================================================
+# EXAMPLE 1: Node.js Application with PostgreSQL
+# =============================================================================
+# NODE_VERSION="22" setup_nodejs
+# PG_VERSION="17" setup_postgresql
+# PG_DB_NAME="myapp" PG_DB_USER="myapp" setup_postgresql_db
+# import_local_ip
+# fetch_and_deploy_gh_release "myapp" "owner/myapp" "tarball" "latest" "/opt/myapp"
+#
+# msg_info "Configuring MyApp"
+# cd /opt/myapp
+# $STD npm ci
+# cat <<EOF >/opt/myapp/.env
+# DATABASE_URL=postgresql://${PG_DB_USER}:${PG_DB_PASS}@localhost/${PG_DB_NAME}
+# HOST=${LOCAL_IP}
+# PORT=3000
+# EOF
+# msg_ok "Configured MyApp"
+
+# =============================================================================
+# EXAMPLE 2: Python Application with uv
+# =============================================================================
+# PYTHON_VERSION="3.13" setup_uv
+# import_local_ip
+# fetch_and_deploy_gh_release "myapp" "owner/myapp" "tarball" "latest" "/opt/myapp"
+#
+# msg_info "Setting up MyApp"
+# cd /opt/myapp
+# $STD uv sync
+# cat <<EOF >/opt/myapp/.env
+# HOST=${LOCAL_IP}
+# PORT=8000
+# EOF
+# msg_ok "Setup MyApp"
+
+# =============================================================================
+# EXAMPLE 3: PHP Application with MariaDB + Nginx
+# =============================================================================
+# PHP_VERSION="8.4" PHP_FPM="YES" PHP_MODULE="bcmath,curl,gd,intl,mbstring,mysql,xml,zip" setup_php
+# setup_composer
+# setup_mariadb
+# MARIADB_DB_NAME="myapp" MARIADB_DB_USER="myapp" setup_mariadb_db
+# import_local_ip
+# fetch_and_deploy_gh_release "myapp" "owner/myapp" "prebuild" "latest" "/opt/myapp" "myapp-*.tar.gz"
+#
+# msg_info "Configuring MyApp"
+# cd /opt/myapp
+# cp .env.example .env
+# sed -i "s|APP_URL=.*|APP_URL=http://${LOCAL_IP}|" .env
+# sed -i "s|DB_DATABASE=.*|DB_DATABASE=${MARIADB_DB_NAME}|" .env
+# sed -i "s|DB_USERNAME=.*|DB_USERNAME=${MARIADB_DB_USER}|" .env
+# sed -i "s|DB_PASSWORD=.*|DB_PASSWORD=${MARIADB_DB_PASS}|" .env
+# $STD composer install --no-dev --no-interaction
+# chown -R www-data:www-data /opt/myapp
+# msg_ok "Configured MyApp"
+
+# =============================================================================
+# YOUR APPLICATION INSTALLATION
+# =============================================================================
+# 1. Setup runtimes and databases FIRST
+# 2. Call import_local_ip if you need the container IP
+# 3. Use fetch_and_deploy_gh_release to download the app (handles version tracking)
+# 4. Configure the application
+# 5. Create systemd service
+# 6. Finalize with motd_ssh, customize, cleanup_lxc
+
+# --- Setup runtimes/databases ---
+NODE_VERSION="22" setup_nodejs
+import_local_ip
+
+# --- Download and install app ---
+fetch_and_deploy_gh_release "[appname]" "[owner/repo]" "tarball" "latest" "/opt/[appname]"
+
+msg_info "Setting up [AppName]"
+cd /opt/[appname]
+$STD npm ci
+msg_ok "Setup [AppName]"
+
+# =============================================================================
+# CONFIGURATION
+# =============================================================================
+
+msg_info "Configuring [AppName]"
+cat <<EOF >/opt/[appname]/.env
+HOST=${LOCAL_IP}
+PORT=8080
+EOF
+msg_ok "Configured [AppName]"
+
+# =============================================================================
+# SERVICE CREATION
+# =============================================================================
 
-# Creating Service (if needed)
 msg_info "Creating Service"
-cat <<EOF >/etc/systemd/system/${APPLICATION}.service
+cat <<EOF >/etc/systemd/system/[appname].service
 [Unit]
-Description=${APPLICATION} Service
+Description=[AppName] Service
 After=network.target
 
 [Service]
-ExecStart=[START_COMMAND]
+Type=simple
-Restart=always
+User=root
+WorkingDirectory=/opt/[appname]
+ExecStart=/usr/bin/node /opt/[appname]/server.js
+Restart=on-failure
+RestartSec=5
 
 [Install]
 WantedBy=multi-user.target
 EOF
-systemctl enable -q --now ${APPLICATION}.service
+systemctl enable -q --now [appname]
 msg_ok "Created Service"
 
+# =============================================================================
+# CLEANUP & FINALIZATION
+# =============================================================================
+
 motd_ssh
 customize
 
-# Cleanup
+# cleanup_lxc handles: apt autoremove, autoclean, temp files, bash history
-msg_info "Cleaning up"
+cleanup_lxc
-rm -f ${RELEASE}.zip
-$STD apt-get -y autoremove
-$STD apt-get -y autoclean
-msg_ok "Cleaned"

docs/contribution/templates_json/AppName.json

@@ -8,7 +8,7 @@
   "type": "ct",
   "updateable": true,
   "privileged": false,
-    "interface_port": DEFAULT-PORT,
+  "interface_port": "DEFAULT-PORT",
   "documentation": null,
   "website": "LINK TO WEBSITE",
   "logo": "LINK TO LOGO",

docs/guides/DEFAULTS_SYSTEM_GUIDE.md

@@ -434,12 +434,24 @@ var_unprivileged=1     # 0=privileged, 1=unprivileged
 #### Network
 ```bash
 var_brg=vmbr0          # Bridge interface
-var_net=veth           # Network driver
+var_net=dhcp           # dhcp, static IP/CIDR, or IP range (see below)
-var_gateway=192.168.1.1  # Default gateway
+var_gateway=192.168.1.1  # Default gateway (required for static IP)
 var_mtu=1500           # MTU size
 var_vlan=100           # VLAN ID
 ```
 
+#### IP Range Scanning
+
+You can specify an IP range instead of a static IP. The system will ping each IP in the range and automatically assign the first free IP:
+
+```bash
+# Format: START_IP/CIDR-END_IP/CIDR
+var_net=192.168.1.100/24-192.168.1.200/24
+var_gateway=192.168.1.1
+```
+
+This is useful for automated deployments where you want static IPs but don't want to track which IPs are already in use.
+
 #### System
 ```bash
 var_hostname=pihole    # Container name