refactor(forgejo,readeck): use fetch_and_deploy_codeberg_release function

.github/changelogs/2026/01.md

@@ -1,156 +1,14 @@
-## 2026-01-31
+## 2026-01-27
-
-### 🆕 New Scripts
-
-  - shelfmark ([#11371](https://github.com/community-scripts/ProxmoxVE/pull/11371))
-
-### 🚀 Updated Scripts
-
-  - #### 🐞 Bug Fixes
-
-    - fix: yubal: add git [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11394](https://github.com/community-scripts/ProxmoxVE/pull/11394))
-
-## 2026-01-30
-
-### 🆕 New Scripts
-
-  - languagetool ([#11370](https://github.com/community-scripts/ProxmoxVE/pull/11370))
-  - Ampache ([#11369](https://github.com/community-scripts/ProxmoxVE/pull/11369))
-
-### 🚀 Updated Scripts
-
-  - #### 🔧 Refactor
-
-    - Refactor: remove redundant PHP_MODULE entries in several scripts [@MickLesk](https://github.com/MickLesk) ([#11362](https://github.com/community-scripts/ProxmoxVE/pull/11362))
-    - Refactor: Koillection [@MickLesk](https://github.com/MickLesk) ([#11361](https://github.com/community-scripts/ProxmoxVE/pull/11361))
-
-### 💾 Core
-
-  - #### 🐞 Bug Fixes
-
-    - core: meilisearch - add data migration for version upgrades [@MickLesk](https://github.com/MickLesk) ([#11356](https://github.com/community-scripts/ProxmoxVE/pull/11356))
-
-  - #### ✨ New Features
-
-    - [tools] Add `fetch_and_deploy_from_url()` [@tremor021](https://github.com/tremor021) ([#11376](https://github.com/community-scripts/ProxmoxVE/pull/11376))
-    - core: php - improve module handling and prevent installation failures [@MickLesk](https://github.com/MickLesk) ([#11358](https://github.com/community-scripts/ProxmoxVE/pull/11358))
-
-## 2026-01-29
-
-### 🆕 New Scripts
-
-  - Alpine-Valkey [@MickLesk](https://github.com/MickLesk) ([#11320](https://github.com/community-scripts/ProxmoxVE/pull/11320))
-
-### 🚀 Updated Scripts
-
-  - #### 🐞 Bug Fixes
-
-    - Immich: Pin version to 2.5.2 [@vhsdream](https://github.com/vhsdream) ([#11335](https://github.com/community-scripts/ProxmoxVE/pull/11335))
-    - Kollection: Update to php 8.5 [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11315](https://github.com/community-scripts/ProxmoxVE/pull/11315))
-    - Notifiarr: change installation check from apt to systemd service [@MickLesk](https://github.com/MickLesk) ([#11319](https://github.com/community-scripts/ProxmoxVE/pull/11319))
-
-  - #### ✨ New Features
-
-    - [FEAT] Immich: Enable Maintenance Mode before update [@vhsdream](https://github.com/vhsdream) ([#11342](https://github.com/community-scripts/ProxmoxVE/pull/11342))
-    - jellyfin: add logrotate instead of reducing log level [@MickLesk](https://github.com/MickLesk) ([#11326](https://github.com/community-scripts/ProxmoxVE/pull/11326))
-    - core: Add config file handling options | Fix Vikunja update with interactive overwrite [@MickLesk](https://github.com/MickLesk) ([#11317](https://github.com/community-scripts/ProxmoxVE/pull/11317))
-    - Immich: v2.5.0 [@vhsdream](https://github.com/vhsdream) ([#11240](https://github.com/community-scripts/ProxmoxVE/pull/11240))
-
-  - #### 💥 Breaking Changes
-
-    - fix: vikunja v1 [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11308](https://github.com/community-scripts/ProxmoxVE/pull/11308))
-
-  - #### 🔧 Refactor
-
-    - Refactor: Byparr [@vhsdream](https://github.com/vhsdream) ([#11338](https://github.com/community-scripts/ProxmoxVE/pull/11338))
-    - cloudflare: Remove deprecated DNS-over-HTTPS proxy option [@MickLesk](https://github.com/MickLesk) ([#11068](https://github.com/community-scripts/ProxmoxVE/pull/11068))
-
-### 💾 Core
-
-  - #### 🐞 Bug Fixes
-
-    - build.func: Replace storage variable with searchdomain variable [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11322](https://github.com/community-scripts/ProxmoxVE/pull/11322))
-
-### 📂 Github
-
-  - Add workflow to lock closed issues [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11316](https://github.com/community-scripts/ProxmoxVE/pull/11316))
-
-## 2026-01-28
-
-### 🆕 New Scripts
-
-  - nodecast-tv ([#11287](https://github.com/community-scripts/ProxmoxVE/pull/11287))
-
-### 🚀 Updated Scripts
-
-  - #### 🐞 Bug Fixes
-
-    - Ubuntu 25.04 VM - Change default start from yes to no [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11292](https://github.com/community-scripts/ProxmoxVE/pull/11292))
-
-  - #### ✨ New Features
-
-    - various scripts: use setup_meilisearch function [@MickLesk](https://github.com/MickLesk) ([#11259](https://github.com/community-scripts/ProxmoxVE/pull/11259))
-
-  - #### 🔧 Refactor
-
-    - Refactor: NPMPlus / Default Login [@MickLesk](https://github.com/MickLesk) ([#11262](https://github.com/community-scripts/ProxmoxVE/pull/11262))
-
-### 💾 Core
-
-  - #### 🐞 Bug Fixes
-
-    - core: sed patch for ram [@lavacano](https://github.com/lavacano) ([#11285](https://github.com/community-scripts/ProxmoxVE/pull/11285))
-    - Fix installer loop caused by invalid whiptail menu separator [@Mesteriis](https://github.com/Mesteriis) ([#11237](https://github.com/community-scripts/ProxmoxVE/pull/11237))
-    - core: fix Debian 13 LXC template root ownership bug [@MickLesk](https://github.com/MickLesk) ([#11277](https://github.com/community-scripts/ProxmoxVE/pull/11277))
-    - tools.func: prevent systemd-tmpfiles failure in unprivileged LXC during deb install [@MickLesk](https://github.com/MickLesk) ([#11271](https://github.com/community-scripts/ProxmoxVE/pull/11271))
-    - tools.func: fix php "wait_for" hint [@MickLesk](https://github.com/MickLesk) ([#11254](https://github.com/community-scripts/ProxmoxVE/pull/11254))
-
-  - #### ✨ New Features
-
-    - core: update dynamic values in LXC profile on update_motd_ip [@MickLesk](https://github.com/MickLesk) ([#11268](https://github.com/community-scripts/ProxmoxVE/pull/11268))
-    - tools.func: add new function - setup_meilisearch [@MickLesk](https://github.com/MickLesk) ([#11258](https://github.com/community-scripts/ProxmoxVE/pull/11258))
-
-### 📂 Github
-
-  - github: add GitHub-based versions.json updater [@MickLesk](https://github.com/MickLesk) ([#10021](https://github.com/community-scripts/ProxmoxVE/pull/10021))
-
-### 🌐 Website
-
-  - #### ✨ New Features
-
-    - Frontend: use github-versions.json for version display [@MickLesk](https://github.com/MickLesk) ([#11281](https://github.com/community-scripts/ProxmoxVE/pull/11281))
-
-  - #### 📝 Script Information
-
-    - fix: homarr: conf location [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11253](https://github.com/community-scripts/ProxmoxVE/pull/11253))
-
-## 2026-01-27
 
 ### 🚀 Updated Scripts
 
   - #### 🐞 Bug Fixes
 
     - [FIX] Jotty: backup and restore custom config [@vhsdream](https://github.com/vhsdream) ([#11212](https://github.com/community-scripts/ProxmoxVE/pull/11212))
-    - Immich: update libraw [@vhsdream](https://github.com/vhsdream) ([#11233](https://github.com/community-scripts/ProxmoxVE/pull/11233))
-
-  - #### ✨ New Features
-
-    - grist: enable optional enterprise features toggle [@MickLesk](https://github.com/MickLesk) ([#11239](https://github.com/community-scripts/ProxmoxVE/pull/11239))
-
-  - #### 🔧 Refactor
-
-    - Termix: use nginx.conf from upstream repo [@MickLesk](https://github.com/MickLesk) ([#11228](https://github.com/community-scripts/ProxmoxVE/pull/11228))
-
-### 💾 Core
-
-  - #### ✨ New Features
-
-    - feat: add NVIDIA driver install prompt for GPU-enabled containers [@devdecrux](https://github.com/devdecrux) ([#11184](https://github.com/community-scripts/ProxmoxVE/pull/11184))
 
 ### 📚 Documentation
 
   - doc setup_deb822_repo arg order [@chrnie](https://github.com/chrnie) ([#11215](https://github.com/community-scripts/ProxmoxVE/pull/11215))
-  - changelog: archive old entries to year/month files [@MickLesk](https://github.com/MickLesk) ([#11225](https://github.com/community-scripts/ProxmoxVE/pull/11225))
 
 ## 2026-01-26
 
@@ -242,7 +100,7 @@
 ### 🆕 New Scripts
 
   - Tracearr ([#11079](https://github.com/community-scripts/ProxmoxVE/pull/11079))
-  - Dawarich ([#11075](https://github.com/community-scripts/ProxmoxVE/pull/11075))
+- Dawarich ([#11075](https://github.com/community-scripts/ProxmoxVE/pull/11075))
 
 ### 🚀 Updated Scripts
 
@@ -392,7 +250,7 @@
 ### 🆕 New Scripts
 
   - Termix ([#10887](https://github.com/community-scripts/ProxmoxVE/pull/10887))
-  - ThingsBoard ([#10904](https://github.com/community-scripts/ProxmoxVE/pull/10904))
+- ThingsBoard ([#10904](https://github.com/community-scripts/ProxmoxVE/pull/10904))
 
 ### 🚀 Updated Scripts
 
@@ -461,7 +319,7 @@
 ### 🆕 New Scripts
 
   - Flatnotes ([#10857](https://github.com/community-scripts/ProxmoxVE/pull/10857))
-  - Unifi OS Server ([#10856](https://github.com/community-scripts/ProxmoxVE/pull/10856))
+- Unifi OS Server ([#10856](https://github.com/community-scripts/ProxmoxVE/pull/10856))
 
 ### 🚀 Updated Scripts
 
@@ -527,7 +385,7 @@
 ### 🆕 New Scripts
 
   - Investbrain ([#10774](https://github.com/community-scripts/ProxmoxVE/pull/10774))
-  - Fladder ([#10768](https://github.com/community-scripts/ProxmoxVE/pull/10768))
+- Fladder ([#10768](https://github.com/community-scripts/ProxmoxVE/pull/10768))
 
 ### 🚀 Updated Scripts
 
@@ -716,7 +574,7 @@
 ### 📚 Documentation
 
   - [gh] New Script template update [@tremor021](https://github.com/tremor021) ([#10607](https://github.com/community-scripts/ProxmoxVE/pull/10607))
-  - chore: bump copyright to 2026 - happy new year [@CrazyWolf13](https://github.com/CrazyWolf13) ([#10585](https://github.com/community-scripts/ProxmoxVE/pull/10585))
+- chore: bump copyright to 2026 - happy new year [@CrazyWolf13](https://github.com/CrazyWolf13) ([#10585](https://github.com/community-scripts/ProxmoxVE/pull/10585))
 
 ### 📂 Github
 
@@ -797,7 +655,7 @@
 ### ❔ Uncategorized
 
   - Wireguard: Update WGDashboard notes URL to the new link [@tremor021](https://github.com/tremor021) ([#10496](https://github.com/community-scripts/ProxmoxVE/pull/10496))
-  - InvoiceNinja: Update database credentias information [@tremor021](https://github.com/tremor021) ([#10497](https://github.com/community-scripts/ProxmoxVE/pull/10497))
+- InvoiceNinja: Update database credentias information [@tremor021](https://github.com/tremor021) ([#10497](https://github.com/community-scripts/ProxmoxVE/pull/10497))
 
 ## 2026-01-02
 
@@ -826,3 +684,157 @@
   - #### 🐞 Bug Fixes
 
     - Fix MariaDB runtime directory persistence on container reboot [@Copilot](https://github.com/Copilot) ([#10468](https://github.com/community-scripts/ProxmoxVE/pull/10468))
+
+
+## 2026-01-31
+
+### 🆕 New Scripts
+
+  - shelfmark ([#11371](https://github.com/community-scripts/ProxmoxVE/pull/11371))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - fix: yubal: add git [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11394](https://github.com/community-scripts/ProxmoxVE/pull/11394))
+
+## 2026-01-30
+
+### 🆕 New Scripts
+
+  - languagetool ([#11370](https://github.com/community-scripts/ProxmoxVE/pull/11370))
+- Ampache ([#11369](https://github.com/community-scripts/ProxmoxVE/pull/11369))
+
+### 🚀 Updated Scripts
+
+  - #### 🔧 Refactor
+
+    - Refactor: remove redundant PHP_MODULE entries in several scripts [@MickLesk](https://github.com/MickLesk) ([#11362](https://github.com/community-scripts/ProxmoxVE/pull/11362))
+    - Refactor: Koillection [@MickLesk](https://github.com/MickLesk) ([#11361](https://github.com/community-scripts/ProxmoxVE/pull/11361))
+
+### 💾 Core
+
+  - #### 🐞 Bug Fixes
+
+    - core: meilisearch - add data migration for version upgrades [@MickLesk](https://github.com/MickLesk) ([#11356](https://github.com/community-scripts/ProxmoxVE/pull/11356))
+
+  - #### ✨ New Features
+
+    - [tools] Add `fetch_and_deploy_from_url()` [@tremor021](https://github.com/tremor021) ([#11376](https://github.com/community-scripts/ProxmoxVE/pull/11376))
+    - core: php - improve module handling and prevent installation failures [@MickLesk](https://github.com/MickLesk) ([#11358](https://github.com/community-scripts/ProxmoxVE/pull/11358))
+
+## 2026-01-29
+
+### 🆕 New Scripts
+
+  - Alpine-Valkey [@MickLesk](https://github.com/MickLesk) ([#11320](https://github.com/community-scripts/ProxmoxVE/pull/11320))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Immich: Pin version to 2.5.2 [@vhsdream](https://github.com/vhsdream) ([#11335](https://github.com/community-scripts/ProxmoxVE/pull/11335))
+    - Kollection: Update to php 8.5 [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11315](https://github.com/community-scripts/ProxmoxVE/pull/11315))
+    - Notifiarr: change installation check from apt to systemd service [@MickLesk](https://github.com/MickLesk) ([#11319](https://github.com/community-scripts/ProxmoxVE/pull/11319))
+
+  - #### ✨ New Features
+
+    - [FEAT] Immich: Enable Maintenance Mode before update [@vhsdream](https://github.com/vhsdream) ([#11342](https://github.com/community-scripts/ProxmoxVE/pull/11342))
+    - jellyfin: add logrotate instead of reducing log level [@MickLesk](https://github.com/MickLesk) ([#11326](https://github.com/community-scripts/ProxmoxVE/pull/11326))
+    - core: Add config file handling options | Fix Vikunja update with interactive overwrite [@MickLesk](https://github.com/MickLesk) ([#11317](https://github.com/community-scripts/ProxmoxVE/pull/11317))
+    - Immich: v2.5.0 [@vhsdream](https://github.com/vhsdream) ([#11240](https://github.com/community-scripts/ProxmoxVE/pull/11240))
+
+  - #### 💥 Breaking Changes
+
+    - fix: vikunja v1 [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11308](https://github.com/community-scripts/ProxmoxVE/pull/11308))
+
+  - #### 🔧 Refactor
+
+    - Refactor: Byparr [@vhsdream](https://github.com/vhsdream) ([#11338](https://github.com/community-scripts/ProxmoxVE/pull/11338))
+    - cloudflare: Remove deprecated DNS-over-HTTPS proxy option [@MickLesk](https://github.com/MickLesk) ([#11068](https://github.com/community-scripts/ProxmoxVE/pull/11068))
+
+### 💾 Core
+
+  - #### 🐞 Bug Fixes
+
+    - build.func: Replace storage variable with searchdomain variable [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11322](https://github.com/community-scripts/ProxmoxVE/pull/11322))
+
+### 📂 Github
+
+  - Add workflow to lock closed issues [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11316](https://github.com/community-scripts/ProxmoxVE/pull/11316))
+
+## 2026-01-28
+
+### 🆕 New Scripts
+
+  - nodecast-tv ([#11287](https://github.com/community-scripts/ProxmoxVE/pull/11287))
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Ubuntu 25.04 VM - Change default start from yes to no [@michelroegl-brunner](https://github.com/michelroegl-brunner) ([#11292](https://github.com/community-scripts/ProxmoxVE/pull/11292))
+
+  - #### ✨ New Features
+
+    - various scripts: use setup_meilisearch function [@MickLesk](https://github.com/MickLesk) ([#11259](https://github.com/community-scripts/ProxmoxVE/pull/11259))
+
+  - #### 🔧 Refactor
+
+    - Refactor: NPMPlus / Default Login [@MickLesk](https://github.com/MickLesk) ([#11262](https://github.com/community-scripts/ProxmoxVE/pull/11262))
+
+### 💾 Core
+
+  - #### 🐞 Bug Fixes
+
+    - core: sed patch for ram [@lavacano](https://github.com/lavacano) ([#11285](https://github.com/community-scripts/ProxmoxVE/pull/11285))
+    - Fix installer loop caused by invalid whiptail menu separator [@Mesteriis](https://github.com/Mesteriis) ([#11237](https://github.com/community-scripts/ProxmoxVE/pull/11237))
+    - core: fix Debian 13 LXC template root ownership bug [@MickLesk](https://github.com/MickLesk) ([#11277](https://github.com/community-scripts/ProxmoxVE/pull/11277))
+    - tools.func: prevent systemd-tmpfiles failure in unprivileged LXC during deb install [@MickLesk](https://github.com/MickLesk) ([#11271](https://github.com/community-scripts/ProxmoxVE/pull/11271))
+    - tools.func: fix php "wait_for" hint [@MickLesk](https://github.com/MickLesk) ([#11254](https://github.com/community-scripts/ProxmoxVE/pull/11254))
+
+  - #### ✨ New Features
+
+    - core: update dynamic values in LXC profile on update_motd_ip [@MickLesk](https://github.com/MickLesk) ([#11268](https://github.com/community-scripts/ProxmoxVE/pull/11268))
+    - tools.func: add new function - setup_meilisearch [@MickLesk](https://github.com/MickLesk) ([#11258](https://github.com/community-scripts/ProxmoxVE/pull/11258))
+
+### 📂 Github
+
+  - github: add GitHub-based versions.json updater [@MickLesk](https://github.com/MickLesk) ([#10021](https://github.com/community-scripts/ProxmoxVE/pull/10021))
+
+### 🌐 Website
+
+  - #### ✨ New Features
+
+    - Frontend: use github-versions.json for version display [@MickLesk](https://github.com/MickLesk) ([#11281](https://github.com/community-scripts/ProxmoxVE/pull/11281))
+
+  - #### 📝 Script Information
+
+    - fix: homarr: conf location [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11253](https://github.com/community-scripts/ProxmoxVE/pull/11253))
+
+## 2026-01-27
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Immich: update libraw [@vhsdream](https://github.com/vhsdream) ([#11233](https://github.com/community-scripts/ProxmoxVE/pull/11233))
+
+  - #### ✨ New Features
+
+    - grist: enable optional enterprise features toggle [@MickLesk](https://github.com/MickLesk) ([#11239](https://github.com/community-scripts/ProxmoxVE/pull/11239))
+
+  - #### 🔧 Refactor
+
+    - Termix: use nginx.conf from upstream repo [@MickLesk](https://github.com/MickLesk) ([#11228](https://github.com/community-scripts/ProxmoxVE/pull/11228))
+
+### 💾 Core
+
+  - #### ✨ New Features
+
+    - feat: add NVIDIA driver install prompt for GPU-enabled containers [@devdecrux](https://github.com/devdecrux) ([#11184](https://github.com/community-scripts/ProxmoxVE/pull/11184))
+
+### 📚 Documentation
+
+  - doc setup_deb822_repo arg order [@chrnie](https://github.com/chrnie) ([#11215](https://github.com/community-scripts/ProxmoxVE/pull/11215))
+- changelog: archive old entries to year/month files [@MickLesk](https://github.com/MickLesk) ([#11225](https://github.com/community-scripts/ProxmoxVE/pull/11225))

.github/changelogs/2026/02.md

@@ -1,121 +0,0 @@
-## 2026-02-04
-
-### 🆕 New Scripts
-
-  - Wishlist ([#11527](https://github.com/community-scripts/ProxmoxVE/pull/11527))
-- WriteFreely ([#11524](https://github.com/community-scripts/ProxmoxVE/pull/11524))
-
-### 💾 Core
-
-  - #### ✨ New Features
-
-    - core: create vm-core.func from dev [@MickLesk](https://github.com/MickLesk) ([#11528](https://github.com/community-scripts/ProxmoxVE/pull/11528))
-
-### 🌐 Website
-
-  - #### 🐞 Bug Fixes
-
-    - fix(frontend): implement weighted search scoring for command menu [@ls-root](https://github.com/ls-root) ([#11534](https://github.com/community-scripts/ProxmoxVE/pull/11534))
-
-## 2026-02-03
-
-### 🆕 New Scripts
-
-  - Wealthfolio ([#11511](https://github.com/community-scripts/ProxmoxVE/pull/11511))
-
-### 🚀 Updated Scripts
-
-  - #### 🐞 Bug Fixes
-
-    - [FIX] Shelfmark: unpin Chromium version [@vhsdream](https://github.com/vhsdream) ([#11505](https://github.com/community-scripts/ProxmoxVE/pull/11505))
-
-  - #### ✨ New Features
-
-    - [FEAT] Scanopy: automatically update integrated daemon [@vhsdream](https://github.com/vhsdream) ([#11506](https://github.com/community-scripts/ProxmoxVE/pull/11506))
-
-### 💾 Core
-
-  - #### 🐞 Bug Fixes
-
-    - [FIX] tools.func: trim spaces in app_lc when checking for gh release [@vhsdream](https://github.com/vhsdream) ([#11512](https://github.com/community-scripts/ProxmoxVE/pull/11512))
-
-### 🌐 Website
-
-  - #### 🐞 Bug Fixes
-
-    - fix(frontend): decouple table pagination from summary fetching [@ls-root](https://github.com/ls-root) ([#11495](https://github.com/community-scripts/ProxmoxVE/pull/11495))
-
-## 2026-02-02
-
-### 🆕 New Scripts
-
-  - rustypaste | Alpine-rustypaste ([#11457](https://github.com/community-scripts/ProxmoxVE/pull/11457))
-- KitchenOwl ([#11453](https://github.com/community-scripts/ProxmoxVE/pull/11453))
-
-### 🚀 Updated Scripts
-
-  - #### 🐞 Bug Fixes
-
-    - Grist: Update dependencies [@tremor021](https://github.com/tremor021) ([#11489](https://github.com/community-scripts/ProxmoxVE/pull/11489))
-    - Allow "downgrade" of libigdgmm12 [@vhsdream](https://github.com/vhsdream) ([#11478](https://github.com/community-scripts/ProxmoxVE/pull/11478))
-    - Disable NPM install and update due to OpenResty SHA-1 signature issues [@MickLesk](https://github.com/MickLesk) ([#11471](https://github.com/community-scripts/ProxmoxVE/pull/11471))
-
-  - #### ✨ New Features
-
-    - Refactor: Forgejo & readeck - migrate to codeberg functions [@MickLesk](https://github.com/MickLesk) ([#11460](https://github.com/community-scripts/ProxmoxVE/pull/11460))
-
-  - #### 💥 Breaking Changes
-
-    - [FIX] Scanopy: remove daemon build [@vhsdream](https://github.com/vhsdream) ([#11444](https://github.com/community-scripts/ProxmoxVE/pull/11444))
-
-  - #### 🔧 Refactor
-
-    - Refactor: Vaultwarden [@MickLesk](https://github.com/MickLesk) ([#11445](https://github.com/community-scripts/ProxmoxVE/pull/11445))
-    - various scripts: use ensure_dependencies instead of apt [@MickLesk](https://github.com/MickLesk) ([#11463](https://github.com/community-scripts/ProxmoxVE/pull/11463))
-
-### 🌐 Website
-
-  - cleanup(frontend): remove unused /category-view route [@ls-root](https://github.com/ls-root) ([#11461](https://github.com/community-scripts/ProxmoxVE/pull/11461))
-
-  - #### ✨ New Features
-
-    - feat(frontend): preview tab [@ls-root](https://github.com/ls-root) ([#11475](https://github.com/community-scripts/ProxmoxVE/pull/11475))
-
-## 2026-02-01
-
-### 🚀 Updated Scripts
-
-  - fix headers [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11422](https://github.com/community-scripts/ProxmoxVE/pull/11422))
-
-  - #### 🐞 Bug Fixes
-
-    - 2fauth: export PHP_VERSION for nginx config [@MickLesk](https://github.com/MickLesk) ([#11441](https://github.com/community-scripts/ProxmoxVE/pull/11441))
-    - Prometheus Paperless NGX Exporter: Set correct binary path in systemd unit file [@andygrunwald](https://github.com/andygrunwald) ([#11438](https://github.com/community-scripts/ProxmoxVE/pull/11438))
-    - tracearr: install/update new prestart script from upstream [@durzo](https://github.com/durzo) ([#11433](https://github.com/community-scripts/ProxmoxVE/pull/11433))
-    - n8n: Fix dependencies [@tremor021](https://github.com/tremor021) ([#11429](https://github.com/community-scripts/ProxmoxVE/pull/11429))
-    - [Hotfix] Bunkerweb update [@vhsdream](https://github.com/vhsdream) ([#11402](https://github.com/community-scripts/ProxmoxVE/pull/11402))
-    - [Hotfix] Immich: revert healthcheck feature [@vhsdream](https://github.com/vhsdream) ([#11427](https://github.com/community-scripts/ProxmoxVE/pull/11427))
-
-  - #### ✨ New Features
-
-    - tools.func: add codeberg functions & autocaliweb: migrate from GitHub to Codeberg [@MickLesk](https://github.com/MickLesk) ([#11440](https://github.com/community-scripts/ProxmoxVE/pull/11440))
-    - Immich Refactor #2 [@vhsdream](https://github.com/vhsdream) ([#11375](https://github.com/community-scripts/ProxmoxVE/pull/11375))
-
-  - #### 🔧 Refactor
-
-    - WordPress: Refactor [@tremor021](https://github.com/tremor021) ([#11408](https://github.com/community-scripts/ProxmoxVE/pull/11408))
-    - Refactor: Whisparr [@tremor021](https://github.com/tremor021) ([#11411](https://github.com/community-scripts/ProxmoxVE/pull/11411))
-
-### 💾 Core
-
-  - #### ✨ New Features
-
-    - [tools]: Update `fetch_and_deply_from_url()` [@tremor021](https://github.com/tremor021) ([#11410](https://github.com/community-scripts/ProxmoxVE/pull/11410))
-
-### 🌐 Website
-
-  - feat(frontend): implement UX refinements and syntax highlighting [@ls-root](https://github.com/ls-root) ([#11423](https://github.com/community-scripts/ProxmoxVE/pull/11423))
-
-  - #### ✨ New Features
-
-    - feat(frontend): add contribution CTA to empty search state [@ls-root](https://github.com/ls-root) ([#11412](https://github.com/community-scripts/ProxmoxVE/pull/11412))

.github/workflows/changelog-archive.yml

@@ -54,9 +54,8 @@ jobs:
             
             console.log(`Cutoff date: ${cutoffDate.toISOString().split('T')[0]}`);
             
-            // Read changelog and normalize line endings
+            // Read changelog
-            let content = await fs.readFile(CHANGELOG_PATH, 'utf-8');
+            const content = await fs.readFile(CHANGELOG_PATH, 'utf-8');
-            content = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
             const lines = content.split('\n');
             
             // Parse entries
@@ -67,39 +66,9 @@ jobs:
             let currentDate = null;
             let currentContent = [];
             let inHeader = true;
-            let inOldHistory = false;
-            let historyDetailsDepth = 0;
             
-            for (let i = 0; i < lines.length; i++) {
+            for (const line of lines) {
-              const line = lines[i];
               const match = line.match(datePattern);
-              
-              // Detect the start of History section: <details> followed by line with 📜 History
-              if (inHeader && !inOldHistory && line.trim() === '<details>') {
-                // Look ahead to see if this is the History section
-                const nextLine = lines[i + 1] || '';
-                if (nextLine.includes('📜 History')) {
-                  inOldHistory = true;
-                  historyDetailsDepth = 1;
-                  continue;
-                }
-              }
-              
-              // Track nested details tags to find the end of History section
-              if (inOldHistory) {
-                if (line.trim() === '<details>') {
-                  historyDetailsDepth++;
-                }
-                if (line.trim() === '</details>') {
-                  historyDetailsDepth--;
-                  if (historyDetailsDepth === 0) {
-                    // We've closed the main History details tag
-                    inOldHistory = false;
-                  }
-                }
-                continue;
-              }
-              
               if (match) {
                 inHeader = false;
                 
@@ -179,55 +148,30 @@ jobs:
                 let existingContent = '';
                 try {
                   existingContent = await fs.readFile(monthPath, 'utf-8');
-                  // Normalize line endings to prevent regex issues
-                  existingContent = existingContent.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
                 } catch (e) {
                   // File doesn't exist
                 }
                 
-                // Parse existing entries into a Map (date -> content) for deduplication
+                // Merge new entries with existing (avoid duplicates)
-                const allEntries = new Map();
+                const existingDates = new Set();
-                
+                const existingDatePattern = /^## (\d{4}-\d{2}-\d{2})$/gm;
-                // Helper function to parse entries from content
+                let match;
-                const parseEntries = (content) => {
+                while ((match = existingDatePattern.exec(existingContent)) !== null) {
-                  const entries = new Map();
+                  existingDates.add(match[1]);
-                  const parts = content.split(/(?=^## \d{4}-\d{2}-\d{2}$)/m);
-                  for (const part of parts) {
-                    const trimmed = part.trim();
-                    if (!trimmed) continue;
-                    const dateMatch = trimmed.match(/^## (\d{4}-\d{2}-\d{2})/);
-                    if (dateMatch) {
-                      entries.set(dateMatch[1], trimmed);
-                    }
-                  }
-                  return entries;
-                };
-                
-                // Parse existing content
-                if (existingContent) {
-                  const existingEntries = parseEntries(existingContent);
-                  for (const [date, content] of existingEntries) {
-                    allEntries.set(date, content);
-                  }
                 }
                 
-                // Add new entries (existing entries take precedence to avoid overwriting)
+                const newEntries = archiveData[year][month].filter(entry => {
-                let addedCount = 0;
-                for (const entry of archiveData[year][month]) {
                   const dateMatch = entry.match(/^## (\d{4}-\d{2}-\d{2})/);
-                  if (dateMatch && !allEntries.has(dateMatch[1])) {
+                  return dateMatch && !existingDates.has(dateMatch[1]);
-                    allEntries.set(dateMatch[1], entry.trim());
+                });
-                    addedCount++;
-                  }
-                }
                 
-                // Sort entries by date (newest first) and write
+                if (newEntries.length > 0) {
-                const sortedDates = [...allEntries.keys()].sort().reverse();
+                  const allContent = existingContent 
-                const sortedContent = sortedDates.map(date => allEntries.get(date)).join('\n\n');
+                    ? existingContent + '\n\n' + newEntries.join('\n\n')
-                
+                    : newEntries.join('\n\n');
-                if (addedCount > 0 || !existingContent) {
+                  
-                  await fs.writeFile(monthPath, sortedContent + '\n', 'utf-8');
+                  await fs.writeFile(monthPath, allContent, 'utf-8');
-                  console.log(`Updated: ${monthPath} (${allEntries.size} total entries, +${addedCount} new)`);
+                  console.log(`Updated: ${monthPath} (+${newEntries.length} entries)`);
                 }
               }
             }
@@ -274,8 +218,7 @@ jobs:
                 // Count entries in month file
                 let entryCount = 0;
                 try {
-                  let monthContent = await fs.readFile(monthPath, 'utf-8');
+                  const monthContent = await fs.readFile(monthPath, 'utf-8');
-                  monthContent = monthContent.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
                   entryCount = (monthContent.match(/^## \d{4}-\d{2}-\d{2}$/gm) || []).length;
                 } catch (e) {
                   entryCount = (archiveData[year]?.[month] || []).length;

.github/workflows/lock-issue.yaml

@@ -18,6 +18,7 @@ jobs:
         with:
           script: |
             const daysBeforeLock = 3;
+            const cutoffDate = new Date('2026-01-27T00:00:00Z');
             const lockDate = new Date();
             lockDate.setDate(lockDate.getDate() - daysBeforeLock);
             
@@ -28,50 +29,48 @@ jobs:
               /dependabot/i
             ];
             
-            // Search for closed, unlocked issues older than 3 days (paginated, oldest first)
+            // Search for closed, unlocked issues older than 3 days
-            let page = 1;
+            const issues = await github.rest.search.issuesAndPullRequests({
-            let totalLocked = 0;
+              q: `repo:${context.repo.owner}/${context.repo.repo} is:closed is:unlocked updated:<${lockDate.toISOString().split('T')[0]}`,
+              per_page: 50
+            });
             
-            while (true) {
+            console.log(`Found ${issues.data.items.length} issues/PRs to process`);
-              const issues = await github.rest.search.issuesAndPullRequests({
+            
-                q: `repo:${context.repo.owner}/${context.repo.repo} is:closed is:unlocked updated:<${lockDate.toISOString().split('T')[0]}`,
+            for (const item of issues.data.items) {
-                sort: 'updated',
+              // Skip excluded items
-                order: 'asc',
+              const shouldExclude = excludePatterns.some(pattern => pattern.test(item.title));
-                per_page: 100,
+              if (shouldExclude) {
-                page: page
+                console.log(`Skipped #${item.number}: "${item.title}" (matches exclude pattern)`);
-              });
+                continue;
-              
-              if (issues.data.items.length === 0) break;
-              
-              console.log(`Page ${page}: ${issues.data.items.length} items (total available: ${issues.data.total_count})`);
-              
-              for (const item of issues.data.items) {
-                // Skip excluded items
-                const shouldExclude = excludePatterns.some(pattern => pattern.test(item.title));
-                if (shouldExclude) {
-                  console.log(`Skipped #${item.number}: "${item.title}" (matches exclude pattern)`);
-                  continue;
-                }
-                
-                try {
-                  // Lock the issue/PR silently
-                  await github.rest.issues.lock({
-                    ...context.repo,
-                    issue_number: item.number,
-                    lock_reason: 'resolved'
-                  });
-                  
-                  totalLocked++;
-                  console.log(`Locked #${item.number} (${item.pull_request ? 'PR' : 'Issue'})`);
-                } catch (error) {
-                  console.log(`Failed to lock #${item.number}: ${error.message}`);
-                }
               }
               
-              page++;
+              const createdAt = new Date(item.created_at);
+              const isNew = createdAt >= cutoffDate;
               
-              // GitHub search API limit: max 10000 results (100 pages * 100) - temporarily increased
+              try {
-              if (page > 100) break;
+                // Add comment only for new issues (created after 2026-01-27)
+                if (isNew) {
+                  const comment = item.pull_request
+                    ? 'This pull request has been automatically locked. Please open a new issue for related bugs.'
+                    : 'This issue has been automatically locked. Please open a new issue for related bugs and reference this issue if needed.';
+                  
+                  await github.rest.issues.createComment({
+                    ...context.repo,
+                    issue_number: item.number,
+                    body: comment
+                  });
+                }
+                
+                // Lock the issue/PR
+                await github.rest.issues.lock({
+                  ...context.repo,
+                  issue_number: item.number,
+                  lock_reason: 'resolved'
+                });
+                
+                console.log(`Locked #${item.number} (${item.pull_request ? 'PR' : 'Issue'})`);
+              } catch (error) {
+                console.log(`Failed to lock #${item.number}: ${error.message}`);
+              }
             }
-            
-            console.log(`Total locked: ${totalLocked} issues/PRs`);

CHANGELOG.md

@@ -21,14 +21,7 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
 
 
 <details>
-<summary><h4>February (4 entries)</h4></summary>
+<summary><h4>January - 27 entries</h4></summary>
-
-[View February 2026 Changelog](.github/changelogs/2026/02.md)
-
-</details>
-
-<details>
-<summary><h4>January (31 entries)</h4></summary>
 
 [View January 2026 Changelog](.github/changelogs/2026/01.md)
 
@@ -398,141 +391,392 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
 
 </details>
 
-## 2026-02-05
 
-### 🆕 New Scripts
 
-  - OpenCloud ([#11538](https://github.com/community-scripts/ProxmoxVE/pull/11538))
+<details>
-- Nginx-UI ([#11573](https://github.com/community-scripts/ProxmoxVE/pull/11573))
+<summary><h2>📜 History</h2></summary>
-- New: SQL-Server 2025 | Refactor SQL-Server 2022  [@MickLesk](https://github.com/MickLesk) ([#11546](https://github.com/community-scripts/ProxmoxVE/pull/11546))
 
-### 🚀 Updated Scripts
 
-  - #### 🐞 Bug Fixes
+<details>
+<summary><h3>2026</h3></summary>
 
-    - Wanderer: Fix repo [@tremor021](https://github.com/tremor021) ([#11567](https://github.com/community-scripts/ProxmoxVE/pull/11567))
 
-  - #### ✨ New Features
+<details>
+<summary><h4>January (31 entries)</h4></summary>
 
-    - Refactor: Docker-VM (Multi-OS / Cloud-Init / Stabilization)  [@MickLesk](https://github.com/MickLesk) ([#9047](https://github.com/community-scripts/ProxmoxVE/pull/9047))
+[View January 2026 Changelog](.github/changelogs/2026/01.md)
 
-### 💾 Core
+</details>
 
-  - #### ✨ New Features
+</details>
 
-    - cloud-init: add interactive SSH key discovery and selection [@MickLesk](https://github.com/MickLesk) ([#11547](https://github.com/community-scripts/ProxmoxVE/pull/11547))
+<details>
+<summary><h3>2025</h3></summary>
 
-### 📚 Documentation
 
-  - github: extend docs / contribution / templates [@MickLesk](https://github.com/MickLesk) ([#10921](https://github.com/community-scripts/ProxmoxVE/pull/10921))
+<details>
+<summary><h4>December (31 entries)</h4></summary>
 
-### 🌐 Website
+[View December 2025 Changelog](.github/changelogs/2025/12.md)
 
-  - #### 🐞 Bug Fixes
+</details>
 
-    - fix(frontend): theme respective syntax highlighting [@ls-root](https://github.com/ls-root) ([#11565](https://github.com/community-scripts/ProxmoxVE/pull/11565))
+<details>
+<summary><h4>November (29 entries)</h4></summary>
 
-## 2026-02-04
+[View November 2025 Changelog](.github/changelogs/2025/11.md)
 
-### 🆕 New Scripts
+</details>
 
-  - Wishlist ([#11527](https://github.com/community-scripts/ProxmoxVE/pull/11527))
+<details>
-- WriteFreely ([#11524](https://github.com/community-scripts/ProxmoxVE/pull/11524))
+<summary><h4>October (30 entries)</h4></summary>
 
-### 🚀 Updated Scripts
+[View October 2025 Changelog](.github/changelogs/2025/10.md)
 
-  - Add log directory and permissions for koillection [@shineangelic](https://github.com/shineangelic) ([#11553](https://github.com/community-scripts/ProxmoxVE/pull/11553))
+</details>
 
-  - #### 🐞 Bug Fixes
+<details>
+<summary><h4>September (29 entries)</h4></summary>
 
-    - [FIX] Scanopy: ensure Scanopy Daemon update [@vhsdream](https://github.com/vhsdream) ([#11541](https://github.com/community-scripts/ProxmoxVE/pull/11541))
+[View September 2025 Changelog](.github/changelogs/2025/09.md)
-    - Immich: pin version to 2.5.3 [@vhsdream](https://github.com/vhsdream) ([#11515](https://github.com/community-scripts/ProxmoxVE/pull/11515))
 
-### 💾 Core
+</details>
 
-  - #### ✨ New Features
+<details>
+<summary><h4>August (30 entries)</h4></summary>
 
-    - core: create vm-core.func from dev [@MickLesk](https://github.com/MickLesk) ([#11528](https://github.com/community-scripts/ProxmoxVE/pull/11528))
+[View August 2025 Changelog](.github/changelogs/2025/08.md)
 
-### 🧰 Tools
+</details>
 
-  - #### ✨ New Features
+<details>
+<summary><h4>July (29 entries)</h4></summary>
 
-    - [ADDON] Immich Public Proxy addon [@vhsdream](https://github.com/vhsdream) ([#11518](https://github.com/community-scripts/ProxmoxVE/pull/11518))
+[View July 2025 Changelog](.github/changelogs/2025/07.md)
 
-### 🌐 Website
+</details>
 
-  - #### 🐞 Bug Fixes
+<details>
+<summary><h4>June (29 entries)</h4></summary>
 
-    - fix(frontend): implement weighted search scoring for command menu [@ls-root](https://github.com/ls-root) ([#11534](https://github.com/community-scripts/ProxmoxVE/pull/11534))
+[View June 2025 Changelog](.github/changelogs/2025/06.md)
 
-### ❔ Uncategorized
+</details>
 
-  - [FIX] Immich Public Proxy docs link [@vhsdream](https://github.com/vhsdream) ([#11543](https://github.com/community-scripts/ProxmoxVE/pull/11543))
+<details>
+<summary><h4>May (30 entries)</h4></summary>
 
-## 2026-02-03
+[View May 2025 Changelog](.github/changelogs/2025/05.md)
 
-### 🆕 New Scripts
+</details>
 
-  - Wealthfolio ([#11511](https://github.com/community-scripts/ProxmoxVE/pull/11511))
+<details>
+<summary><h4>April (25 entries)</h4></summary>
 
-### 🚀 Updated Scripts
+[View April 2025 Changelog](.github/changelogs/2025/04.md)
 
-  - #### 🐞 Bug Fixes
+</details>
 
-    - [FIX] Shelfmark: unpin Chromium version [@vhsdream](https://github.com/vhsdream) ([#11505](https://github.com/community-scripts/ProxmoxVE/pull/11505))
+<details>
+<summary><h4>March (30 entries)</h4></summary>
 
-  - #### ✨ New Features
+[View March 2025 Changelog](.github/changelogs/2025/03.md)
 
-    - [FEAT] Scanopy: automatically update integrated daemon [@vhsdream](https://github.com/vhsdream) ([#11506](https://github.com/community-scripts/ProxmoxVE/pull/11506))
+</details>
 
-### 💾 Core
+<details>
+<summary><h4>February (26 entries)</h4></summary>
 
-  - #### 🐞 Bug Fixes
+[View February 2025 Changelog](.github/changelogs/2025/02.md)
 
-    - [FIX] tools.func: trim spaces in app_lc when checking for gh release [@vhsdream](https://github.com/vhsdream) ([#11512](https://github.com/community-scripts/ProxmoxVE/pull/11512))
+</details>
 
-### 🌐 Website
+<details>
+<summary><h4>January (27 entries)</h4></summary>
 
-  - #### 🐞 Bug Fixes
+[View January 2025 Changelog](.github/changelogs/2025/01.md)
 
-    - fix(frontend): decouple table pagination from summary fetching [@ls-root](https://github.com/ls-root) ([#11495](https://github.com/community-scripts/ProxmoxVE/pull/11495))
+</details>
+
+</details>
+
+<details>
+<summary><h3>2024</h3></summary>
+
+
+<details>
+<summary><h4>December (22 entries)</h4></summary>
+
+[View December 2024 Changelog](.github/changelogs/2024/12.md)
+
+</details>
+
+<details>
+<summary><h4>November (15 entries)</h4></summary>
+
+[View November 2024 Changelog](.github/changelogs/2024/11.md)
+
+</details>
+
+<details>
+<summary><h4>October (9 entries)</h4></summary>
+
+[View October 2024 Changelog](.github/changelogs/2024/10.md)
+
+</details>
+
+<details>
+<summary><h4>September (1 entries)</h4></summary>
+
+[View September 2024 Changelog](.github/changelogs/2024/09.md)
+
+</details>
+
+<details>
+<summary><h4>August (2 entries)</h4></summary>
+
+[View August 2024 Changelog](.github/changelogs/2024/08.md)
+
+</details>
+
+<details>
+<summary><h4>July (0 entries)</h4></summary>
+
+[View July 2024 Changelog](.github/changelogs/2024/07.md)
+
+</details>
+
+<details>
+<summary><h4>June (8 entries)</h4></summary>
+
+[View June 2024 Changelog](.github/changelogs/2024/06.md)
+
+</details>
+
+<details>
+<summary><h4>May (16 entries)</h4></summary>
+
+[View May 2024 Changelog](.github/changelogs/2024/05.md)
+
+</details>
+
+<details>
+<summary><h4>April (14 entries)</h4></summary>
+
+[View April 2024 Changelog](.github/changelogs/2024/04.md)
+
+</details>
+
+<details>
+<summary><h4>March (5 entries)</h4></summary>
+
+[View March 2024 Changelog](.github/changelogs/2024/03.md)
+
+</details>
+
+<details>
+<summary><h4>February (9 entries)</h4></summary>
+
+[View February 2024 Changelog](.github/changelogs/2024/02.md)
+
+</details>
+
+<details>
+<summary><h4>January (9 entries)</h4></summary>
+
+[View January 2024 Changelog](.github/changelogs/2024/01.md)
+
+</details>
+
+</details>
+
+<details>
+<summary><h3>2023</h3></summary>
+
+
+<details>
+<summary><h4>December (3 entries)</h4></summary>
+
+[View December 2023 Changelog](.github/changelogs/2023/12.md)
+
+</details>
+
+<details>
+<summary><h4>November (3 entries)</h4></summary>
+
+[View November 2023 Changelog](.github/changelogs/2023/11.md)
+
+</details>
+
+<details>
+<summary><h4>October (7 entries)</h4></summary>
+
+[View October 2023 Changelog](.github/changelogs/2023/10.md)
+
+</details>
+
+<details>
+<summary><h4>September (10 entries)</h4></summary>
+
+[View September 2023 Changelog](.github/changelogs/2023/09.md)
+
+</details>
+
+<details>
+<summary><h4>August (7 entries)</h4></summary>
+
+[View August 2023 Changelog](.github/changelogs/2023/08.md)
+
+</details>
+
+<details>
+<summary><h4>July (5 entries)</h4></summary>
+
+[View July 2023 Changelog](.github/changelogs/2023/07.md)
+
+</details>
+
+<details>
+<summary><h4>June (5 entries)</h4></summary>
+
+[View June 2023 Changelog](.github/changelogs/2023/06.md)
+
+</details>
+
+<details>
+<summary><h4>May (8 entries)</h4></summary>
+
+[View May 2023 Changelog](.github/changelogs/2023/05.md)
+
+</details>
+
+<details>
+<summary><h4>April (8 entries)</h4></summary>
+
+[View April 2023 Changelog](.github/changelogs/2023/04.md)
+
+</details>
+
+<details>
+<summary><h4>March (8 entries)</h4></summary>
+
+[View March 2023 Changelog](.github/changelogs/2023/03.md)
+
+</details>
+
+<details>
+<summary><h4>February (6 entries)</h4></summary>
+
+[View February 2023 Changelog](.github/changelogs/2023/02.md)
+
+</details>
+
+<details>
+<summary><h4>January (15 entries)</h4></summary>
+
+[View January 2023 Changelog](.github/changelogs/2023/01.md)
+
+</details>
+
+</details>
+
+<details>
+<summary><h3>2022</h3></summary>
+
+
+<details>
+<summary><h4>December (7 entries)</h4></summary>
+
+[View December 2022 Changelog](.github/changelogs/2022/12.md)
+
+</details>
+
+<details>
+<summary><h4>November (7 entries)</h4></summary>
+
+[View November 2022 Changelog](.github/changelogs/2022/11.md)
+
+</details>
+
+<details>
+<summary><h4>October (2 entries)</h4></summary>
+
+[View October 2022 Changelog](.github/changelogs/2022/10.md)
+
+</details>
+
+<details>
+<summary><h4>September (9 entries)</h4></summary>
+
+[View September 2022 Changelog](.github/changelogs/2022/09.md)
+
+</details>
+
+<details>
+<summary><h4>August (7 entries)</h4></summary>
+
+[View August 2022 Changelog](.github/changelogs/2022/08.md)
+
+</details>
+
+<details>
+<summary><h4>July (10 entries)</h4></summary>
+
+[View July 2022 Changelog](.github/changelogs/2022/07.md)
+
+</details>
+
+<details>
+<summary><h4>June (1 entries)</h4></summary>
+
+[View June 2022 Changelog](.github/changelogs/2022/06.md)
+
+</details>
+
+<details>
+<summary><h4>May (8 entries)</h4></summary>
+
+[View May 2022 Changelog](.github/changelogs/2022/05.md)
+
+</details>
+
+<details>
+<summary><h4>April (13 entries)</h4></summary>
+
+[View April 2022 Changelog](.github/changelogs/2022/04.md)
+
+</details>
+
+<details>
+<summary><h4>March (20 entries)</h4></summary>
+
+[View March 2022 Changelog](.github/changelogs/2022/03.md)
+
+</details>
+
+<details>
+<summary><h4>February (15 entries)</h4></summary>
+
+[View February 2022 Changelog](.github/changelogs/2022/02.md)
+
+</details>
+
+<details>
+<summary><h4>January (3 entries)</h4></summary>
+
+[View January 2022 Changelog](.github/changelogs/2022/01.md)
+
+</details>
+
+</details>
+
+</details>
 
 ## 2026-02-02
 
 ### 🆕 New Scripts
 
-  - rustypaste | Alpine-rustypaste ([#11457](https://github.com/community-scripts/ProxmoxVE/pull/11457))
+  - KitchenOwl ([#11453](https://github.com/community-scripts/ProxmoxVE/pull/11453))
-- KitchenOwl ([#11453](https://github.com/community-scripts/ProxmoxVE/pull/11453))
-
-### 🚀 Updated Scripts
-
-  - #### 🐞 Bug Fixes
-
-    - Grist: Update dependencies [@tremor021](https://github.com/tremor021) ([#11489](https://github.com/community-scripts/ProxmoxVE/pull/11489))
-    - Allow "downgrade" of libigdgmm12 [@vhsdream](https://github.com/vhsdream) ([#11478](https://github.com/community-scripts/ProxmoxVE/pull/11478))
-    - Disable NPM install and update due to OpenResty SHA-1 signature issues [@MickLesk](https://github.com/MickLesk) ([#11471](https://github.com/community-scripts/ProxmoxVE/pull/11471))
-
-  - #### ✨ New Features
-
-    - Refactor: Forgejo & readeck - migrate to codeberg functions [@MickLesk](https://github.com/MickLesk) ([#11460](https://github.com/community-scripts/ProxmoxVE/pull/11460))
-
-  - #### 💥 Breaking Changes
-
-    - [FIX] Scanopy: remove daemon build [@vhsdream](https://github.com/vhsdream) ([#11444](https://github.com/community-scripts/ProxmoxVE/pull/11444))
-
-  - #### 🔧 Refactor
-
-    - Refactor: Vaultwarden [@MickLesk](https://github.com/MickLesk) ([#11445](https://github.com/community-scripts/ProxmoxVE/pull/11445))
-    - various scripts: use ensure_dependencies instead of apt [@MickLesk](https://github.com/MickLesk) ([#11463](https://github.com/community-scripts/ProxmoxVE/pull/11463))
-
-### 🌐 Website
-
-  - cleanup(frontend): remove unused /category-view route [@ls-root](https://github.com/ls-root) ([#11461](https://github.com/community-scripts/ProxmoxVE/pull/11461))
-
-  - #### ✨ New Features
-
-    - feat(frontend): preview tab [@ls-root](https://github.com/ls-root) ([#11475](https://github.com/community-scripts/ProxmoxVE/pull/11475))
 
 ## 2026-02-01
 
@@ -1323,3 +1567,64 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
   - #### 🔧 Refactor
 
     - Refactor: IP-Tag (Multiple IP / Performance / Execution Time)  [@MickLesk](https://github.com/MickLesk) ([#10558](https://github.com/community-scripts/ProxmoxVE/pull/10558))
+
+## 2026-01-04
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - PocketID: Update PocketID for 2.x [@tremor021](https://github.com/tremor021) ([#10506](https://github.com/community-scripts/ProxmoxVE/pull/10506))
+    - fix: reitti: nginx [@CrazyWolf13](https://github.com/CrazyWolf13) ([#10511](https://github.com/community-scripts/ProxmoxVE/pull/10511))
+    - MagicMirror: bump to nodejs 24 [@MickLesk](https://github.com/MickLesk) ([#10534](https://github.com/community-scripts/ProxmoxVE/pull/10534))
+
+  - #### 🔧 Refactor
+
+    - Refactor: SFTPGo [@tremor021](https://github.com/tremor021) ([#10518](https://github.com/community-scripts/ProxmoxVE/pull/10518))
+    - Refactor: Pelican Wings [@tremor021](https://github.com/tremor021) ([#10517](https://github.com/community-scripts/ProxmoxVE/pull/10517))
+    - Refactor: Pelican Panel [@tremor021](https://github.com/tremor021) ([#10516](https://github.com/community-scripts/ProxmoxVE/pull/10516))
+    - Refactor: Audiobookshelf [@tremor021](https://github.com/tremor021) ([#10519](https://github.com/community-scripts/ProxmoxVE/pull/10519))
+
+### 💾 Core
+
+  - #### 🐞 Bug Fixes
+
+    - Export IPV6_METHOD to trigger verb_ip6() function [@remz1337](https://github.com/remz1337) ([#10538](https://github.com/community-scripts/ProxmoxVE/pull/10538))
+
+### 🌐 Website
+
+  - #### 📝 Script Information
+
+    - Prowlarr: Update config_path [@tremor021](https://github.com/tremor021) ([#10504](https://github.com/community-scripts/ProxmoxVE/pull/10504))
+
+## 2026-01-03
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Fix ownership and permissions for InvoiceNinja setup [@twinzdragonz](https://github.com/twinzdragonz) ([#10298](https://github.com/community-scripts/ProxmoxVE/pull/10298))
+    - Fix headscale Caddyfile to pass non-API URLs [@IlyaSemenov](https://github.com/IlyaSemenov) ([#10493](https://github.com/community-scripts/ProxmoxVE/pull/10493))
+
+### 💾 Core
+
+  - #### 🔧 Refactor
+
+    - [core]: Preserve log files [@tremor021](https://github.com/tremor021) ([#10509](https://github.com/community-scripts/ProxmoxVE/pull/10509))
+
+### ❔ Uncategorized
+
+  - Wireguard: Update WGDashboard notes URL to the new link [@tremor021](https://github.com/tremor021) ([#10496](https://github.com/community-scripts/ProxmoxVE/pull/10496))
+- InvoiceNinja: Update database credentias information [@tremor021](https://github.com/tremor021) ([#10497](https://github.com/community-scripts/ProxmoxVE/pull/10497))
+
+## 2026-01-02
+
+### 🚀 Updated Scripts
+
+  - #### 🐞 Bug Fixes
+
+    - Fix Intel Level Zero package conflict on Debian 13 [@Copilot](https://github.com/Copilot) ([#10467](https://github.com/community-scripts/ProxmoxVE/pull/10467))
+
+### ❔ Uncategorized
+
+  - Extend guidance for changing the immich upload location for #10447 [@jshprentz](https://github.com/jshprentz) ([#10475](https://github.com/community-scripts/ProxmoxVE/pull/10475))

ct/adventurelog.sh

@@ -27,7 +27,10 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  ensure_dependencies memcached libmemcached-tools
+  if ! command -v memcached >/dev/null 2>&1; then
+    $STD apt update
+    $STD apt install -y memcached libmemcached-tools
+  fi
   if check_for_gh_release "adventurelog" "seanmorley15/adventurelog"; then
     msg_info "Stopping Services"
     systemctl stop adventurelog-backend

ct/alpine-rustypaste.sh

@@ -1,51 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: MickLesk (CanbiZ)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/orhun/rustypaste
-
-APP="Alpine-RustyPaste"
-var_tags="${var_tags:-alpine;pastebin;storage}"
-var_cpu="${var_cpu:-1}"
-var_ram="${var_ram:-256}"
-var_disk="${var_disk:-4}"
-var_os="${var_os:-alpine}"
-var_version="${var_version:-3.23}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-
-  if ! apk info -e rustypaste >/dev/null 2>&1; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  msg_info "Updating RustyPaste"
-  $STD apk update
-  $STD apk upgrade rustypaste --repository=https://dl-cdn.alpinelinux.org/alpine/edge/community
-  msg_ok "Updated RustyPaste"
-
-  msg_info "Restarting Services"
-  $STD rc-service rustypaste restart
-  msg_ok "Restarted Services"
-  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}:8000${CL}"

ct/archivebox.sh

@@ -31,7 +31,11 @@ function update_script() {
   NODE_VERSION="22" NODE_MODULE="@postlight/parser@latest,single-file-cli@latest" setup_nodejs
   PYTHON_VERSION="3.13" setup_uv
 
-  ensure_dependencies chromium
+  if ! dpkg -l | grep -q "^ii  chromium "; then
+    msg_info "Installing System Dependencies"
+    $STD apt-get install -y chromium
+    msg_ok "Installed System Dependencies"
+  fi
 
   msg_info "Stopping Service"
   systemctl stop archivebox

ct/changedetection.sh

@@ -29,7 +29,12 @@ function update_script() {
     exit
   fi
 
-  ensure_dependencies libjpeg-dev
+  if ! dpkg -s libjpeg-dev >/dev/null 2>&1; then
+    msg_info "Installing Dependencies"
+    $STD apt-get update
+    $STD apt-get install -y libjpeg-dev
+    msg_ok "Updated Dependencies"
+  fi
 
   NODE_VERSION="24" setup_nodejs
 

ct/commafeed.sh

@@ -34,7 +34,12 @@ function update_script() {
     systemctl stop commafeed
     msg_ok "Stopped Service"
 
-    ensure_dependencies rsync
+    if ! [[ $(dpkg -s rsync 2>/dev/null) ]]; then
+      msg_info "Installing Dependencies"
+      $STD apt update
+      $STD apt install -y rsync
+      msg_ok "Installed Dependencies"
+    fi
 
     if [ -d /opt/commafeed/data ] && [ "$(ls -A /opt/commafeed/data)" ]; then
       msg_info "Backing up existing data"

ct/cronicle.sh

@@ -44,7 +44,10 @@ function update_script() {
     NODE_VERSION="22" setup_nodejs
     if check_for_gh_release "cronicle" "jhuckaby/Cronicle"; then
       msg_info "Installing Dependencies"
-      ensure_dependencies git build-essential ca-certificates
+      $STD apt install -y \
+        git \
+        build-essential \
+        ca-certificates
       msg_ok "Installed Dependencies"
 
       NODE_VERSION="22" setup_nodejs

ct/dispatcharr.sh

@@ -38,7 +38,9 @@ function update_script() {
     systemctl reload nginx
   fi
 
-  ensure_dependencies vlc-bin vlc-plugin-base
+  if ! dpkg -s vlc-bin vlc-plugin-base &>/dev/null; then
+    $STD apt update && $STD apt install -y vlc-bin vlc-plugin-base
+  fi
 
   if check_for_gh_release "Dispatcharr" "Dispatcharr/Dispatcharr"; then
     msg_info "Stopping Services"

ct/fumadocs.sh

@@ -43,7 +43,9 @@ function update_script() {
     msg_error "Project directory does not exist: $PROJECT_DIR"
     exit
   fi
-  ensure_dependencies git
+  if ! command -v git &>/dev/null; then
+    $STD apt install -y git
+  fi
 
   msg_info "Stopping service $SERVICE_NAME"
   systemctl stop "$SERVICE_NAME"

ct/graylog.sh

@@ -45,7 +45,7 @@ function update_script() {
     curl -fsSL "https://packages.graylog2.org/repo/packages/graylog-7.0-repository_latest.deb" -o "graylog-7.0-repository_latest.deb"
     $STD dpkg -i graylog-7.0-repository_latest.deb
     $STD apt update
-    ensure_dependencies graylog-server graylog-datanode
+    $STD apt install -y graylog-server graylog-datanode
     rm -f graylog-7.0-repository_latest.deb
     msg_ok "Updated Graylog"
   elif dpkg --compare-versions "$CURRENT_VERSION" ge "7.0"; then

ct/grist.sh

@@ -29,8 +29,6 @@ function update_script() {
     exit
   fi
 
-  ensure_dependencies git
-
   if check_for_gh_release "grist" "gristlabs/grist-core"; then
     msg_info "Stopping Service"
     systemctl stop grist

ct/headers/alpine-rustypaste

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

ct/headers/nginx-ui

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

ct/headers/opencloud

@@ -1,6 +0,0 @@
-   ____                   ________                __
-  / __ \____  ___  ____  / ____/ /___  __  ______/ /
- / / / / __ \/ _ \/ __ \/ /   / / __ \/ / / / __  / 
-/ /_/ / /_/ /  __/ / / / /___/ / /_/ / /_/ / /_/ /  
-\____/ .___/\___/_/ /_/\____/_/\____/\__,_/\__,_/   
-    /_/                                             

ct/headers/rustypaste

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

ct/headers/sqlserver2025

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

ct/headers/wealthfolio

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

ct/headers/wishlist

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

ct/headers/writefreely

@@ -1,6 +0,0 @@
- _       __     _ __       ______               __     
-| |     / /____(_) /____  / ____/_______  ___  / /_  __
-| | /| / / ___/ / __/ _ \/ /_  / ___/ _ \/ _ \/ / / / /
-| |/ |/ / /  / / /_/  __/ __/ / /  /  __/  __/ / /_/ / 
-|__/|__/_/  /_/\__/\___/_/   /_/   \___/\___/_/\__, /  
-                                              /____/   

ct/homepage.sh

@@ -30,7 +30,14 @@ function update_script() {
 
   get_lxc_ip  
   NODE_VERSION="22" NODE_MODULE="pnpm@latest" setup_nodejs
-  ensure_dependencies jq
+  if ! command -v jq &>/dev/null; then
+    $STD msg_info "Installing jq..."
+    $STD apt-get update -qq &>/dev/null
+    $STD apt-get install -y jq &>/dev/null || {
+      msg_error "Failed to install jq"
+      exit
+    }
+  fi
 
   if check_for_gh_release "homepage" "gethomepage/homepage"; then
     msg_info "Stopping service"

ct/immich.sh

@@ -36,6 +36,10 @@ function update_script() {
     exit
   fi
 
+  setup_uv
+  PNPM_VERSION="$(curl -fsSL "https://raw.githubusercontent.com/immich-app/immich/refs/heads/main/package.json" | jq -r '.packageManager | split("@")[1]')"
+  NODE_VERSION="24" NODE_MODULE="pnpm@${PNPM_VERSION}" setup_nodejs
+
   if [[ ! -f /etc/apt/preferences.d/preferences ]]; then
     msg_info "Adding Debian Testing repo"
     sed -i 's/ trixie-updates/ trixie-updates testing/g' /etc/apt/sources.list.d/debian.sources
@@ -63,7 +67,8 @@ EOF
     msg_info "Installing Mise"
     curl -fSs https://mise.jdx.dev/gpg-key.pub | tee /etc/apt/keyrings/mise-archive-keyring.pub 1>/dev/null
     echo "deb [signed-by=/etc/apt/keyrings/mise-archive-keyring.pub arch=amd64] https://mise.jdx.dev/deb stable main" >/etc/apt/sources.list.d/mise.list
-    ensure_dependencies mise
+    $STD apt update
+    $STD apt install -y mise
     msg_ok "Installed Mise"
   fi
 
@@ -84,7 +89,7 @@ EOF
         curl -fsSLO "$url"
       done
       $STD apt-mark unhold libigdgmm12
-      $STD apt install -y --allow-downgrades ./libigdgmm12*.deb
+      $STD apt install -y ./libigdgmm12*.deb
       rm ./libigdgmm12*.deb
       $STD apt install -y ./*.deb
       rm ./*.deb
@@ -105,7 +110,7 @@ EOF
     msg_ok "Image-processing libraries up to date"
   fi
 
-  RELEASE="2.5.3"
+  RELEASE="2.5.2"
   if check_for_gh_release "immich" "immich-app/immich" "${RELEASE}"; then
     if [[ $(cat ~/.immich) > "2.5.1" ]]; then
       msg_info "Enabling Maintenance Mode"
@@ -129,7 +134,9 @@ EOF
       $STD sudo -u postgres psql -d immich -c "REINDEX INDEX face_index;"
       $STD sudo -u postgres psql -d immich -c "REINDEX INDEX clip_index;"
     fi
-    ensure_dependencies ccache
+    if ! dpkg -l | grep -q ccache; then
+      $STD apt install -yqq ccache
+    fi
 
     INSTALL_DIR="/opt/${APP}"
     UPLOAD_DIR="$(sed -n '/^IMMICH_MEDIA_LOCATION/s/[^=]*=//p' /opt/immich/.env)"
@@ -160,10 +167,7 @@ EOF
       rm -rf "${APP_DIR:?}"/*
     )
 
-    setup_uv
     CLEAN_INSTALL=1 fetch_and_deploy_gh_release "immich" "immich-app/immich" "tarball" "v${RELEASE}" "$SRC_DIR"
-    PNPM_VERSION="$(jq -r '.packageManager | split("@")[1]' ${SRC_DIR}/package.json)"
-    NODE_VERSION="24" NODE_MODULE="pnpm@${PNPM_VERSION}" setup_nodejs
 
     msg_info "Updating Immich web and microservices"
     cd "$SRC_DIR"/server
@@ -300,7 +304,10 @@ function compile_libjxl() {
 
 function compile_libheif() {
   SOURCE=${SOURCE_DIR}/libheif
-  ensure_dependencies libaom-dev
+  if ! dpkg -l | grep -q libaom; then
+    $STD apt install -y libaom-dev
+    local update="required"
+  fi
   : "${LIBHEIF_REVISION:=$(jq -cr '.revision' "$BASE_DIR"/server/sources/libheif.json)}"
   if [[ "${update:-}" ]] || [[ "$LIBHEIF_REVISION" != "$(grep 'libheif' ~/.immich_library_revisions | awk '{print $2}')" ]]; then
     msg_info "Recompiling libheif"

ct/jellyfin.sh

@@ -40,7 +40,9 @@ function update_script() {
   fi
 
   msg_info "Updating Jellyfin"
-  ensure_dependencies libjemalloc2
+  if ! dpkg -s libjemalloc2 >/dev/null 2>&1; then
+    $STD apt install -y libjemalloc2
+  fi
   if [[ ! -f /usr/lib/libjemalloc.so ]]; then
     ln -sf /usr/lib/x86_64-linux-gnu/libjemalloc.so.2 /usr/lib/libjemalloc.so
   fi

ct/karakeep.sh

@@ -38,7 +38,7 @@ function update_script() {
     msg_ok "Updated yt-dlp"
 
     msg_info "Prepare update"
-    ensure_dependencies graphicsmagick ghostscript
+    $STD apt install -y graphicsmagick ghostscript
     if [[ -f /opt/karakeep/.env ]] && [[ ! -f /etc/karakeep/karakeep.env ]]; then
       mkdir -p /etc/karakeep
       mv /opt/karakeep/.env /etc/karakeep/karakeep.env

ct/kimai.sh

@@ -23,7 +23,9 @@ function update_script() {
   header_info
   check_container_storage
   check_container_resources
-  ensure_dependencies lsb-release
+  if ! command -v lsb_release; then
+    apt install -y lsb-release
+  fi
   if [[ ! -d /opt/kimai ]]; then
     msg_error "No ${APP} Installation Found!"
     exit

ct/koillection.sh

@@ -59,8 +59,6 @@ function update_script() {
     $STD yarn install
     $STD yarn build
     mkdir -p /opt/koillection/public/uploads
-    mkdir -p /opt/koillection/var/log
-    chown -R www-data:www-data /opt/koillection/var/log
     chown -R www-data:www-data /opt/koillection/public/uploads
     rm -r /opt/koillection-backup
     

ct/neo4j.sh

@@ -27,8 +27,9 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  JAVA_VERSION="21" setup_java
+  if ! dpkg -l | grep -q temurin-21-jre; then
-
+    JAVA_VERSION="21" setup_java
+  fi
   msg_info "Updating ${APP}"
   $STD apt update
   $STD apt -y upgrade

ct/netvisor.sh

@@ -36,7 +36,12 @@ function update_script() {
   NODE_VERSION="24" setup_nodejs
   CLEAN_INSTALL=1 fetch_and_deploy_gh_release "scanopy" "scanopy/scanopy" "tarball" "latest" "/opt/scanopy"
 
-  ensure_dependencies pkg-config libssl-dev
+  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
 

ct/nginx-ui.sh

@@ -1,68 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: MickLesk (CanbiZ)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://nginxui.com
-
-APP="Nginx-UI"
-var_tags="${var_tags:-webserver;nginx;proxy}"
-var_cpu="${var_cpu:-1}"
-var_ram="${var_ram:-512}"
-var_disk="${var_disk:-4}"
-var_os="${var_os:-debian}"
-var_version="${var_version:-13}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-
-  if [[ ! -f /usr/local/bin/nginx-ui ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  if check_for_gh_release "nginx-ui" "0xJacky/nginx-ui"; then
-    msg_info "Stopping Service"
-    systemctl stop nginx-ui
-    msg_ok "Stopped Service"
-
-    msg_info "Backing up Configuration"
-    cp /usr/local/etc/nginx-ui/app.ini /tmp/nginx-ui-app.ini.bak
-    msg_ok "Backed up Configuration"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "nginx-ui" "0xJacky/nginx-ui" "prebuild" "latest" "/opt/nginx-ui" "nginx-ui-linux-64.tar.gz"
-
-    msg_info "Updating Binary"
-    cp /opt/nginx-ui/nginx-ui /usr/local/bin/nginx-ui
-    chmod +x /usr/local/bin/nginx-ui
-    rm -rf /opt/nginx-ui
-    msg_ok "Updated Binary"
-
-    msg_info "Restoring Configuration"
-    mv /tmp/nginx-ui-app.ini.bak /usr/local/etc/nginx-ui/app.ini
-    msg_ok "Restored Configuration"
-
-    msg_info "Starting Service"
-    systemctl start nginx-ui
-    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}:9000${CL}"

ct/nginxproxymanager.sh

@@ -28,12 +28,6 @@ function update_script() {
     exit
   fi
 
-  msg_error "This script is currently disabled due to an external issue with the OpenResty APT repository."
-  msg_error "The repository's GPG key uses SHA-1 signatures, which are no longer accepted by Debian as of February 1, 2026."
-  msg_error "The issue is tracked in openresty/openresty#1097"
-  msg_error "For more details, see: https://github.com/community-scripts/ProxmoxVE/issues/11406"
-  exit 1
-
   if [[ $(grep -E '^VERSION_ID=' /etc/os-release) == *"12"* ]]; then
     msg_error "Wrong Debian version detected!"
     msg_error "Please create a snapshot first. You must upgrade your LXC to Debian Trixie before updating. Visit: https://github.com/community-scripts/ProxmoxVE/discussions/7489"

ct/odoo.sh

@@ -28,8 +28,8 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  ensure_dependencies python3-lxml
   if ! [[ $(dpkg -s python3-lxml-html-clean 2>/dev/null) ]]; then
+    $STD apt install python3-lxml
     curl -fsSL "http://archive.ubuntu.com/ubuntu/pool/universe/l/lxml-html-clean/python3-lxml-html-clean_0.1.1-1_all.deb" -o /opt/python3-lxml-html-clean.deb
     $STD dpkg -i /opt/python3-lxml-html-clean.deb
     rm -f /opt/python3-lxml-html-clean.deb

ct/ollama.sh

@@ -32,7 +32,11 @@ function update_script() {
     if [[ ! -f /opt/Ollama_version.txt ]]; then
       touch /opt/Ollama_version.txt
     fi
-    ensure_dependencies zstd
+    if ! command -v zstd &>/dev/null; then
+      msg_info "Installing zstd"
+      $STD apt install -y zstd
+      msg_ok "Installed zstd"
+    fi
     msg_info "Stopping Services"
     systemctl stop ollama
     msg_ok "Services Stopped"

ct/opencloud.sh

@@ -1,60 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: vhsdream
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://opencloud.eu
-
-APP="OpenCloud"
-var_tags="${var_tags:-files;cloud}"
-var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-2048}"
-var_disk="${var_disk:-20}"
-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 /etc/opencloud ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  RELEASE="v5.0.1"
-  if check_for_gh_release "opencloud" "opencloud-eu/opencloud" "${RELEASE}"; then
-    msg_info "Stopping services"
-    systemctl stop opencloud opencloud-wopi
-    msg_ok "Stopped services"
-
-    msg_info "Updating packages"
-    $STD apt-get update
-    $STD apt-get dist-upgrade -y
-    msg_ok "Updated packages"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "opencloud" "opencloud-eu/opencloud" "singlefile" "${RELEASE}" "/usr/bin" "opencloud-*-linux-amd64"
-
-    msg_info "Starting services"
-    systemctl start opencloud opencloud-wopi
-    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}https://<your-OpenCloud-FQDN>${CL}"

ct/openwebui.sh

@@ -92,7 +92,11 @@ EOF
     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
-      ensure_dependencies zstd
+      if ! command -v zstd &>/dev/null; then
+        msg_info "Installing zstd"
+        $STD apt install -y zstd
+        msg_ok "Installed zstd"
+      fi
       msg_info "Ollama update available: v$OLLAMA_VERSION -> v$RELEASE"
       msg_info "Downloading Ollama v$RELEASE \n"
       curl -fS#LO https://github.com/ollama/ollama/releases/download/v${RELEASE}/ollama-linux-amd64.tar.zst

ct/paperless-ngx.sh

@@ -69,7 +69,7 @@ function update_script() {
       if [ "$VERSION_CODENAME" = "bookworm" ]; then
         setup_gs
       else
-        ensure_dependencies ghostscript
+        $STD apt install -y ghostscript
       fi
 
       msg_info "Updating Paperless-ngx"
@@ -145,7 +145,7 @@ function update_script() {
         setup_gs
       else
         msg_info "Installing Ghostscript"
-        ensure_dependencies ghostscript
+        $STD apt install -y ghostscript
         msg_ok "Installed Ghostscript"
       fi
 

ct/photoprism.sh

@@ -45,7 +45,7 @@ function update_script() {
     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)
     if [[ "${LIBHEIF_URL}" != "$(cat ~/.photoprism_libheif 2>/dev/null)" ]] || [[ ! -f ~/.photoprism_libheif ]]; then
       msg_info "Updating PhotoPrism LibHeif"
-      ensure_dependencies libvips42
+      $STD apt install -y libvips42
       curl -fsSL "https://dl.photoprism.app/dist/libheif/$LIBHEIF_URL" -o /tmp/libheif.tar.gz
       tar -xzf /tmp/libheif.tar.gz -C /usr/local
       ldconfig

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
-      ensure_dependencies aspnetcore-runtime-9.0
+      $STD apt install -y aspnetcore-runtime-9.0
     fi
     rm -rf /opt/rdtc-backup
 

ct/rustypaste.sh

@@ -1,69 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -s https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: GoldenSpringness
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/orhun/rustypaste
-
-APP="rustypaste"
-var_tags="${var_tags:-pastebin;storage}"
-var_cpu="${var_cpu:-1}"
-var_ram="${var_ram:-1024}"
-var_disk="${var_disk:-20}"
-var_os="${var_os:-debian}"
-var_version="${var_version:-13}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-
-  if [[ ! -f /opt/rustypaste/rustypaste ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  if check_for_gh_release "rustypaste" "orhun/rustypaste"; then
-    msg_info "Stopping Services"
-    systemctl stop rustypaste
-    msg_ok "Stopped Services"
-
-    msg_info "Creating Backup"
-    tar -czf "/opt/rustypaste_backup_$(date +%F).tar.gz" /opt/rustypaste/upload 2>/dev/null || true
-    cp /opt/rustypaste/config.toml /tmp/rustypaste_config.toml.bak
-    msg_ok "Backup Created"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "rustypaste" "orhun/rustypaste" "prebuild" "latest" "/opt/rustypaste" "*x86_64-unknown-linux-gnu.tar.gz"
-
-    msg_info "Restoring Data"
-    mv /tmp/rustypaste_config.toml.bak /opt/rustypaste/config.toml
-    tar -xzf "/opt/rustypaste_backup_$(date +%F).tar.gz" -C /opt/rustypaste/upload 2>/dev/null || true
-    rm -rf /opt/rustypaste_backup_$(date +%F).tar.gz
-    msg_ok "Restored Data"
-
-    msg_info "Starting Services"
-    systemctl start rustypaste
-    msg_ok "Started Services"
-    msg_ok "Updated successfully!"
-  fi
-
-  if check_for_gh_release "rustypaste-cli" "orhun/rustypaste-cli"; then
-    fetch_and_deploy_gh_release "rustypaste-cli" "orhun/rustypaste-cli" "prebuild" "latest" "/usr/local/bin" "*x86_64-unknown-linux-gnu.tar.gz"
-  fi
-  exit
-}
-
-start
-build_container
-description
-
-msg_ok "Completed successfully!\n"
-echo -e "${CREATING}${GN}rustypaste setup has been successfully initialized!${CL}"
-echo -e "${INFO}${YW} Access it using the following URL:${CL}"
-echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:8000${CL}"

ct/scanopy.sh

@@ -29,7 +29,7 @@ function update_script() {
     exit
   fi
 
-  if check_for_gh_release "Scanopy" "scanopy/scanopy"; then
+  if check_for_gh_release "scanopy" "scanopy/scanopy"; then
     msg_info "Stopping services"
     systemctl stop scanopy-server
     [[ -f /etc/systemd/system/scanopy-daemon.service ]] && systemctl stop scanopy-daemon
@@ -40,9 +40,14 @@ function update_script() {
     [[ -f /opt/scanopy/oidc.toml ]] && cp /opt/scanopy/oidc.toml /opt/scanopy.oidc.toml
     msg_ok "Backed up configurations"
 
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "Scanopy" "scanopy/scanopy" "tarball" "latest" "/opt/scanopy"
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "scanopy" "scanopy/scanopy" "tarball" "latest" "/opt/scanopy"
 
-    ensure_dependencies pkg-config libssl-dev
+    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
 
@@ -61,22 +66,16 @@ function update_script() {
     $STD npm run build
     msg_ok "Created frontend UI"
 
-    msg_info "Building Scanopy Server (patience)"
+    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_ok "Built scanopy-server"
 
-    if [[ -f /etc/systemd/system/scanopy-daemon.service ]]; then
+    msg_info "Building scanopy-daemon"
-      fetch_and_deploy_gh_release "Scanopy Daemon" "scanopy/scanopy" "singlefile" "latest" "/usr/local/bin" "scanopy-daemon-linux-amd64"
+    $STD cargo build --release --bin daemon
-      mv "/usr/local/bin/Scanopy Daemon" /usr/local/bin/scanopy-daemon
+    cp ./target/release/daemon /usr/bin/scanopy-daemon
-      rm -f /usr/bin/scanopy-daemon ~/configure_daemon.sh
+    msg_ok "Built scanopy-daemon"
-      sed -i -e 's|usr/bin|usr/local/bin|' \
-        -e 's/push/daemon_poll/' \
-        -e 's/pull/server_poll/' /etc/systemd/system/scanopy-daemon.service
-      systemctl daemon-reload
-      msg_ok "Updated Scanopy Daemon"
-    fi
 
     msg_info "Starting services"
     systemctl start scanopy-server

ct/sqlserver2022.sh

@@ -27,8 +27,7 @@ function update_script() {
         msg_error "No ${APP} Installation Found!"
         exit
     fi
-    msg_info "Updating SQL Server 2022"
+    msg_info "Updating ${APP} LXC"
-    rm -f /etc/profile.d/debuginfod.sh /etc/profile.d/debuginfod.csh
     $STD apt update
     $STD apt -y upgrade
     msg_ok "Updated successfully!"

ct/sqlserver2025.sh

@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: MickLesk (CanbiZ)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://www.microsoft.com/en-us/sql-server/sql-server-2025
-
-APP="SQL Server 2025"
-var_tags="${var_tags:-sql;database}"
-var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-2048}"
-var_disk="${var_disk:-10}"
-var_os="${var_os:-ubuntu}"
-var_version="${var_version:-24.04}"
-var_unprivileged="${var_unprivileged:-0}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-    header_info
-    check_container_storage
-    check_container_resources
-    if [[ ! -d /opt/mssql ]]; then
-        msg_error "No ${APP} Installation Found!"
-        exit
-    fi
-    msg_info "Updating SQL Server 2025"
-    rm -f /etc/profile.d/debuginfod.sh /etc/profile.d/debuginfod.csh
-    $STD apt update
-    $STD apt -y upgrade
-    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 IP:${CL}"
-echo -e "${TAB}${GATEWAY}${BGN}${IP}:1433${CL}"

ct/twingate-connector.sh

@@ -30,7 +30,8 @@ function update_script() {
   fi
 
   msg_info "Updating ${APP}"
-  ensure_dependencies twingate-connector
+  $STD apt update
+  $STD apt install -yq twingate-connector
   $STD systemctl restart twingate-connector
   msg_ok "Updated successfully!"
   exit

ct/unifi.sh

@@ -32,7 +32,7 @@ function update_script() {
 
   msg_info "Updating ${APP}"
   $STD apt update --allow-releaseinfo-change
-  ensure_dependencies unifi
+  $STD apt install -y unifi
   msg_ok "Updated successfully!"
   exit
 }

ct/uptimekuma.sh

@@ -30,9 +30,12 @@ function update_script() {
 
   NODE_VERSION="22" setup_nodejs
 
-  ensure_dependencies chromium
+  if ! dpkg -s chromium >/dev/null 2>&1; then
-  if [[ ! -L /opt/uptime-kuma/chromium ]]; then
+    msg_info "Installing Chromium"
+    $STD apt update
+    $STD apt install -y chromium
     ln -s /usr/bin/chromium /opt/uptime-kuma/chromium
+    msg_ok "Installed Chromium"
   fi
 
   if check_for_gh_release "uptime-kuma" "louislam/uptime-kuma"; then

ct/vaultwarden.sh

@@ -28,8 +28,12 @@ function update_script() {
     exit
   fi
 
-  VAULT=$(get_latest_github_release "dani-garcia/vaultwarden")
+  VAULT=$(curl -fsSL https://api.github.com/repos/dani-garcia/vaultwarden/releases/latest |
-  WVRELEASE=$(get_latest_github_release "dani-garcia/bw_web_builds")
+    grep "tag_name" |
+    awk '{print substr($2, 2, length($2)-3) }')
+  WVRELEASE=$(curl -fsSL https://api.github.com/repos/dani-garcia/bw_web_builds/releases/latest |
+    grep "tag_name" |
+    awk '{print substr($2, 2, length($2)-3) }')
 
   UPD=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "SUPPORT" --radiolist --cancel-button Exit-Script "Spacebar = Select" 11 58 3 \
     "1" "VaultWarden $VAULT" ON \
@@ -38,70 +42,57 @@ function update_script() {
     3>&1 1>&2 2>&3)
 
   if [ "$UPD" == "1" ]; then
-    if check_for_gh_release "vaultwarden" "dani-garcia/vaultwarden"; then
+    msg_info "Stopping Service"
-      msg_info "Stopping Service"
+    systemctl stop vaultwarden
-      systemctl stop vaultwarden
+    msg_ok "Stopped Service"
-      msg_ok "Stopped Service"
 
-      fetch_and_deploy_gh_release "vaultwarden" "dani-garcia/vaultwarden" "tarball" "latest" "/tmp/vaultwarden-src"
+    msg_info "Updating VaultWarden to $VAULT (Patience)"
-
+    cd ~ && rm -rf vaultwarden
-      msg_info "Updating VaultWarden to $VAULT (Patience)"
+    $STD git clone https://github.com/dani-garcia/vaultwarden
-      cd /tmp/vaultwarden-src
+    cd vaultwarden
-      $STD cargo build --features "sqlite,mysql,postgresql" --release
+    $STD cargo build --features "sqlite,mysql,postgresql" --release
-      if [[ -f /usr/bin/vaultwarden ]]; then
+    DIR=/usr/bin/vaultwarden
-        cp target/release/vaultwarden /usr/bin/
+    if [ -d "$DIR" ]; then
-      else
+      cp target/release/vaultwarden /usr/bin/
-        cp target/release/vaultwarden /opt/vaultwarden/bin/
-      fi
-      cd ~ && rm -rf /tmp/vaultwarden-src
-      msg_ok "Updated VaultWarden to ${VAULT}"
-
-      msg_info "Starting Service"
-      systemctl start vaultwarden
-      msg_ok "Started Service"
-      msg_ok "Updated successfully!"
     else
-      msg_ok "VaultWarden is already up-to-date"
+      cp target/release/vaultwarden /opt/vaultwarden/bin/
     fi
+    cd ~ && rm -rf vaultwarden
+    msg_ok "Updated VaultWarden"
+
+    msg_info "Starting Service"
+    systemctl start vaultwarden
+    msg_ok "Started Service"
+    msg_ok "Updated successfully!"
     exit
   fi
-
   if [ "$UPD" == "2" ]; then
-    if check_for_gh_release "vaultwarden_webvault" "dani-garcia/bw_web_builds"; then
+    msg_info "Stopping Service"
-      msg_info "Stopping Service"
+    systemctl stop vaultwarden
-      systemctl stop vaultwarden
+    msg_ok "Stopped Service"
-      msg_ok "Stopped Service"
 
-      msg_info "Updating Web-Vault to $WVRELEASE"
+    msg_info "Updating Web-Vault to $WVRELEASE"
-      rm -rf /opt/vaultwarden/web-vault
+    $STD curl -fsSLO https://github.com/dani-garcia/bw_web_builds/releases/download/"$WVRELEASE"/bw_web_"$WVRELEASE".tar.gz
-      mkdir -p /opt/vaultwarden/web-vault
+    $STD tar -zxf bw_web_"$WVRELEASE".tar.gz -C /opt/vaultwarden/
+    rm bw_web_"$WVRELEASE".tar.gz
+    msg_ok "Updated Web-Vault"
 
-      fetch_and_deploy_gh_release "vaultwarden_webvault" "dani-garcia/bw_web_builds" "prebuild" "latest" "/opt/vaultwarden/web-vault" "bw_web_*.tar.gz"
+    msg_info "Starting Service"
-
+    systemctl start vaultwarden
-      chown -R root:root /opt/vaultwarden/web-vault/
+    msg_ok "Started Service"
-      msg_ok "Updated Web-Vault to ${WVRELEASE}"
+    msg_ok "Updated successfully!"
-
-      msg_info "Starting Service"
-      systemctl start vaultwarden
-      msg_ok "Started Service"
-      msg_ok "Updated successfully!"
-    else
-      msg_ok "Web-Vault is already up-to-date"
-    fi
     exit
   fi
-
   if [ "$UPD" == "3" ]; then
     if NEWTOKEN=$(whiptail --backtitle "Proxmox VE Helper Scripts" --passwordbox "Set the ADMIN_TOKEN" 10 58 3>&1 1>&2 2>&3); then
       if [[ -z "$NEWTOKEN" ]]; then exit; fi
-      ensure_dependencies argon2
+      if ! command -v argon2 >/dev/null 2>&1; then $STD apt-get install -y argon2; fi
       TOKEN=$(echo -n "${NEWTOKEN}" | argon2 "$(openssl rand -base64 32)" -t 2 -m 16 -p 4 -l 64 -e)
       sed -i "s|ADMIN_TOKEN=.*|ADMIN_TOKEN='${TOKEN}'|" /opt/vaultwarden/.env
       if [[ -f /opt/vaultwarden/data/config.json ]]; then
         sed -i "s|\"admin_token\":.*|\"admin_token\": \"${TOKEN}\"|" /opt/vaultwarden/data/config.json
       fi
       systemctl restart vaultwarden
-      msg_ok "Admin token updated"
     fi
     exit
   fi

ct/wanderer.sh

@@ -20,50 +20,50 @@ color
 catch_errors
 
 function update_script() {
-  header_info
+    header_info
-  check_container_storage
+    check_container_storage
-  check_container_resources
+    check_container_resources
 
-  if [[ ! -f /opt/wanderer/start.sh ]]; then
+    if [[ ! -f /opt/wanderer/start.sh ]]; then
-    msg_error "No wanderer Installation Found!"
+        msg_error "No wanderer Installation Found!"
+        exit
+    fi
+
+    if check_for_gh_release "wanderer" "Flomp/wanderer"; then
+        msg_info "Stopping service"
+        systemctl stop wanderer-web
+        msg_ok "Stopped service"
+        
+				fetch_and_deploy_gh_release "wanderer" "Flomp/wanderer"  "tarball" "latest" "/opt/wanderer/source"
+				
+        msg_info "Updating wanderer"
+        cd /opt/wanderer/source/db
+        $STD go mod tidy
+       	$STD go build
+        cd /opt/wanderer/source/web
+        $STD npm ci --omit=dev
+        $STD npm run build
+        msg_ok "Updated wanderer"
+
+        msg_info "Starting service"
+        systemctl start wanderer-web
+        msg_ok "Started service"
+        msg_ok "Update Successful"
+    fi
+    if check_for_gh_release "meilisearch" "meilisearch/meilisearch"; then
+        msg_info "Stopping service"
+        systemctl stop wanderer-web
+        msg_ok "Stopped service"
+
+        fetch_and_deploy_gh_release "meilisearch" "meilisearch/meilisearch" "binary" "latest" "/opt/wanderer/source/search"
+        grep -q -- '--experimental-dumpless-upgrade' /opt/wanderer/start.sh || sed -i 's|meilisearch --master-key|meilisearch --experimental-dumpless-upgrade --master-key|' /opt/wanderer/start.sh
+
+        msg_info "Starting service"
+        systemctl start wanderer-web
+        msg_ok "Started service"
+        msg_ok "Update Successful"
+    fi
     exit
-  fi
-
-  if check_for_gh_release "wanderer" "Flomp/wanderer"; then
-    msg_info "Stopping service"
-    systemctl stop wanderer-web
-    msg_ok "Stopped service"
-
-    fetch_and_deploy_gh_release "wanderer" "open-wanderer/wanderer" "tarball" "latest" "/opt/wanderer/source"
-
-    msg_info "Updating wanderer"
-    cd /opt/wanderer/source/db
-    $STD go mod tidy
-    $STD go build
-    cd /opt/wanderer/source/web
-    $STD npm ci --omit=dev
-    $STD npm run build
-    msg_ok "Updated wanderer"
-
-    msg_info "Starting service"
-    systemctl start wanderer-web
-    msg_ok "Started service"
-    msg_ok "Update Successful"
-  fi
-  if check_for_gh_release "meilisearch" "meilisearch/meilisearch"; then
-    msg_info "Stopping service"
-    systemctl stop wanderer-web
-    msg_ok "Stopped service"
-
-    fetch_and_deploy_gh_release "meilisearch" "meilisearch/meilisearch" "binary" "latest" "/opt/wanderer/source/search"
-    grep -q -- '--experimental-dumpless-upgrade' /opt/wanderer/start.sh || sed -i 's|meilisearch --master-key|meilisearch --experimental-dumpless-upgrade --master-key|' /opt/wanderer/start.sh
-
-    msg_info "Starting service"
-    systemctl start wanderer-web
-    msg_ok "Started service"
-    msg_ok "Update Successful"
-  fi
-  exit
 }
 
 start

ct/wastebin.sh

@@ -27,7 +27,10 @@ function update_script() {
     msg_error "No ${APP} Installation Found!"
     exit
   fi
-  ensure_dependencies zstd
+  if ! [[ $(dpkg -s zstd 2>/dev/null) ]]; then
+    $STD apt update
+    $STD apt install -y zstd
+  fi
   RELEASE=$(curl -fsSL https://api.github.com/repos/matze/wastebin/releases/latest | grep "tag_name" | awk '{print substr($2, 2, length($2)-3) }')
   # Dirty-Fix 03/2025 for missing APP_version.txt on old installations, set to pre-latest release
   msg_info "Running Migration"

ct/wealthfolio.sh

@@ -1,86 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: CrazyWolf13
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://wealthfolio.app/
-
-APP="Wealthfolio"
-var_tags="${var_tags:-finance;portfolio}"
-var_cpu="${var_cpu:-4}"
-var_ram="${var_ram:-4096}"
-var_disk="${var_disk:-10}"
-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/wealthfolio ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  if check_for_gh_release "wealthfolio" "afadil/wealthfolio"; then
-    msg_info "Stopping Service"
-    systemctl stop wealthfolio
-    msg_ok "Stopped Service"
-
-    msg_info "Backing up Data"
-    cp -r /opt/wealthfolio_data /opt/wealthfolio_data_backup
-    cp /opt/wealthfolio/.env /opt/wealthfolio_env_backup
-    msg_ok "Backed up Data"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "wealthfolio" "afadil/wealthfolio" "tarball"
-
-    msg_info "Building Frontend (patience)"
-    cd /opt/wealthfolio
-    $STD pnpm install --frozen-lockfile
-    $STD pnpm tsc
-    $STD pnpm vite build
-    msg_ok "Built Frontend"
-
-    msg_info "Building Backend (patience)"
-    cd /opt/wealthfolio/src-server
-    source ~/.cargo/env
-    $STD cargo build --release --manifest-path Cargo.toml
-    cp /opt/wealthfolio/src-server/target/release/wealthfolio-server /usr/local/bin/wealthfolio-server
-    chmod +x /usr/local/bin/wealthfolio-server
-    msg_ok "Built Backend"
-
-    msg_info "Restoring Data"
-    cp -r /opt/wealthfolio_data_backup/. /opt/wealthfolio_data
-    cp /opt/wealthfolio_env_backup /opt/wealthfolio/.env
-    rm -rf /opt/wealthfolio_data_backup /opt/wealthfolio_env_backup
-    msg_ok "Restored Data"
-
-    msg_info "Cleaning Up"
-    rm -rf /opt/wealthfolio/src-server/target
-    rm -rf /root/.cargo/registry
-    rm -rf /opt/wealthfolio/node_modules
-    msg_ok "Cleaned Up"
-
-    msg_info "Starting Service"
-    systemctl start wealthfolio
-    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}:8080${CL}"

ct/wishlist.sh

@@ -1,82 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: Dunky13
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/cmintey/wishlist
-
-APP="Wishlist"
-var_tags="${var_tags:-sharing}"
-var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-2048}"
-var_disk="${var_disk:-5}"
-var_os="${var_os:-debian}"
-var_version="${var_version:-13}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-  if [[ ! -d /opt/wishlist ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  if check_for_gh_release "wishlist" "cmintey/wishlist"; then
-    NODE_VERSION="24" NODE_MODULE="pnpm" setup_nodejs
-
-    msg_info "Stopping Service"
-    systemctl stop wishlist
-    msg_ok "Stopped Service"
-
-    msg_info "Creating Backup"
-    mkdir -p /opt/wishlist-backup
-    cp /opt/wishlist/.env /opt/wishlist-backup/.env
-    cp -a /opt/wishlist/uploads /opt/wishlist-backup
-    cp -a /opt/wishlist/data /opt/wishlist-backup
-    msg_ok "Created Backup"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "wishlist" "cmintey/wishlist" "tarball"
-    LATEST_APP_VERSION=$(get_latest_github_release "cmintey/wishlist")
-
-    msg_info "Updating Wishlist"
-    cd /opt/wishlist
-    $STD pnpm install
-    $STD pnpm svelte-kit sync
-    $STD pnpm prisma generate
-    sed -i 's|/usr/src/app/|/opt/wishlist/|g' $(grep -rl '/usr/src/app/' /opt/wishlist)
-    export VERSION="v${LATEST_APP_VERSION}"
-    export SHA="v${LATEST_APP_VERSION}"
-    $STD pnpm run build
-    $STD pnpm prune --prod
-    chmod +x /opt/wishlist/entrypoint.sh
-
-    msg_info "Restoring Backup"
-    cp /opt/wishlist-backup/.env /opt/wishlist/.env
-    cp -a /opt/wishlist-backup/uploads /opt/wishlist
-    cp -a /opt/wishlist-backup/data /opt/wishlist
-    rm -rf /opt/wishlist-backup
-    msg_ok "Restored Backup"
-    
-    msg_ok "Updated Wishlist"
-    msg_info "Starting Service"
-    systemctl start wishlist
-    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}:3280${CL}"

ct/writefreely.sh

@@ -1,72 +0,0 @@
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: StellaeAlis
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/writefreely/writefreely
-
-APP="WriteFreely"
-var_tags="${var_tags:-writing}"
-var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-1024}"
-var_disk="${var_disk:-4}"
-var_os="${var_os:-debian}"
-var_version="${var_version:-13}"
-var_unprivileged="${var_unprivileged:-1}"
-
-header_info "$APP"
-variables
-color
-catch_errors
-
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-
-  if [[ ! -d /opt/writefreely ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  if check_for_gh_release "writefreely" "writefreely/writefreely"; then
-    msg_info "Stopping Services"
-    systemctl stop writefreely
-    msg_ok "Stopped Services"
-
-    msg_info "Creating Backup"
-    mkdir -p /tmp/writefreely_backup
-    cp /opt/writefreely/keys /tmp/writefreely_backup/ 2>/dev/null
-    cp /opt/writefreely/config.ini /tmp/writefreely_backup/ 2>/dev/null
-    msg_ok "Created Backup"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "writefreely" "writefreely/writefreely" "prebuild" "latest" "/opt/writefreely" "writefreely_*_linux_amd64.tar.gz"
-
-    msg_info "Restoring Data"
-    cp /tmp/writefreely_backup/config.ini /opt/writefreely/ 2>/dev/null
-    cp /tmp/writefreely_backup/keys/* /opt/writefreely/keys/ 2>/dev/null
-    rm -rf /tmp/writefreely_backup
-    msg_ok "Restored Data"
-
-    msg_info "Running Post-Update Tasks"
-    cd /opt/writefreely
-    $STD ./writefreely db migrate
-    ln -s /opt/writefreely/writefreely /usr/local/bin/writefreely
-    msg_ok "Ran Post-Update Tasks"
-
-    msg_info "Starting Services"
-    systemctl start writefreely
-    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}"

docs/contribution/AI.md

@@ -1,868 +0,0 @@
-# 🤖 AI Contribution Guidelines for ProxmoxVE
-
-> **This documentation is intended for all AI assistants (GitHub Copilot, Claude, ChatGPT, etc.) contributing to this project.**
-
-## 🎯 Core Principles
-
-### 1. **Maximum Use of `tools.func` Functions**
-
-We have an extensive library of helper functions. **NEVER** implement your own solutions when a function already exists!
-
-### 2. **No Pointless Variables**
-
-Only create variables when they:
-
-- Are used multiple times
-- Improve readability
-- Are intended for configuration
-
-### 3. **Consistent Script Structure**
-
-All scripts follow an identical structure. Deviations are not acceptable.
-
-### 4. **Bare-Metal Installation**
-
-We do **NOT use Docker** for our installation scripts. All applications are installed directly on the system.
-
----
-
-## 📁 Script Types and Their Structure
-
-### CT Script (`ct/AppName.sh`)
-
-```bash
-#!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: AuthorName (GitHubUsername)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://application-url.com
-
-APP="AppName"
-var_tags="${var_tags:-tag1;tag2;tag3}"
-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/appname ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  if check_for_gh_release "appname" "YourUsername/YourRepo"; then
-    msg_info "Stopping Service"
-    systemctl stop appname
-    msg_ok "Stopped Service"
-
-    msg_info "Backing up Data"
-    cp -r /opt/appname/data /opt/appname_data_backup
-    msg_ok "Backed up Data"
-
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
-
-    # Build steps...
-
-    msg_info "Restoring Data"
-    cp -r /opt/appname_data_backup/. /opt/appname/data
-    rm -rf /opt/appname_data_backup
-    msg_ok "Restored Data"
-
-    msg_info "Starting Service"
-    systemctl start appname
-    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}:PORT${CL}"
-```
-
-### Install Script (`install/AppName-install.sh`)
-
-```bash
-#!/usr/bin/env bash
-
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: AuthorName (GitHubUsername)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://application-url.com
-
-source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
-color
-verb_ip6
-catch_errors
-setting_up_container
-network_check
-update_os
-
-msg_info "Installing Dependencies"
-$STD apt-get install -y \
-  dependency1 \
-  dependency2
-msg_ok "Installed Dependencies"
-
-# Runtime Setup (ALWAYS use our functions!)
-NODE_VERSION="22" setup_nodejs
-# or
-PG_VERSION="16" setup_postgresql
-# or
-setup_uv
-# etc.
-
-fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
-
-msg_info "Setting up Application"
-cd /opt/appname
-# Build/Setup Schritte...
-msg_ok "Set up Application"
-
-msg_info "Creating Service"
-cat <<EOF >/etc/systemd/system/appname.service
-[Unit]
-Description=AppName Service
-After=network.target
-
-[Service]
-Type=simple
-User=root
-WorkingDirectory=/opt/appname
-ExecStart=/path/to/executable
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=multi-user.target
-EOF
-systemctl enable -q --now appname
-msg_ok "Created Service"
-
-motd_ssh
-customize
-cleanup_lxc
-```
-
----
-
-## 🔧 Available Helper Functions
-
-### Release Management
-
-| Function                      | Description                         | Example                                                       |
-| ----------------------------- | ----------------------------------- | ------------------------------------------------------------- |
-| `fetch_and_deploy_gh_release` | Fetches and installs GitHub Release | `fetch_and_deploy_gh_release "app" "owner/repo"`              |
-| `check_for_gh_release`        | Checks for new version              | `if check_for_gh_release "app" "YourUsername/YourRepo"; then` |
-
-**Modes for `fetch_and_deploy_gh_release`:**
-
-```bash
-# Tarball/Source (Standard)
-fetch_and_deploy_gh_release "appname" "owner/repo"
-
-# Binary (.deb)
-fetch_and_deploy_gh_release "appname" "owner/repo" "binary"
-
-# Prebuilt Archive
-fetch_and_deploy_gh_release "appname" "owner/repo" "prebuild" "latest" "/opt/appname" "filename.tar.gz"
-
-# Single Binary
-fetch_and_deploy_gh_release "appname" "owner/repo" "singlefile" "latest" "/opt/appname" "binary-linux-amd64"
-```
-
-**Clean Install Flag:**
-
-```bash
-CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo"
-```
-
-### Runtime/Language Setup
-
-| Function       | Variable(s)                   | Example                                              |
-| -------------- | ----------------------------- | ---------------------------------------------------- |
-| `setup_nodejs` | `NODE_VERSION`, `NODE_MODULE` | `NODE_VERSION="22" setup_nodejs`                     |
-| `setup_uv`     | `PYTHON_VERSION`              | `PYTHON_VERSION="3.12" setup_uv`                     |
-| `setup_go`     | `GO_VERSION`                  | `GO_VERSION="1.22" setup_go`                         |
-| `setup_rust`   | `RUST_VERSION`, `RUST_CRATES` | `RUST_CRATES="monolith" setup_rust`                  |
-| `setup_ruby`   | `RUBY_VERSION`                | `RUBY_VERSION="3.3" setup_ruby`                      |
-| `setup_java`   | `JAVA_VERSION`                | `JAVA_VERSION="21" setup_java`                       |
-| `setup_php`    | `PHP_VERSION`, `PHP_MODULES`  | `PHP_VERSION="8.3" PHP_MODULES="redis,gd" setup_php` |
-
-### Database Setup
-
-| Function              | Variable(s)                          | Example                                                     |
-| --------------------- | ------------------------------------ | ----------------------------------------------------------- |
-| `setup_postgresql`    | `PG_VERSION`, `PG_MODULES`           | `PG_VERSION="16" setup_postgresql`                          |
-| `setup_postgresql_db` | `PG_DB_NAME`, `PG_DB_USER`           | `PG_DB_NAME="mydb" PG_DB_USER="myuser" setup_postgresql_db` |
-| `setup_mariadb_db`    | `MARIADB_DB_NAME`, `MARIADB_DB_USER` | `MARIADB_DB_NAME="mydb" setup_mariadb_db`                   |
-| `setup_mysql`         | `MYSQL_VERSION`                      | `setup_mysql`                                               |
-| `setup_mongodb`       | `MONGO_VERSION`                      | `setup_mongodb`                                             |
-| `setup_clickhouse`    | -                                    | `setup_clickhouse`                                          |
-
-### Tools & Utilities
-
-| Function            | Description                        |
-| ------------------- | ---------------------------------- |
-| `setup_adminer`     | Installs Adminer for DB management |
-| `setup_composer`    | Install PHP Composer               |
-| `setup_ffmpeg`      | Install FFmpeg                     |
-| `setup_imagemagick` | Install ImageMagick                |
-| `setup_gs`          | Install Ghostscript                |
-| `setup_hwaccel`     | Configure hardware acceleration    |
-
-### Helper Utilities
-
-| Function                      | Description                  | Example                                   |
-| ----------------------------- | ---------------------------- | ----------------------------------------- |
-| `import_local_ip`             | Sets `$LOCAL_IP` variable    | `import_local_ip`                         |
-| `ensure_dependencies`         | Checks/installs dependencies | `ensure_dependencies curl jq`             |
-| `install_packages_with_retry` | APT install with retry       | `install_packages_with_retry nginx redis` |
-
----
-
-## ❌ Anti-Patterns (NEVER use!)
-
-### 1. Pointless Variables
-
-```bash
-# ❌ WRONG - unnecessary variables
-APP_NAME="myapp"
-APP_DIR="/opt/${APP_NAME}"
-APP_USER="root"
-APP_PORT="3000"
-cd $APP_DIR
-
-# ✅ CORRECT - use directly
-cd /opt/myapp
-```
-
-### 2. Custom Download Logic
-
-```bash
-# ❌ WRONG - custom wget/curl logic
-RELEASE=$(curl -s https://api.github.com/repos/YourUsername/YourRepo/releases/latest | jq -r '.tag_name')
-wget https://github.com/YourUsername/YourRepo/archive/${RELEASE}.tar.gz
-tar -xzf ${RELEASE}.tar.gz
-mv repo-${RELEASE} /opt/myapp
-
-# ✅ CORRECT - use our function
-fetch_and_deploy_gh_release "myapp" "YourUsername/YourRepo" "tarball" "latest" "/opt/myapp"
-```
-
-### 3. Custom Version-Check Logic
-
-```bash
-# ❌ WRONG - custom version check
-CURRENT=$(cat /opt/myapp/version.txt)
-LATEST=$(curl -s https://api.github.com/repos/YourUsername/YourRepo/releases/latest | jq -r '.tag_name')
-if [[ "$CURRENT" != "$LATEST" ]]; then
-  # update...
-fi
-
-# ✅ CORRECT - use our function
-if check_for_gh_release "myapp" "YourUsername/YourRepo"; then
-  # update...
-fi
-```
-
-### 4. Docker-based Installation
-
-```bash
-# ❌ WRONG - using Docker
-docker pull myapp/myapp:latest
-docker run -d --name myapp myapp/myapp:latest
-
-# ✅ CORRECT - Bare-Metal Installation
-fetch_and_deploy_gh_release "myapp" "YourUsername/YourRepo"
-npm install && npm run build
-```
-
-### 5. Custom Runtime Installation
-
-```bash
-# ❌ WRONG - custom Node.js installation
-curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
-apt install -y nodejs
-
-# ✅ CORRECT - use our function
-NODE_VERSION="22" setup_nodejs
-```
-
-### 6. Redundant echo Statements
-
-```bash
-# ❌ WRONG - custom logging messages
-echo "Installing dependencies..."
-apt install -y curl
-echo "Done!"
-
-# ✅ CORRECT - use msg_info/msg_ok
-msg_info "Installing Dependencies"
-$STD apt install -y curl
-msg_ok "Installed Dependencies"
-```
-
-### 7. Missing $STD Usage
-
-```bash
-# ❌ WRONG - apt without $STD
-apt install -y nginx
-
-# ✅ CORRECT - with $STD for silent output
-$STD apt install -y nginx
-```
-
-### 8. Wrapping `tools.func` Functions in msg Blocks
-
-```bash
-# ❌ WRONG - tools.func functions have their own msg_info/msg_ok!
-msg_info "Installing Node.js"
-NODE_VERSION="22" setup_nodejs
-msg_ok "Installed Node.js"
-
-msg_info "Updating Application"
-CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
-msg_ok "Updated Application"
-
-# ✅ CORRECT - call directly without msg wrapper
-NODE_VERSION="22" setup_nodejs
-
-CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
-```
-
-**Functions with built-in messages (NEVER wrap in msg blocks):**
-
-- `fetch_and_deploy_gh_release`
-- `check_for_gh_release`
-- `setup_nodejs`
-- `setup_postgresql` / `setup_postgresql_db`
-- `setup_mariadb` / `setup_mariadb_db`
-- `setup_mongodb`
-- `setup_mysql`
-- `setup_ruby`
-- `setup_go`
-- `setup_java`
-- `setup_php`
-- `setup_uv`
-- `setup_rust`
-- `setup_composer`
-- `setup_ffmpeg`
-- `setup_imagemagick`
-- `setup_gs`
-- `setup_adminer`
-- `setup_hwaccel`
-
-### 9. Creating Unnecessary System Users
-
-```bash
-# ❌ WRONG - LXC containers run as root, no separate user needed
-useradd -m -s /usr/bin/bash appuser
-chown -R appuser:appuser /opt/appname
-sudo -u appuser npm install
-
-# ✅ CORRECT - run directly as root
-cd /opt/appname
-$STD npm install
-```
-
-### 10. Using `export` in .env Files
-
-```bash
-# ❌ WRONG - export is unnecessary in .env files
-cat <<EOF >/opt/appname/.env
-export DATABASE_URL=postgres://...
-export SECRET_KEY=abc123
-export NODE_ENV=production
-EOF
-
-# ✅ CORRECT - simple KEY=VALUE format (files are sourced with set -a)
-cat <<EOF >/opt/appname/.env
-DATABASE_URL=postgres://...
-SECRET_KEY=abc123
-NODE_ENV=production
-EOF
-```
-
-### 11. Using External Shell Scripts
-
-```bash
-# ❌ WRONG - external script that gets executed
-cat <<'EOF' >/opt/appname/install_script.sh
-#!/bin/bash
-cd /opt/appname
-npm install
-npm run build
-EOF
-chmod +x /opt/appname/install_script.sh
-$STD bash /opt/appname/install_script.sh
-rm -f /opt/appname/install_script.sh
-
-# ✅ CORRECT - run commands directly
-cd /opt/appname
-$STD npm install
-$STD npm run build
-```
-
-### 12. Using `sudo` in LXC Containers
-
-```bash
-# ❌ WRONG - sudo is unnecessary in LXC (already root)
-sudo -u postgres psql -c "CREATE DATABASE mydb;"
-sudo -u appuser npm install
-
-# ✅ CORRECT - use functions or run directly as root
-PG_DB_NAME="mydb" PG_DB_USER="myuser" setup_postgresql_db
-
-cd /opt/appname
-$STD npm install
-```
-
-### 13. Unnecessary `systemctl daemon-reload`
-
-```bash
-# ❌ WRONG - daemon-reload is only needed when MODIFYING existing services
-cat <<EOF >/etc/systemd/system/appname.service
-# ... service config ...
-EOF
-systemctl daemon-reload  # Unnecessary for new services!
-systemctl enable -q --now appname
-
-# ✅ CORRECT - new services don't need daemon-reload
-cat <<EOF >/etc/systemd/system/appname.service
-# ... service config ...
-EOF
-systemctl enable -q --now appname
-```
-
-### 14. Creating Custom Credentials Files
-
-```bash
-# ❌ WRONG - custom credentials file is not part of the standard template
-msg_info "Saving Credentials"
-cat <<EOF >~/appname.creds
-Database User: ${DB_USER}
-Database Pass: ${DB_PASS}
-EOF
-msg_ok "Saved Credentials"
-
-# ✅ CORRECT - credentials are stored in .env or shown in final message only
-# If you use setup_postgresql_db / setup_mariadb_db, a standard ~/[appname].creds is created automatically
-```
-
-### 15. Wrong Footer Pattern
-
-```bash
-# ❌ WRONG - old cleanup pattern with msg blocks
-motd_ssh
-customize
-
-msg_info "Cleaning up"
-$STD apt-get -y autoremove
-$STD apt-get -y autoclean
-msg_ok "Cleaned"
-
-# ✅ CORRECT - use cleanup_lxc function
-motd_ssh
-customize
-cleanup_lxc
-```
-
-### 16. Manual Database Creation Instead of Functions
-
-```bash
-# ❌ WRONG - manual database creation
-DB_USER="myuser"
-DB_PASS=$(openssl rand -base64 18 | tr -dc 'a-zA-Z0-9' | cut -c1-13)
-$STD sudo -u postgres psql -c "CREATE ROLE $DB_USER WITH LOGIN PASSWORD '$DB_PASS';"
-$STD sudo -u postgres psql -c "CREATE DATABASE mydb WITH OWNER $DB_USER;"
-$STD sudo -u postgres psql -d mydb -c "CREATE EXTENSION IF NOT EXISTS postgis;"
-
-# ✅ CORRECT - use setup_postgresql_db function
-# This sets PG_DB_USER, PG_DB_PASS, PG_DB_NAME automatically
-PG_DB_NAME="mydb" PG_DB_USER="myuser" PG_DB_EXTENSIONS="postgis" setup_postgresql_db
-```
-
-### 17. Writing Files Without Heredocs
-
-```bash
-# ❌ WRONG - echo / printf / tee
-echo "# Config" > /opt/app/config.yml
-echo "port: 3000" >> /opt/app/config.yml
-
-printf "# Config\nport: 3000\n" > /opt/app/config.yml
-cat config.yml | tee /opt/app/config.yml
-```
-
-```bash
-# ✅ CORRECT - always use a single heredoc
-cat <<EOF >/opt/app/config.yml
-# Config
-port: 3000
-EOF
-```
-
----
-
-## 📝 Important Rules
-
-### Variable Declarations (CT Script)
-
-```bash
-# Standard declarations (ALWAYS present)
-APP="AppName"
-var_tags="${var_tags:-tag1;tag2}"
-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}"
-```
-
-### Update-Script Pattern
-
-```bash
-function update_script() {
-  header_info
-  check_container_storage
-  check_container_resources
-
-  # 1. Check if installation exists
-  if [[ ! -d /opt/appname ]]; then
-    msg_error "No ${APP} Installation Found!"
-    exit
-  fi
-
-  # 2. Check for update
-  if check_for_gh_release "appname" "YourUsername/YourRepo"; then
-    # 3. Stop service
-    msg_info "Stopping Service"
-    systemctl stop appname
-    msg_ok "Stopped Service"
-
-    # 4. Backup data (if present)
-    msg_info "Backing up Data"
-    cp -r /opt/appname/data /opt/appname_data_backup
-    msg_ok "Backed up Data"
-
-    # 5. Perform clean install
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "latest" "/opt/appname"
-
-    # 6. Rebuild (if needed)
-    cd /opt/appname
-    $STD npm install
-    $STD npm run build
-
-    # 7. Restore data
-    msg_info "Restoring Data"
-    cp -r /opt/appname_data_backup/. /opt/appname/data
-    rm -rf /opt/appname_data_backup
-    msg_ok "Restored Data"
-
-    # 8. Start service
-    msg_info "Starting Service"
-    systemctl start appname
-    msg_ok "Started Service"
-    msg_ok "Updated successfully!"
-  fi
-  exit  # IMPORTANT: Always end with exit!
-}
-```
-
-### Systemd Service Pattern
-
-```bash
-msg_info "Creating Service"
-cat <<EOF >/etc/systemd/system/appname.service
-[Unit]
-Description=AppName Service
-After=network.target
-
-[Service]
-Type=simple
-User=root
-WorkingDirectory=/opt/appname
-Environment=NODE_ENV=production
-ExecStart=/usr/bin/node /opt/appname/server.js
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=multi-user.target
-EOF
-systemctl enable -q --now appname
-msg_ok "Created Service"
-```
-
-### Installation Script Footer
-
-```bash
-# ALWAYS at the end of the install script:
-motd_ssh
-customize
-cleanup_lxc
-```
-
----
-
-## 📖 Reference: Good Example Scripts
-
-Look at these recent well-implemented applications as reference:
-
-### Container Scripts (Latest 10)
-
-- [ct/thingsboard.sh](../ct/thingsboard.sh) - IoT platform with proper update_script
-- [ct/unifi-os-server.sh](../ct/unifi-os-server.sh) - Complex setup with podman
-- [ct/trip.sh](../ct/trip.sh) - Simple Ruby app
-- [ct/fladder.sh](../ct/fladder.sh) - Media app with database
-- [ct/qui.sh](../ct/qui.sh) - Lightweight utility
-- [ct/kutt.sh](../ct/kutt.sh) - Node.js with PostgreSQL
-- [ct/flatnotes.sh](../ct/flatnotes.sh) - Python notes app
-- [ct/investbrain.sh](../ct/investbrain.sh) - Finance app
-- [ct/gwn-manager.sh](../ct/gwn-manager.sh) - Network management
-- [ct/sportarr.sh](../ct/sportarr.sh) - Specialized \*Arr variant
-
-### Install Scripts (Latest)
-
-- [install/unifi-os-server-install.sh](../install/unifi-os-server-install.sh) - Complex setup with API integration
-- [install/trip-install.sh](../install/trip-install.sh) - Rails application setup
-- [install/mail-archiver-install.sh](../install/mail-archiver-install.sh) - Email-related service
-
-**Key things to notice:**
-
-- Proper error handling with `catch_errors`
-- Use of `check_for_gh_release` and `fetch_and_deploy_gh_release`
-- Correct backup/restore patterns in `update_script`
-- Footer always ends with `motd_ssh`, `customize`, `cleanup_lxc`
-- JSON metadata files created for each app
-
----
-
-## <20> JSON Metadata Files
-
-Every application requires a JSON metadata file in `frontend/public/json/<appname>.json`.
-
-### JSON Structure
-
-```json
-{
-  "name": "AppName",
-  "slug": "appname",
-  "categories": [1],
-  "date_created": "2026-01-16",
-  "type": "ct",
-  "updateable": true,
-  "privileged": false,
-  "interface_port": 3000,
-  "documentation": "https://docs.appname.com/",
-  "website": "https://appname.com/",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/appname.webp",
-  "config_path": "/opt/appname/.env",
-  "description": "Short description of the application and its purpose.",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "ct/appname.sh",
-      "resources": {
-        "cpu": 2,
-        "ram": 2048,
-        "hdd": 8,
-        "os": "Debian",
-        "version": "13"
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": null,
-    "password": null
-  },
-  "notes": []
-}
-```
-
-### Required Fields
-
-| Field                 | Type    | Description                                        |
-| --------------------- | ------- | -------------------------------------------------- |
-| `name`                | string  | Display name of the application                    |
-| `slug`                | string  | Lowercase, no spaces, used for filenames           |
-| `categories`          | array   | Category ID(s) - see category list below           |
-| `date_created`        | string  | Creation date (YYYY-MM-DD)                         |
-| `type`                | string  | `ct` for container, `vm` for virtual machine       |
-| `updateable`          | boolean | Whether update_script is implemented               |
-| `privileged`          | boolean | Whether container needs privileged mode            |
-| `interface_port`      | number  | Primary web interface port (or `null`)             |
-| `documentation`       | string  | Link to official docs                              |
-| `website`             | string  | Link to official website                           |
-| `logo`                | string  | URL to application logo (preferably selfhst icons) |
-| `config_path`         | string  | Path to main config file (or empty string)         |
-| `description`         | string  | Brief description of the application               |
-| `install_methods`     | array   | Installation configurations                        |
-| `default_credentials` | object  | Default username/password (or null)                |
-| `notes`               | array   | Additional notes/warnings                          |
-
-### Categories
-
-| ID  | Category                  |
-| --- | ------------------------- |
-| 0   | Miscellaneous             |
-| 1   | Proxmox & Virtualization  |
-| 2   | Operating Systems         |
-| 3   | Containers & Docker       |
-| 4   | Network & Firewall        |
-| 5   | Adblock & DNS             |
-| 6   | Authentication & Security |
-| 7   | Backup & Recovery         |
-| 8   | Databases                 |
-| 9   | Monitoring & Analytics    |
-| 10  | Dashboards & Frontends    |
-| 11  | Files & Downloads         |
-| 12  | Documents & Notes         |
-| 13  | Media & Streaming         |
-| 14  | \*Arr Suite               |
-| 15  | NVR & Cameras             |
-| 16  | IoT & Smart Home          |
-| 17  | ZigBee, Z-Wave & Matter   |
-| 18  | MQTT & Messaging          |
-| 19  | Automation & Scheduling   |
-| 20  | AI / Coding & Dev-Tools   |
-| 21  | Webservers & Proxies      |
-| 22  | Bots & ChatOps            |
-| 23  | Finance & Budgeting       |
-| 24  | Gaming & Leisure          |
-| 25  | Business & ERP            |
-
-### Notes Format
-
-```json
-"notes": [
-    {
-        "text": "Change the default password after first login!",
-        "type": "warning"
-    },
-    {
-        "text": "Requires at least 4GB RAM for optimal performance.",
-        "type": "info"
-    }
-]
-```
-
-**Note types:** `info`, `warning`, `error`
-
-### Examples with Credentials
-
-```json
-"default_credentials": {
-    "username": "admin",
-    "password": "admin"
-}
-```
-
-Or no credentials:
-
-```json
-"default_credentials": {
-    "username": null,
-    "password": null
-}
-```
-
----
-
-## 🔍 Checklist Before PR Creation
-
-- [ ] No Docker installation used
-- [ ] `fetch_and_deploy_gh_release` used for GitHub releases
-- [ ] `check_for_gh_release` used for update checks
-- [ ] `setup_*` functions used for runtimes (nodejs, postgresql, etc.)
-- [ ] **`tools.func` functions NOT wrapped in msg_info/msg_ok blocks**
-- [ ] No redundant variables (only when used multiple times)
-- [ ] `$STD` before all apt/npm/build commands
-- [ ] `msg_info`/`msg_ok`/`msg_error` for logging (only for custom code)
-- [ ] Correct script structure followed (see templates)
-- [ ] Update function present and functional (CT scripts)
-- [ ] Data backup implemented in update function (if applicable)
-- [ ] `motd_ssh`, `customize`, `cleanup_lxc` at the end of install scripts
-- [ ] No custom download/version-check logic
-- [ ] All links point to `community-scripts/ProxmoxVE` (not `ProxmoxVED`!)
-- [ ] JSON metadata file created in `frontend/public/json/<appname>.json`
-- [ ] Category IDs are valid (0-25)
-- [ ] Default OS version is Debian 13 or newer (unless special requirement)
-- [ ] Default resources are reasonable for the application
-
----
-
-## 💡 Tips for AI Assistants
-
-1. **ALWAYS search `tools.func` first** before implementing custom solutions
-2. **Use recent scripts as reference** (Thingsboard, UniFi OS, Trip, Flatnotes, etc.)
-3. **Ask when uncertain** instead of introducing wrong patterns
-4. **Test via GitHub** - push to your fork and test with curl (not local bash)
-   ```bash
-   bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
-   # Wait 10-30 seconds after pushing - GitHub takes time to update files
-   ```
-5. **Consistency > Creativity** - follow established patterns strictly
-6. **Check the templates** - they show the correct structure
-7. **Don't wrap tools.func functions** - they handle their own msg_info/msg_ok output
-8. **Minimal variables** - only create variables that are truly reused multiple times
-9. **Always use $STD** - ensures silent/non-interactive execution
-10. **Reference good examples** - look at recent additions in each category
-
----
-
-## 🍒 Important: Cherry-Picking Your Files for PR Submission
-
-⚠️ **CRITICAL**: When you submit your PR, you must use git cherry-pick to send ONLY your 3-4 files!
-
-Why? Because `setup-fork.sh` modifies 600+ files to update links. If you commit all changes, your PR will be impossible to merge.
-
-**See**: [README.md - Cherry-Pick Section](README.md#-cherry-pick-submitting-only-your-changes) for complete instructions on:
-
-- Creating a clean submission branch
-- Cherry-picking only your files (ct/myapp.sh, install/myapp-install.sh, frontend/public/json/myapp.json)
-- Verifying your PR has only 3 file changes (not 600+)
-
-**Quick reference**:
-
-```bash
-# Create clean branch from upstream
-git fetch upstream
-git checkout -b submit/myapp upstream/main
-
-# Cherry-pick your commit(s) or manually add your 3-4 files
-# Then push to your fork and create PR
-```
-
----
-
-## 📚 Further Documentation
-
-- [CONTRIBUTING.md](CONTRIBUTING.md) - General contribution guidelines
-- [GUIDE.md](GUIDE.md) - Detailed developer documentation
-- [HELPER_FUNCTIONS.md](HELPER_FUNCTIONS.md) - Complete tools.func reference
-- [README.md](README.md) - Cherry-pick guide and workflow instructions
-- [../TECHNICAL_REFERENCE.md](../TECHNICAL_REFERENCE.md) - Technical deep dive
-- [../EXIT_CODES.md](../EXIT_CODES.md) - Exit code reference
-- [templates_ct/](templates_ct/) - CT script templates
-- [templates_install/](templates_install/) - Install script templates
-- [templates_json/](templates_json/) - JSON metadata templates

docs/contribution/CODE-AUDIT.md

@@ -1,41 +1,14 @@
-# 🧪 Code Audit: LXC Script Flow
+<div align="center">
+<img src="https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/images/logo.png" height="100px" />
+</div>
+<h2><div align="center">Exploring the Scripts and Steps Involved in an Application LXC Installation</div></h2>
 
-This guide explains the current execution flow and what to verify during reviews.
+1) [adguard.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/adguard.sh): This script collects system parameters. (Also holds the function to update the application.)
+2) [build.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/build.func): Adds user settings and integrates collected information.
+3) [create_lxc.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/create_lxc.sh): Constructs the LXC container.
+4) [adguard-install.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/install/adguard-install.sh): Executes functions from [install.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/install.func), and installs the application.
+5) [adguard.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/adguard.sh) (again): To display the completion message.
 
-## Execution Flow (CT + Install)
+The installation process uses reusable scripts: [build.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/build.func), [create_lxc.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/create_lxc.sh), and [install.func](https://github.com/community-scripts/ProxmoxVE/blob/main/misc/install.func), which are not specific to any particular application.
 
-1. `ct/appname.sh` runs on the Proxmox host and sources `misc/build.func`.
+To gain a better understanding, focus on reviewing [adguard-install.sh](https://github.com/community-scripts/ProxmoxVE/blob/main/install/adguard-install.sh). This script contains the commands and configurations for installing and configuring AdGuard Home within the LXC container.
-2. `build.func` orchestrates prompts, container creation, and invokes the install script.
-3. Inside the container, `misc/install.func` exposes helper functions via `$FUNCTIONS_FILE_PATH`.
-4. `install/appname-install.sh` performs the application install.
-5. The CT script prints the completion message.
-
-## Audit Checklist
-
-### CT Script (ct/)
-
-- Sources `misc/build.func` from `community-scripts/ProxmoxVE/main` (setup-fork.sh updates for forks).
-- Uses `check_for_gh_release` + `fetch_and_deploy_gh_release` for updates.
-- No Docker-based installs.
-
-### Install Script (install/)
-
-- Sources `$FUNCTIONS_FILE_PATH`.
-- Uses `tools.func` helpers (setup\_\*).
-- Ends with `motd_ssh`, `customize`, `cleanup_lxc`.
-
-### JSON Metadata
-
-- File in `frontend/public/json/<appname>.json` matches template schema.
-
-### Testing
-
-- Test via curl from your fork (CT script only).
-- Wait 10-30 seconds after push.
-
-## References
-
-- `docs/contribution/templates_ct/AppName.sh`
-- `docs/contribution/templates_install/AppName-install.sh`
-- `docs/contribution/templates_json/AppName.json`
-- `docs/contribution/GUIDE.md`

docs/contribution/CONTRIBUTING.md

@@ -81,22 +81,11 @@ git clone https://github.com/yourUserName/ForkName
 git switch -c your-feature-branch
 ```
 
-### 4. Run setup-fork.sh to auto-configure your fork
+### 4. Change paths in build.func install.func and AppName.sh
 
-```bash
+To be able to develop from your own branch you need to change `https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main` to `https://raw.githubusercontent.com/[USER]/[REPOSITORY]/refs/heads/[BRANCH]`. You need to make this change atleast in misc/build.func misc/install.func and in your ct/AppName.sh. This change is only for testing. Before opening a Pull Request you should change this line change all this back to point to `https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main`.
-bash docs/contribution/setup-fork.sh --full
-```
 
-This script automatically:
+### 4. Commit changes (without build.func and install.func!)
-
-- Detects your GitHub username
-- Updates ALL curl URLs to point to your fork (for testing)
-- Creates `.git-setup-info` with your config
-- Backs up all modified files (\*.backup)
-
-**IMPORTANT**: This modifies 600+ files! Use cherry-pick when submitting your PR (see below).
-
-### 5. Commit ONLY your new application files
 
 ```bash
 git commit -m "Your commit message"
@@ -108,66 +97,9 @@ git commit -m "Your commit message"
 git push origin your-feature-branch
 ```
 
-### 6. Cherry-Pick: Submit Only Your Files for PR
+### 6. Create a Pull Request
 
-⚠️ **IMPORTANT**: setup-fork.sh modified 600+ files. You MUST only submit your 3 new files!
+Open a Pull Request from your feature branch to the main repository branch. You must only include your **$AppName.sh**, **$AppName-install.sh** and **$AppName.json** files in the pull request.
-
-See [README.md - Cherry-Pick Guide](README.md#-cherry-pick-submitting-only-your-changes) for step-by-step instructions.
-
-Quick version:
-
-```bash
-# Create clean branch from upstream
-git fetch upstream
-git checkout -b submit/myapp upstream/main
-
-# Copy only your files
-cp ../your-work-branch/ct/myapp.sh ct/myapp.sh
-cp ../your-work-branch/install/myapp-install.sh install/myapp-install.sh
-cp ../your-work-branch/frontend/public/json/myapp.json frontend/public/json/myapp.json
-
-# Commit and verify
-git add ct/myapp.sh install/myapp-install.sh frontend/public/json/myapp.json
-git commit -m "feat: add MyApp"
-git diff upstream/main --name-only  # Should show ONLY your 3 files
-
-# Push and create PR
-git push origin submit/myapp
-```
-
-### 7. Create a Pull Request
-
-Open a Pull Request from `submit/myapp` → `community-scripts/ProxmoxVE/main`.
-
-Verify the PR shows ONLY these 3 files:
-
-- `ct/myapp.sh`
-- `install/myapp-install.sh`
-- `frontend/public/json/myapp.json`
-
----
-
-# 🛠️ Developer Mode & Debugging
-
-When building or testing scripts, you can use the `dev_mode` variable to enable powerful debugging features. These flags can be combined (comma-separated).
-
-**Usage**:
-```bash
-# Example: Run with trace and keep the container even if it fails
-dev_mode="trace,keep" bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/myapp.sh)"
-```
-
-### Available Flags:
-
-| Flag | Description |
-| :--- | :--- |
-| `trace` | Enables `set -x` for maximum verbosity during execution. |
-| `keep` | Prevents the container from being deleted if the build fails. |
-| `pause` | Pauses execution at key points (e.g., before customization). |
-| `breakpoint` | Allows hardcoded `breakpoint` calls in scripts to drop to a shell. |
-| `logs` | Saves detailed build logs to `/var/log/community-scripts/`. |
-| `dryrun` | Bypasses actual container creation (limited support). |
-| `motd` | Forces an update of the Message of the Day (MOTD). |
 
 ---
 

docs/contribution/FORK_SETUP.md

@@ -10,7 +10,7 @@ git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
 cd ProxmoxVE
 
 # Run setup script (auto-detects your username from git)
-bash docs/contribution/setup-fork.sh --full
+bash setup-fork.sh
 ```
 
 That's it! ✅
@@ -22,101 +22,64 @@ That's it! ✅
 The `setup-fork.sh` script automatically:
 
 1. **Detects** your GitHub username from git config
-2. **Updates ALL hardcoded links** to point to your fork:
+2. **Updates** 22 hardcoded links in documentation to point to your fork
-   - Documentation links pointing to `community-scripts/ProxmoxVE`
+3. **Creates** `.git-setup-info` with recommended git workflows
-   - **Curl download URLs** in scripts (e.g., `curl ... github.com/community-scripts/ProxmoxVE/main/...`)
+4. **Backs up** all modified files (*.backup)
-3. **Creates** `.git-setup-info` with your configuration details
-4. **Backs up** all modified files (\*.backup for safety)
-
-### Why Updating Curl Links Matters
-
-Your scripts contain `curl` commands that download dependencies from GitHub (build.func, tools.func, etc.):
-
-```bash
-# First line of ct/myapp.sh
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-```
-
-**WITHOUT setup-fork.sh:**
-
-- Script URLs still point to `community-scripts/ProxmoxVE/main`
-- If you test locally with `bash ct/myapp.sh`, you're testing local files, but the script's curl commands would download from **upstream** repo
-- Your modifications aren't actually being tested via the curl commands! ❌
-
-**AFTER setup-fork.sh:**
-
-- Script URLs are updated to `YourUsername/ProxmoxVE/main`
-- When you test via curl from GitHub: `bash -c "$(curl ... YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"`, it downloads from **your fork**
-- The script's curl commands also point to your fork, so you're actually testing your changes! ✅
-- ⏱️ **Important:** GitHub takes 10-30 seconds to recognize pushed files - wait before testing!
-
-```bash
-# Example: What setup-fork.sh changes
-
-# BEFORE (points to upstream):
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-
-# AFTER (points to your fork):
-source <(curl -fsSL https://raw.githubusercontent.com/john/ProxmoxVE/main/misc/build.func)
-```
 
 ---
 
 ## Usage
 
 ### Auto-Detect (Recommended)
-
 ```bash
-bash docs/contribution/setup-fork.sh --full
+bash setup-fork.sh
 ```
-
 Automatically reads your GitHub username from `git remote origin url`
 
 ### Specify Username
-
 ```bash
-bash docs/contribution/setup-fork.sh --full john
+bash setup-fork.sh john
 ```
-
 Updates links to `github.com/john/ProxmoxVE`
 
 ### Custom Repository Name
-
 ```bash
-bash docs/contribution/setup-fork.sh --full john my-fork
+bash setup-fork.sh john my-fork
 ```
-
 Updates links to `github.com/john/my-fork`
 
 ---
 
 ## What Gets Updated?
 
-The script updates hardcoded links in these areas when using `--full`:
+The script updates these documentation files:
-
+- `docs/CONTRIBUTION_GUIDE.md` (4 links)
-- `ct/`, `install/`, `vm/` scripts
+- `docs/README.md` (1 link)
-- `misc/` function libraries
+- `docs/INDEX.md` (3 links)
-- `docs/` (including `docs/contribution/`)
+- `docs/EXIT_CODES.md` (2 links)
-- Code examples in documentation
+- `docs/DEFAULTS_SYSTEM_GUIDE.md` (2 links)
+- `docs/api/README.md` (1 link)
+- `docs/APP-ct.md` (1 link)
+- `docs/APP-install.md` (1 link)
+- `docs/alpine-install.func.md` (2 links)
+- `docs/install.func.md` (1 link)
+- And code examples in documentation
 
 ---
 
 ## After Setup
 
 1. **Review changes**
-
    ```bash
    git diff docs/
    ```
 
 2. **Read git workflow tips**
-
    ```bash
    cat .git-setup-info
    ```
 
 3. **Start contributing**
-
    ```bash
    git checkout -b feature/my-app
    # Make your changes...
@@ -125,7 +88,7 @@ The script updates hardcoded links in these areas when using `--full`:
 
 4. **Follow the guide**
    ```bash
-   cat docs/contribution/GUIDE.md
+   cat docs/CONTRIBUTION_GUIDE.md
    ```
 
 ---
@@ -133,7 +96,6 @@ The script updates hardcoded links in these areas when using `--full`:
 ## Common Workflows
 
 ### Keep Your Fork Updated
-
 ```bash
 # Add upstream if you haven't already
 git remote add upstream https://github.com/community-scripts/ProxmoxVE.git
@@ -145,7 +107,6 @@ git push origin main
 ```
 
 ### Create a Feature Branch
-
 ```bash
 git checkout -b feature/docker-improvements
 # Make changes...
@@ -154,7 +115,6 @@ git push origin feature/docker-improvements
 ```
 
 ### Sync Before Contributing
-
 ```bash
 git fetch upstream
 git rebase upstream/main
@@ -167,16 +127,14 @@ git checkout -b feature/my-feature
 ## Troubleshooting
 
 ### "Git is not installed" or "not a git repository"
-
 ```bash
 # Make sure you cloned the repo first
 git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
 cd ProxmoxVE
-bash docs/contribution/setup-fork.sh --full
+bash setup-fork.sh
 ```
 
 ### "Could not auto-detect GitHub username"
-
 ```bash
 # Your git origin URL isn't set up correctly
 git remote -v
@@ -184,32 +142,29 @@ git remote -v
 
 # Fix it:
 git remote set-url origin https://github.com/YOUR_USERNAME/ProxmoxVE.git
-bash docs/contribution/setup-fork.sh --full
+bash setup-fork.sh
 ```
 
 ### "Permission denied"
-
 ```bash
 # Make script executable
-chmod +x docs/contribution/setup-fork.sh
+chmod +x setup-fork.sh
-bash docs/contribution/setup-fork.sh --full
+bash setup-fork.sh
 ```
 
 ### Reverted Changes by Accident?
-
 ```bash
 # Backups are created automatically
 git checkout docs/*.backup
 # Or just re-run setup-fork.sh
-bash docs/contribution/setup-fork.sh --full
 ```
 
 ---
 
 ## Next Steps
 
-1. ✅ Run `bash docs/contribution/setup-fork.sh --full`
+1. ✅ Run `bash setup-fork.sh`
-2. 📖 Read [docs/contribution/GUIDE.md](GUIDE.md)
+2. 📖 Read [docs/CONTRIBUTION_GUIDE.md](docs/CONTRIBUTION_GUIDE.md)
 3. 🍴 Choose your contribution path:
    - **Containers** → [docs/ct/README.md](docs/ct/README.md)
    - **Installation** → [docs/install/README.md](docs/install/README.md)
@@ -222,10 +177,10 @@ bash docs/contribution/setup-fork.sh --full
 ## Questions?
 
 - **Fork Setup Issues?** → See [Troubleshooting](#troubleshooting) above
-- **How to Contribute?** → [docs/contribution/GUIDE.md](GUIDE.md)
+- **How to Contribute?** → [docs/CONTRIBUTION_GUIDE.md](docs/CONTRIBUTION_GUIDE.md)
 - **Git Workflows?** → `cat .git-setup-info`
 - **Project Structure?** → [docs/README.md](docs/README.md)
 
 ---
 
-## Happy Contributing! 🚀
+**Happy Contributing! 🚀**

docs/contribution/GUIDE.md

@@ -38,8 +38,8 @@ git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
 cd ProxmoxVE
 
 # 3. Run fork setup script (automatically configures everything)
-bash docs/contribution/setup-fork.sh --full
+bash setup-fork.sh
-# --full updates ct/, install/, vm/, docs/, misc/ links for fork testing
+# This auto-detects your username and updates all documentation links
 
 # 4. Read the git workflow tips
 cat .git-setup-info
@@ -51,29 +51,28 @@ cat .git-setup-info
 # 1. Create feature branch
 git checkout -b add/my-awesome-app
 
-# 2. Create application scripts from templates
+# 2. Create application scripts
-cp docs/contribution/templates_ct/AppName.sh ct/myapp.sh
+cp ct/example.sh ct/myapp.sh
-cp docs/contribution/templates_install/AppName-install.sh install/myapp-install.sh
+cp install/example-install.sh install/myapp-install.sh
-cp docs/contribution/templates_json/AppName.json frontend/public/json/myapp.json
 
 # 3. Edit your scripts
 nano ct/myapp.sh
 nano install/myapp-install.sh
-nano frontend/public/json/myapp.json
 
-# 4. Commit and push to your fork
+# 4. Test locally
-git add ct/myapp.sh install/myapp-install.sh frontend/public/json/myapp.json
+bash ct/myapp.sh  # Will prompt for container creation
-git commit -m "feat: add MyApp container and install scripts"
+
+# 5. Commit and push
+git add ct/myapp.sh install/myapp-install.sh
+git commit -m "feat: add MyApp container"
 git push origin add/my-awesome-app
 
-# 5. Test via curl from your fork (GitHub may take 10-30 seconds)
+# 6. Open Pull Request on GitHub
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
+# Click: New Pull Request (GitHub will show this automatically)
 
-# 6. Use cherry-pick to submit only your files (see Cherry-Pick section)
+# 7. Keep your fork updated
-# DO NOT submit the 600+ files modified by setup-fork.sh!
+git fetch upstream
-
+git rebase upstream/main
-# 7. Open Pull Request on GitHub
-# Create PR from: your-fork/add/my-awesome-app → community-scripts/ProxmoxVE/main
 ```
 
 **💡 Tip**: See `../FORK_SETUP.md` for detailed fork setup and troubleshooting
@@ -113,9 +112,9 @@ ProxmoxVE/
 │   └── alpine-tools.func        # Alpine tools
 │
 ├── docs/                        # 📚 Documentation
-│   ├── ct/DETAILED_GUIDE.md     # Container script guide
+│   ├── UPDATED_APP-ct.md        # Container script guide
-│   ├── install/DETAILED_GUIDE.md # Install script guide
+│   ├── UPDATED_APP-install.md   # Install script guide
-│   └── contribution/README.md   # Contribution overview
+│   └── CONTRIBUTING.md          # (This file!)
 │
 ├── tools/                       # 🔧 Proxmox management tools
 │   └── pve/
@@ -138,7 +137,6 @@ Examples:
 ```
 
 **Rules**:
-
 - Container script name: **Title Case** (PiHole, Docker, NextCloud)
 - Install script name: **lowercase** with **hyphens** (pihole-install, docker-install)
 - Must match: `ct/AppName.sh` ↔ `install/appname-install.sh`
@@ -158,7 +156,6 @@ Examples:
    - Ubuntu 20.04 / Debian 11+ on host
 
 2. **Git** installed
-
    ```bash
    apt-get install -y git
    ```
@@ -201,33 +198,32 @@ git rebase upstream/main
 git push origin feat/add-myapp
 ```
 
-#### Option B: Testing on a Proxmox Host (still via curl)
+#### Option B: Local Testing on Proxmox Host
 
 ```bash
 # 1. SSH into Proxmox host
 ssh root@192.168.1.100
 
-# 2. Test via curl from your fork (CT script only)
+# 2. Download your script
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
+curl -O https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/feat/myapp/ct/myapp.sh
-# ⏱️ Wait 10-30 seconds after pushing - GitHub takes time to update
+
+# 3. Make it executable
+chmod +x myapp.sh
+
+# 4. Update URLs to your fork
+# Edit: curl -s https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/feat/myapp/...
+
+# 5. Run and test
+bash myapp.sh
+
+# 6. If container created successfully, script is working!
 ```
 
-> **Note:** Do not edit URLs manually or run install scripts directly. The CT script calls the install script inside the container.
+#### Option C: Docker Testing (Without Proxmox)
-
-#### Option C: Using Curl (Recommended for Real Testing)
 
 ```bash
-# Always test via curl from your fork (GitHub takes 10-30 seconds after push)
+# You can test script syntax/functionality locally
-git push origin feature/myapp
+# Note: Won't fully test (no Proxmox, no actual container)
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
-# This tests the actual GitHub URLs, not local files
-```
-
-#### Option D: Static Checks (Without Proxmox)
-
-```bash
-# You can validate syntax and linting locally (limited)
-# Note: This does NOT replace real Proxmox testing
 
 # Run ShellCheck
 shellcheck ct/myapp.sh
@@ -245,18 +241,18 @@ bash -n install/myapp-install.sh
 ### Step 1: Choose Your Template
 
 **For Simple Web Apps** (Node.js, Python, PHP):
-
 ```bash
 cp ct/example.sh ct/myapp.sh
 cp install/example-install.sh install/myapp-install.sh
 ```
 
-**For Database Apps** (PostgreSQL, MariaDB, MongoDB):
+**For Database Apps** (PostgreSQL, MongoDB):
-
+```bash
-Use the standard templates and the database helpers from `tools.func` (no Docker).
+cp ct/docker.sh ct/myapp.sh           # Use Docker container
+# OR manual setup for more control
+```
 
 **For Alpine Linux Apps** (lightweight):
-
 ```bash
 # Use ct/alpine.sh as reference
 # Edit install script to use Alpine packages (apk not apt)
@@ -268,7 +264,7 @@ Use the standard templates and the database helpers from `tools.func` (no Docker
 
 ```bash
 #!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/misc/build.func)
+source <(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/feat/myapp/misc/build.func)
 
 # Update these:
 APP="MyAwesomeApp"                    # Display name
@@ -295,19 +291,17 @@ function update_script() {
     exit
   fi
 
-  if check_for_gh_release "myapp" "owner/repo"; then
+  # Get latest version
-    msg_info "Stopping Service"
+  RELEASE=$(curl -fsSL https://api.github.com/repos/user/repo/releases/latest | \
-    systemctl stop myapp
+    grep "tag_name" | awk '{print substr($2, 2, length($2)-3)}')
-    msg_ok "Stopped Service"
 
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "myapp" "owner/repo" "tarball" "latest" "/opt/myapp"
+  if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
-
+    msg_info "Updating ${APP} to v${RELEASE}"
-    # ... update logic (migrations, rebuilds, etc.) ...
+    # ... update logic ...
-
+    echo "${RELEASE}" > /opt/${APP}_version.txt
-    msg_info "Starting Service"
+    msg_ok "Updated ${APP}"
-    systemctl start myapp
+  else
-    msg_ok "Started Service"
+    msg_ok "No update required. ${APP} is already at v${RELEASE}."
-    msg_ok "Updated successfully!"
   fi
   exit
 }
@@ -323,7 +317,6 @@ echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:PORT${CL}"
 ```
 
 **Checklist**:
-
 - [ ] APP variable matches filename
 - [ ] var_tags semicolon-separated (no spaces)
 - [ ] Realistic CPU/RAM/disk values
@@ -352,12 +345,24 @@ update_os
 
 msg_info "Installing Dependencies"
 $STD apt-get install -y \
+  curl \
+  wget \
+  git \
   build-essential
 msg_ok "Installed Dependencies"
 
+msg_info "Setting up Node.js"
 NODE_VERSION="22" setup_nodejs
+msg_ok "Node.js installed"
 
-fetch_and_deploy_gh_release "myapp" "owner/repo" "tarball" "latest" "/opt/myapp"
+msg_info "Downloading Application"
+cd /opt
+wget -q "https://github.com/user/repo/releases/download/v1.0.0/myapp.tar.gz"
+tar -xzf myapp.tar.gz
+rm -f myapp.tar.gz
+msg_ok "Application installed"
+
+echo "1.0.0" > /opt/${APP}_version.txt
 
 motd_ssh
 customize
@@ -365,7 +370,6 @@ cleanup_lxc
 ```
 
 **Checklist**:
-
 - [ ] Functions loaded from `$FUNCTIONS_FILE_PATH`
 - [ ] All installation phases present (deps, tools, app, config, cleanup)
 - [ ] Using `$STD` for output suppression
@@ -433,44 +437,26 @@ $STD apt-get install -y newdependency
 # 4. Test thoroughly before committing
 ```
 
-### Step 3: The Standard Update Pattern
+### Step 3: Update Update Function (if applicable)
 
-The `update_script()` function in `ct/appname.sh` should follow a robust pattern:
-
-1. **Check for updates**: Use `check_for_gh_release` to skip logic if no new version exists.
-2. **Stop services**: Stop all relevant services (`systemctl stop appname`).
-3. **Backup existing installation**: Move the old folder (e.g., `mv /opt/app /opt/app_bak`).
-4. **Deploy new version**: Use `CLEAN_INSTALL=1 fetch_and_deploy_gh_release`.
-5. **Restore configuration**: Copy `.env` or config files back from the backup.
-6. **Rebuild/Migrate**: Run `npm install`, `composer install`, or DB migrations.
-7. **Start services**: Restart services and cleanup the backup.
-
-**Example from `ct/bookstack.sh`**:
 ```bash
-function update_script() {
+# Edit: ct/existingapp.sh → update_script()
-  if check_for_gh_release "bookstack" "BookStackApp/BookStack"; then
+
-    msg_info "Stopping Services"
+# 1. Update GitHub API URL if repo changed
-    systemctl stop apache2
+RELEASE=$(curl -fsSL https://api.github.com/repos/user/repo/releases/latest | ...)
-    
+
-    msg_info "Backing up data"
+# 2. Update backup/restore logic (if structure changed)
-    mv /opt/bookstack /opt/bookstack-backup
+# 3. Update cleanup paths
-    
+
-    fetch_and_deploy_gh_release "bookstack" "BookStackApp/BookStack" "tarball"
+# 4. Test update on existing installation
-    
+```
-    msg_info "Restoring backup"
+
-    cp /opt/bookstack-backup/.env /opt/bookstack/.env
+### Step 4: Document Your Changes
-    # ... restore uploads ...
+
-    
+```bash
-    msg_info "Configuring"
+# Add comment at top of script
-    cd /opt/bookstack
+# Co-Author: YourUsername
-    $STD composer install --no-dev
+# Updated: YYYY-MM-DD - Description of changes
-    $STD php artisan migrate --force
-    
-    systemctl start apache2
-    rm -rf /opt/bookstack-backup
-    msg_ok "Updated successfully!"
-  fi
-}
 ```
 
 ---
@@ -670,19 +656,27 @@ shellcheck install/myapp-install.sh
 # 1. SSH into Proxmox host
 ssh root@YOUR_PROXMOX_IP
 
-# 2. Test via curl from your fork (CT script only)
+# 2. Download your script
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
+curl -O https://raw.githubusercontent.com/YOUR_USER/ProxmoxVE/feat/myapp/ct/myapp.sh
-# ⏱️ Wait 10-30 seconds after pushing - GitHub takes time to update
 
-# 3. Test interaction:
+# 3. Make executable
+chmod +x myapp.sh
+
+# 4. UPDATE URLS IN SCRIPT to point to your fork
+sed -i 's|community-scripts|YOUR_USER|g' myapp.sh
+
+# 5. Run script
+bash myapp.sh
+
+# 6. Test interaction:
 #    - Select installation mode
 #    - Confirm settings
 #    - Monitor installation
 
-# 4. Verify container created
+# 7. Verify container created
 pct list | grep myapp
 
-# 5. Log into container and verify app
+# 8. Log into container and verify app
 pct exec 100 bash
 ```
 
@@ -703,9 +697,9 @@ pct exec 100 bash
 # Verify script handles gracefully
 
 # Test 4: Update function
-# Create initial container (via curl from fork)
+# Create initial container
 # Wait for new release
-# Test update: bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
+# Run update: bash ct/myapp.sh
 # Verify it detects and applies update
 ```
 
@@ -780,19 +774,16 @@ Use this template:
 
 ```markdown
 ## Description
-
 Brief description of what this PR adds/fixes
 
 ## Type of Change
-
 - [ ] New application (ct/AppName.sh + install/appname-install.sh)
 - [ ] Update existing application
 - [ ] Bug fix
 - [ ] Documentation update
-- [ ] Other: **\_\_\_**
+- [ ] Other: _______
 
 ## Testing
-
 - [ ] Tested on Proxmox VE 8.x
 - [ ] Container creation successful
 - [ ] Application installation successful
@@ -801,7 +792,6 @@ Brief description of what this PR adds/fixes
 - [ ] No temporary files left after installation
 
 ## Application Details (for new apps only)
-
 - **App Name**: MyApp
 - **Source**: https://github.com/app/repo
 - **Default OS**: Debian 12
@@ -810,11 +800,9 @@ Brief description of what this PR adds/fixes
 - **Access URL**: http://IP:PORT/path
 
 ## Checklist
-
 - [ ] My code follows the style guidelines
 - [ ] I have performed a self-review
-- [ ] I have tested the script via curl from my fork (after git push)
+- [ ] I have tested the script locally
-- [ ] GitHub had time to update (waited 10-30 seconds)
 - [ ] ShellCheck shows no critical warnings
 - [ ] Documentation is accurate and complete
 - [ ] I have added/updated relevant documentation
@@ -823,7 +811,6 @@ Brief description of what this PR adds/fixes
 ### Step 5: Respond to Review Comments
 
 **Maintainers may request changes**:
-
 - Fix syntax/style issues
 - Add better error handling
 - Optimize resource usage
@@ -935,7 +922,6 @@ pct exec CTID netstat -tlnp | grep LISTEN
 ### Q: Can I test without a Proxmox system?
 
 **A**: Partially. You can verify syntax and ShellCheck compliance locally, but real container testing requires Proxmox. Consider using:
-
 - Proxmox in a VM (VirtualBox/KVM)
 - Test instances on Hetzner/DigitalOcean
 - Ask maintainers to test for you
@@ -943,7 +929,6 @@ pct exec CTID netstat -tlnp | grep LISTEN
 ### Q: My update function is very complex - is that OK?
 
 **A**: Yes! Update functions can be complex if needed. Just ensure:
-
 - Backup user data before updating
 - Restore user data after update
 - Test thoroughly before submitting
@@ -952,7 +937,6 @@ pct exec CTID netstat -tlnp | grep LISTEN
 ### Q: Can I add new dependencies to build.func?
 
 **A**: Generally no. build.func is the orchestrator and should remain stable. New functions should go in:
-
 - `tools.func` - Tool installation
 - `core.func` - Utility functions
 - `install.func` - Container setup
@@ -964,13 +948,11 @@ Ask in an issue first if you're unsure.
 **A**: You have options:
 
 **Option 1**: Use Advanced mode (19-step wizard)
-
 ```bash
 # Extend advanced_settings() if app needs special vars
 ```
 
 **Option 2**: Create custom setup menu
-
 ```bash
 function custom_config() {
   OPTION=$(whiptail --inputbox "Enter database name:" 8 60)
@@ -979,7 +961,6 @@ function custom_config() {
 ```
 
 **Option 3**: Leave as defaults + documentation
-
 ```bash
 # In success message:
 echo "Edit /opt/myapp/config.json to customize settings"
@@ -988,10 +969,9 @@ echo "Edit /opt/myapp/config.json to customize settings"
 ### Q: Can I contribute Windows/macOS/ARM support?
 
 **A**:
-
 - **Windows**: Not planned (ProxmoxVE is Linux/Proxmox focused)
 - **macOS**: Can contribute Docker-based alternatives
-- **ARM**: Yes! Many apps work on ARM. Add to vm/pimox-\*.sh scripts
+- **ARM**: Yes! Many apps work on ARM. Add to vm/pimox-*.sh scripts
 
 ---
 
@@ -1015,7 +995,6 @@ echo "Edit /opt/myapp/config.json to customize settings"
 ### Report Bugs
 
 When reporting bugs, include:
-
 - Which application
 - What happened (error message)
 - What you expected
@@ -1023,7 +1002,6 @@ When reporting bugs, include:
 - Container OS and version
 
 Example:
-
 ```
 Title: pihole-install.sh fails on Alpine 3.20
 
@@ -1047,7 +1025,6 @@ Error Output:
 ## Contribution Statistics
 
 **ProxmoxVE by the Numbers**:
-
 - 🎯 40+ applications supported
 - 👥 100+ contributors
 - 📊 10,000+ GitHub stars
@@ -1061,7 +1038,6 @@ Error Output:
 ## Code of Conduct
 
 By contributing, you agree to:
-
 - ✅ Be respectful and inclusive
 - ✅ Follow the style guidelines
 - ✅ Test your changes thoroughly

docs/contribution/HELPER_FUNCTIONS.md

@@ -30,79 +30,61 @@
 
 > ⚠️ **Both files are ALWAYS required!** The CT script calls the install script automatically during container creation.
 
-Install scripts are **not** run directly by users; they are invoked by the CT script inside the container.
-
 ### Node.js + PostgreSQL
 
 **Koel** - Music streaming with PHP + Node.js + PostgreSQL
-| File | Link |
+| File              | Link                                                     |
 | ----------------- | -------------------------------------------------------- |
-| CT (update logic) | [ct/koel.sh](../../ct/koel.sh) |
+| CT (update logic) | [ct/koel.sh](../../ct/koel.sh)                           |
-| Install | [install/koel-install.sh](../../install/koel-install.sh) |
+| Install           | [install/koel-install.sh](../../install/koel-install.sh) |
 
 **Actual Budget** - Finance app with npm global install
-| File | Link |
+| File              | Link                                                                     |
 | ----------------- | ------------------------------------------------------------------------ |
-| CT (update logic) | [ct/actualbudget.sh](../../ct/actualbudget.sh) |
+| CT (update logic) | [ct/actualbudget.sh](../../ct/actualbudget.sh)                           |
-| Install | [install/actualbudget-install.sh](../../install/actualbudget-install.sh) |
+| Install           | [install/actualbudget-install.sh](../../install/actualbudget-install.sh) |
 
 ### Python + uv
 
 **MeTube** - YouTube downloader with Python uv + Node.js + Deno
-| File | Link |
+| File              | Link                                                         |
 | ----------------- | ------------------------------------------------------------ |
-| CT (update logic) | [ct/metube.sh](../../ct/metube.sh) |
+| CT (update logic) | [ct/metube.sh](../../ct/metube.sh)                           |
-| Install | [install/metube-install.sh](../../install/metube-install.sh) |
+| Install           | [install/metube-install.sh](../../install/metube-install.sh) |
 
 **Endurain** - Fitness tracker with Python uv + PostgreSQL/PostGIS
-| File | Link |
+| File              | Link                                                             |
 | ----------------- | ---------------------------------------------------------------- |
-| CT (update logic) | [ct/endurain.sh](../../ct/endurain.sh) |
+| CT (update logic) | [ct/endurain.sh](../../ct/endurain.sh)                           |
-| Install | [install/endurain-install.sh](../../install/endurain-install.sh) |
+| Install           | [install/endurain-install.sh](../../install/endurain-install.sh) |
-
-### Java + Gradle
-
-**BookLore** - Book management with Java 21 + Gradle + MariaDB + Nginx
-| File | Link |
-| ----------------- | -------------------------------------------------------------- |
-| CT (update logic) | [ct/booklore.sh](../../ct/booklore.sh) |
-| Install | [install/booklore-install.sh](../../install/booklore-install.sh) |
-
-### Pnpm + Meilisearch
-
-**KaraKeep** - Bookmark manager with Pnpm + Meilisearch + Puppeteer
-| File | Link |
-| ----------------- | -------------------------------------------------------------- |
-| CT (update logic) | [ct/karakeep.sh](../../ct/karakeep.sh) |
-| Install | [install/karakeep-install.sh](../../install/karakeep-install.sh) |
 
 ### PHP + MariaDB/MySQL
 
 **Wallabag** - Read-it-later with PHP + MariaDB + Redis + Nginx
-| File | Link |
+| File              | Link                                                             |
 | ----------------- | ---------------------------------------------------------------- |
-| CT (update logic) | [ct/wallabag.sh](../../ct/wallabag.sh) |
+| CT (update logic) | [ct/wallabag.sh](../../ct/wallabag.sh)                           |
-| Install | [install/wallabag-install.sh](../../install/wallabag-install.sh) |
+| Install           | [install/wallabag-install.sh](../../install/wallabag-install.sh) |
 
 **InvoiceNinja** - Invoicing with PHP + MariaDB + Supervisor
-| File | Link |
+| File              | Link                                                                     |
 | ----------------- | ------------------------------------------------------------------------ |
-| CT (update logic) | [ct/invoiceninja.sh](../../ct/invoiceninja.sh) |
+| CT (update logic) | [ct/invoiceninja.sh](../../ct/invoiceninja.sh)                           |
-| Install | [install/invoiceninja-install.sh](../../install/invoiceninja-install.sh) |
+| Install           | [install/invoiceninja-install.sh](../../install/invoiceninja-install.sh) |
 
 **BookStack** - Wiki/Docs with PHP + MariaDB + Apache
-| File | Link |
+| File              | Link                                                               |
 | ----------------- | ------------------------------------------------------------------ |
-| CT (update logic) | [ct/bookstack.sh](../../ct/bookstack.sh) |
+| CT (update logic) | [ct/bookstack.sh](../../ct/bookstack.sh)                           |
-| Install | [install/bookstack-install.sh](../../install/bookstack-install.sh) |
+| Install           | [install/bookstack-install.sh](../../install/bookstack-install.sh) |
 
 ### PHP + SQLite (Simple)
 
 **Speedtest Tracker** - Speedtest with PHP + SQLite + Nginx
-| File | Link |
+| File              | Link                                                                               |
 | ----------------- | ---------------------------------------------------------------------------------- |
-| CT (update logic) | [ct/speedtest-tracker.sh](../../ct/speedtest-tracker.sh) |
+| CT (update logic) | [ct/speedtest-tracker.sh](../../ct/speedtest-tracker.sh)                           |
-| Install | [install/speedtest-tracker-install.sh](../../install/speedtest-tracker-install.sh) |
+| Install           | [install/speedtest-tracker-install.sh](../../install/speedtest-tracker-install.sh) |
 
 ---
 
@@ -113,7 +95,7 @@ Install scripts are **not** run directly by users; they are invoked by the CT sc
 Install Node.js from NodeSource repository.
 
 ```bash
-# Default (Node.js 24)
+# Default (Node.js 22)
 setup_nodejs
 
 # Specific version
@@ -153,12 +135,8 @@ $STD cargo build --release
 Install Python uv package manager (fast pip/venv replacement).
 
 ```bash
-# Default
 setup_uv
 
-# Install a specific Python version
-PYTHON_VERSION="3.12" setup_uv
-
 # Use in script
 setup_uv
 cd /opt/myapp
@@ -182,7 +160,7 @@ Install PHP with configurable modules and FPM/Apache support.
 setup_php
 
 # Full configuration
-PHP_VERSION="8.4" \
+PHP_VERSION="8.3" \
 PHP_MODULE="mysqli,gd,curl,mbstring,xml,zip,ldap" \
 PHP_FPM="YES" \
 PHP_APACHE="YES" \
@@ -190,12 +168,12 @@ setup_php
 ```
 
 **Environment Variables:**
-| Variable | Default | Description |
+| Variable      | Default | Description                     |
 | ------------- | ------- | ------------------------------- |
-| `PHP_VERSION` | `8.4` | PHP version to install |
+| `PHP_VERSION` | `8.3`   | PHP version to install          |
-| `PHP_MODULE` | `""` | Comma-separated list of modules |
+| `PHP_MODULE`  | `""`    | Comma-separated list of modules |
-| `PHP_FPM` | `NO` | Install PHP-FPM |
+| `PHP_FPM`     | `NO`    | Install PHP-FPM                 |
-| `PHP_APACHE` | `NO` | Install Apache module |
+| `PHP_APACHE`  | `NO`    | Install Apache module           |
 
 ### `setup_composer`
 
@@ -261,12 +239,12 @@ setup_mysql
 Install PostgreSQL server.
 
 ```bash
-# Default (PostgreSQL 16)
+# Default (PostgreSQL 17)
 setup_postgresql
 
 # Specific version
 PG_VERSION="16" setup_postgresql
-PG_VERSION="16" setup_postgresql
+PG_VERSION="17" setup_postgresql
 ```
 
 ### `setup_postgresql_db`
@@ -301,43 +279,6 @@ setup_clickhouse
 
 ---
 
-## Advanced Repository Management
-
-### `setup_deb822_repo`
-
-The modern standard (Debian 12+) for adding external repositories. Automatically handles GPG keys and sources.
-
-```bash
-setup_deb822_repo \
-  "nodejs" \
-  "https://deb.nodesource.com/gpgkey/nodesource.gpg.key" \
-  "https://deb.nodesource.com/node_22.x" \
-  "bookworm" \
-  "main"
-```
-
-### `prepare_repository_setup`
-
-A high-level helper that performs three critical tasks before adding a new repo:
-1. Cleans up old repo files matching the names provided.
-2. Removes old GPG keyrings from all standard locations.
-3. Ensures APT is in a working state (fixes locks, runs update).
-
-```bash
-# Clean up old mysql/mariadb artifacts before setup
-prepare_repository_setup "mariadb" "mysql"
-```
-
-### `cleanup_tool_keyrings`
-
-Force-removes GPG keys for specific tools from `/usr/share/keyrings/`, `/etc/apt/keyrings/`, and `/etc/apt/trusted.gpg.d/`.
-
-```bash
-cleanup_tool_keyrings "docker" "kubernetes"
-```
-
----
-
 ## 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.
@@ -361,17 +302,17 @@ CLEAN_INSTALL=1 fetch_and_deploy_gh_release "appname" "owner/repo" "tarball" "la
 ```
 
 **Parameters:**
-| Parameter | Default | Description |
+| Parameter       | Default       | Description                                                       |
 | --------------- | ------------- | ----------------------------------------------------------------- |
-| `name` | required | App name (for version tracking) |
+| `name`          | required      | App name (for version tracking)                                   |
-| `repo` | required | GitHub repo (`owner/repo`) |
+| `repo`          | required      | GitHub repo (`owner/repo`)                                        |
-| `type` | `tarball` | Release type: `tarball`, `zipball`, `prebuild`, `binary` |
+| `type`          | `tarball`     | Release type: `tarball`, `zipball`, `prebuild`, `binary`          |
-| `version` | `latest` | Version tag or `latest` |
+| `version`       | `latest`      | Version tag or `latest`                                           |
-| `dest` | `/opt/[name]` | Destination directory |
+| `dest`          | `/opt/[name]` | Destination directory                                             |
-| `asset_pattern` | `""` | For `prebuild`: glob pattern to match asset (e.g. `app-*.tar.gz`) |
+| `asset_pattern` | `""`          | For `prebuild`: glob pattern to match asset (e.g. `app-*.tar.gz`) |
 
 **Environment Variables:**
-| Variable | Description |
+| Variable          | Description                                                  |
 | ----------------- | ------------------------------------------------------------ |
 | `CLEAN_INSTALL=1` | Remove destination directory before extracting (for updates) |
 
@@ -398,21 +339,26 @@ 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_meilisearch`
-
-Install Meilisearch, a lightning-fast search engine.
-
-```bash
-setup_meilisearch
-
-# Use in script
-$STD php artisan scout:sync-index-settings
-```
-
 ### `setup_yq`
 
 Install yq YAML processor.
@@ -488,15 +434,6 @@ create_self_signed_cert
 
 ## Utility Functions
 
-### `verify_tool_version`
-
-Validate that the installed major version matches the expected version. Useful during upgrades or troubleshooting.
-
-```bash
-# Verify Node.js is version 22
-verify_tool_version "nodejs" "22" "$(node -v | grep -oP '^v\K[0-9]+')"
-```
-
 ### `get_lxc_ip`
 
 Set the `$LOCAL_IP` variable with the container's IP address.
@@ -589,7 +526,7 @@ msg_ok "Installed Dependencies"
 
 # Setup runtimes and databases FIRST
 NODE_VERSION="22" setup_nodejs
-PG_VERSION="16" setup_postgresql
+PG_VERSION="17" setup_postgresql
 PG_DB_NAME="myapp" PG_DB_USER="myapp" setup_postgresql_db
 get_lxc_ip
 

docs/contribution/README.md

@@ -17,9 +17,7 @@ Complete guide to contributing to the ProxmoxVE project - from your first fork t
 
 ## 🚀 Quick Start
 
-### 60 Seconds to Contributing (Development)
+### 60 Seconds to Contributing
-
-When developing and testing **in your fork**:
 
 ```bash
 # 1. Fork on GitHub
@@ -29,8 +27,8 @@ When developing and testing **in your fork**:
 git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
 cd ProxmoxVE
 
-# 3. Auto-configure your fork (IMPORTANT - updates all links!)
+# 3. Auto-configure your fork
-bash docs/contribution/setup-fork.sh --full
+bash docs/contribution/setup-fork.sh
 
 # 4. Create a feature branch
 git checkout -b feature/my-awesome-app
@@ -41,73 +39,19 @@ cat docs/ct/DETAILED_GUIDE.md   # For container scripts
 cat docs/install/DETAILED_GUIDE.md  # For install scripts
 
 # 6. Create your contribution
-cp docs/contribution/templates_ct/AppName.sh ct/myapp.sh
+cp ct/example.sh ct/myapp.sh
-cp docs/contribution/templates_install/AppName-install.sh install/myapp-install.sh
+cp install/example-install.sh install/myapp-install.sh
 # ... edit files ...
 
-# 7. Push to your fork and test via GitHub
+# 7. Test and commit
-git push origin feature/my-awesome-app
+bash ct/myapp.sh
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
+git add ct/myapp.sh install/myapp-install.sh
-# ⏱️ GitHub may take 10-30 seconds to update files - be patient!
+git commit -m "feat: add MyApp"
-
-# 8. Create your JSON metadata file
-cp docs/contribution/templates_json/AppName.json frontend/public/json/myapp.json
-# Edit metadata: name, slug, categories, description, resources, etc.
-
-# 9. No direct install-script test
-# Install scripts are executed by the CT script inside the container
-
-# 10. Commit ONLY your new files (see Cherry-Pick section below!)
-git add ct/myapp.sh install/myapp-install.sh frontend/public/json/myapp.json
-git commit -m "feat: add MyApp container and install scripts"
 git push origin feature/my-awesome-app
 
-# 11. Create Pull Request on GitHub
+# 8. Create Pull Request on GitHub
 ```
 
-⚠️ **IMPORTANT: After setup-fork.sh, many files are modified!**
-
-See the **Cherry-Pick: Submitting Only Your Changes** section below to learn how to push ONLY your 3-4 files instead of 600+ modified files!
-
-### How Users Run Scripts (After Merged)
-
-Once your script is merged to the main repository, users download and run it from GitHub like this:
-
-```bash
-# ✅ Users run from GitHub (normal usage after PR merged)
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/myapp.sh)"
-
-# Install scripts are called by the CT script and are not run directly by users
-```
-
-### Development vs. Production Execution
-
-**During Development (you, in your fork):**
-
-```bash
-# You MUST test via curl from your GitHub fork (not local files!)
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
-
-# The script's curl commands are updated by setup-fork.sh to point to YOUR fork
-# This ensures you're testing your actual changes
-# ⏱️ Wait 10-30 seconds after pushing - GitHub updates slowly
-```
-
-**After Merge (users, from GitHub):**
-
-```bash
-# Users download the script from upstream via curl
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/myapp.sh)"
-
-# The script's curl commands now point back to upstream (community-scripts)
-# This is the stable, tested version
-```
-
-**Summary:**
-
-- **Development**: Push to fork, test via curl → setup-fork.sh changes curl URLs to your fork
-- **Production**: curl | bash from upstream → curl URLs point to community-scripts repo
-
 ---
 
 ## 🍴 Setting Up Your Fork
@@ -117,35 +61,14 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/Proxmo
 When you clone your fork, run the setup script to automatically configure everything:
 
 ```bash
-bash docs/contribution/setup-fork.sh --full
+bash docs/contribution/setup-fork.sh
 ```
 
-**What it does:**
+This will:
 
-- Auto-detects your GitHub username from git config
+- Auto-detect your GitHub username
-- Auto-detects your fork repository name
+- Update all documentation links to point to your fork
-- Updates **ALL** hardcoded links to point to your fork instead of the main repo (`--full`)
+- Create `.git-setup-info` with recommended git workflows
-- Creates `.git-setup-info` with your configuration
-- Allows you to develop and test independently in your fork
-
-**Why this matters:**
-
-Without running this script, all links in your fork will still point to the upstream repository (community-scripts). This is a problem when testing because:
-
-- Installation links will pull from upstream, not your fork
-- Updates will target the wrong repository
-- Your contributions won't be properly tested
-
-**After running setup-fork.sh:**
-
-Your fork is fully configured and ready to develop. You can:
-
-- Push changes to your fork
-- Test via curl: `bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"`
-- All links will reference your fork for development
-- ⏱️ Wait 10-30 seconds after pushing - GitHub takes time to update
-- Commit and push with confidence
-- Create a PR to merge into upstream
 
 **See**: [FORK_SETUP.md](FORK_SETUP.md) for detailed instructions
 
@@ -158,12 +81,11 @@ If the script doesn't work, manually configure:
 git config user.name "Your Name"
 git config user.email "your.email@example.com"
 
-# Add upstream remote for syncing with main repo
+# Add upstream remote for syncing
 git remote add upstream https://github.com/community-scripts/ProxmoxVE.git
 
 # Verify remotes
 git remote -v
-# Should show: origin (your fork) and upstream (main repo)
 ```
 
 ---
@@ -180,7 +102,7 @@ All scripts and configurations must follow our coding standards to ensure consis
 - **[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** - `frontend/public/json/` structure and format
+- **JSON Configurations** - `/json/` structure and format
 
 ### Quick Checklist
 
@@ -190,7 +112,7 @@ All scripts and configurations must follow our coding standards to ensure consis
 - ✅ Include proper shebang: `#!/usr/bin/env bash`
 - ✅ Add copyright header with author
 - ✅ Handle errors properly with `msg_error`, `msg_ok`, etc.
-- ✅ Test before submitting PR (via curl from your fork, not local bash)
+- ✅ Test before submitting PR
 - ✅ Update documentation if needed
 
 ---
@@ -211,172 +133,7 @@ Key points:
 
 ---
 
-## 🍒 Cherry-Pick: Submitting Only Your Changes
+## 📚 Guides & Resources
-
-**Problem**: `setup-fork.sh` modifies 600+ files to update links. You don't want to submit all of those changes - only your new 3-4 files!
-
-**Solution**: Use git cherry-pick to select only YOUR files.
-
-### Step-by-Step Cherry-Pick Guide
-
-#### 1. Check what changed
-
-```bash
-# See all modified files
-git status
-
-# Verify your files are there
-git status | grep -E "ct/myapp|install/myapp|json/myapp"
-```
-
-#### 2. Create a clean feature branch for submission
-
-```bash
-# Go back to upstream main (clean slate)
-git fetch upstream
-git checkout -b submit/myapp upstream/main
-
-# Don't use your modified main branch!
-```
-
-#### 3. Cherry-pick ONLY your files
-
-Cherry-picking extracts specific changes from commits:
-
-```bash
-# Option A: Cherry-pick commits that added your files
-# (if you committed your files separately)
-git cherry-pick <commit-hash-of-your-files>
-
-# Option B: Manually copy and commit only your files
-# From your work branch, get the file contents
-git show feature/my-awesome-app:ct/myapp.sh > /tmp/myapp.sh
-git show feature/my-awesome-app:install/myapp-install.sh > /tmp/myapp-install.sh
-git show feature/my-awesome-app:frontend/public/json/myapp.json > /tmp/myapp.json
-
-# Add them to the clean branch
-cp /tmp/myapp.sh ct/myapp.sh
-cp /tmp/myapp-install.sh install/myapp-install.sh
-cp /tmp/myapp.json frontend/public/json/myapp.json
-
-# Commit
-git add ct/myapp.sh install/myapp-install.sh frontend/public/json/myapp.json
-git commit -m "feat: add MyApp"
-```
-
-#### 4. Verify only your files are in the PR
-
-```bash
-# Check git diff against upstream
-git diff upstream/main --name-only
-# Should show ONLY:
-#   ct/myapp.sh
-#   install/myapp-install.sh
-#   frontend/public/json/myapp.json
-```
-
-#### 5. Push and create PR
-
-```bash
-# Push your clean submission branch
-git push origin submit/myapp
-
-# Create PR on GitHub from: submit/myapp → main
-```
-
-### Why This Matters
-
-- ✅ Clean PR with only your changes
-- ✅ Easier for maintainers to review
-- ✅ Faster merge without conflicts
-- ❌ Without cherry-pick: PR has 600+ file changes (won't merge!)
-
-### If You Made a Mistake
-
-```bash
-# Delete the messy branch
-git branch -D submit/myapp
-
-# Go back to clean branch
-git checkout -b submit/myapp upstream/main
-
-# Try cherry-picking again
-```
-
----
-
-If you're using **Visual Studio Code** with an AI assistant, you can leverage our detailed guidelines to generate high-quality contributions automatically.
-
-### How to Use AI Assistance
-
-1. **Open the AI Guidelines**
-
-   ```
-   docs/contribution/AI.md
-   ```
-
-   This file contains all requirements, patterns, and examples for writing proper scripts.
-
-2. **Prepare Your Information**
-
-   Before asking the AI to generate code, gather:
-   - **Repository URL**: e.g., `https://github.com/owner/myapp`
-   - **Dockerfile/Script**: Paste the app's installation instructions (if available)
-   - **Dependencies**: What packages does it need? (Node, Python, Java, PostgreSQL, etc.)
-   - **Ports**: What port does it listen on? (e.g., 3000, 8080, 5000)
-   - **Configuration**: Any environment variables or config files?
-
-3. **Tell the AI Assistant**
-
-   Share with the AI:
-   - The repository URL
-   - The Dockerfile or install instructions
-   - Link to [docs/contribution/AI.md](AI.md) with instructions to follow
-
-   **Example prompt:**
-
-   ```
-   I want to contribute a container script for MyApp to ProxmoxVE.
-   Repository: https://github.com/owner/myapp
-
-   Here's the Dockerfile:
-   [paste Dockerfile content]
-
-   Please follow the guidelines in docs/contribution/AI.md to create:
-   1. ct/myapp.sh (container script)
-   2. install/myapp-install.sh (installation script)
-   3. frontend/public/json/myapp.json (metadata)
-   ```
-
-4. **AI Will Generate**
-
-   The AI will produce scripts that:
-   - Follow all ProxmoxVE patterns and conventions
-   - Use helper functions from `tools.func` correctly
-   - Include proper error handling and messages
-   - Have correct update mechanisms
-   - Are ready to submit as a PR
-
-### Key Points for AI Assistants
-
-- **Templates Location**: `docs/contribution/templates_ct/AppName.sh`, `templates_install/`, `templates_json/`
-- **Guidelines**: Must follow `docs/contribution/AI.md` exactly
-- **Helper Functions**: Use only functions from `misc/tools.func` - never write custom ones
-- **Testing**: Always test before submission via curl from your fork
-  ```bash
-  bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
-  # Wait 10-30 seconds after pushing changes
-  ```
-- **No Docker**: Container scripts must be bare-metal, not Docker-based
-
-### Benefits
-
-- **Speed**: AI generates boilerplate in seconds
-- **Consistency**: Follows same patterns as 200+ existing scripts
-- **Quality**: Less bugs and more maintainable code
-- **Learning**: See how your app should be structured
-
----
 
 ### Documentation
 
@@ -464,15 +221,15 @@ git push origin feature/my-feature
    git rebase upstream/main
    ```
 
-2. **Test your changes** (via curl from your fork)
+2. **Test your changes**
 
    ```bash
-   bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/my-app.sh)"
+   bash ct/my-app.sh
    # Follow prompts and test the container
-   # ⏱️ Wait 10-30 seconds after pushing - GitHub takes time to update
    ```
 
 3. **Check code standards**
+
    - [ ] Follows template structure
    - [ ] Proper error handling
    - [ ] Documentation updated (if needed)
@@ -503,66 +260,23 @@ Before opening a PR:
 
 ## ❓ FAQ
 
-### ❌ Why can't I test with `bash ct/myapp.sh` locally?
+### How do I test my changes?
-
-You might try:
 
 ```bash
-# ❌ WRONG - This won't test your actual changes!
+# For container scripts
-bash ct/myapp.sh
+bash ct/my-app.sh
-./ct/myapp.sh
+
-sh ct/myapp.sh
+# For install scripts (runs inside container)
+# The ct script will call it automatically
+
+# For advanced debugging
+VERBOSE=yes bash ct/my-app.sh
 ```
 
-**Why this fails:**
-
-- `bash ct/myapp.sh` uses the LOCAL clone file
-- The LOCAL file doesn't execute the curl commands - it's already on disk
-- The curl URLs INSIDE the script are modified by setup-fork.sh, but they're not executed
-- So you can't verify if your curl URLs actually work
-- Users will get the curl URL version (which may be broken)
-
-**Solution:** Always test via curl from GitHub:
-
-```bash
-# ✅ CORRECT - Tests the actual GitHub URLs
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/myapp.sh)"
-```
-
-### ❓ How do I test my changes?
-
-You **cannot** test locally with `bash ct/myapp.sh` from your cloned directory!
-
-You **must** push to GitHub and test via curl from your fork:
-
-```bash
-# 1. Push your changes to your fork
-git push origin feature/my-awesome-app
-
-# 2. Test via curl (this loads the script from GitHub, not local files)
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/my-app.sh)"
-
-# 3. For verbose/debug output, pass environment variables
-VERBOSE=yes bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/my-app.sh)"
-DEV_MODE_LOGS=true bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/my-app.sh)"
-```
-
-**Why?**
-
-- Local `bash ct/myapp.sh` uses local files from your clone
-- But the script's INTERNAL curl commands have been modified by setup-fork.sh to point to your fork
-- This discrepancy means you're not actually testing the curl URLs
-- Testing via curl ensures the script downloads from YOUR fork GitHub URLs
-- ⏱️ **Important:** GitHub takes 10-30 seconds to recognize newly pushed files. Wait before testing!
-
-**What if local bash worked?**
-
-You'd be testing local files only, not the actual GitHub URLs that users will download. This means broken curl links wouldn't be caught during testing.
-
 ### What if my PR has conflicts?
 
 ```bash
-# Sync with upstream main repository
+# Sync with upstream
 git fetch upstream
 git rebase upstream/main
 
@@ -574,27 +288,17 @@ git push -f origin your-branch
 
 ### How do I keep my fork updated?
 
-Two ways:
+See "Keep Your Fork Updated" section above, or run:
-
-**Option 1: Run setup script again**
 
 ```bash
-bash docs/contribution/setup-fork.sh --full
+bash docs/contribution/setup-fork.sh
-```
-
-**Option 2: Manual sync**
-
-```bash
-git fetch upstream
-git rebase upstream/main
-git push -f origin main
 ```
 
 ### Where do I ask questions?
 
 - **GitHub Issues**: For bugs and feature requests
-- **GitHub Discussions**: For general questions and ideas
+- **GitHub Discussions**: For general questions
-- **Discord**: Community-scripts server for real-time chat
+- **Discord**: Community-scripts server
 
 ---
 
@@ -603,7 +307,7 @@ git push -f origin main
 ### For First-Time Contributors
 
 1. Read: [docs/README.md](../README.md) - Documentation overview
-2. Read: [CONTRIBUTING.md](CONTRIBUTING.md) - Essential coding standards
+2. Read: [docs/contribution/FORK_SETUP.md](FORK_SETUP.md) - Fork setup guide
 3. Choose your path:
    - Containers → [docs/ct/DETAILED_GUIDE.md](../ct/DETAILED_GUIDE.md)
    - Installation → [docs/install/DETAILED_GUIDE.md](../install/DETAILED_GUIDE.md)
@@ -614,24 +318,21 @@ git push -f origin main
 
 1. Review [CONTRIBUTING.md](CONTRIBUTING.md) - Coding standards
 2. Review [CODE_AUDIT.md](CODE_AUDIT.md) - Audit checklist
-3. Check templates in `/docs/contribution/templates_*/`
+3. Check templates in `/ct/` and `/install/`
-4. Use AI assistants with [AI.md](AI.md) for code generation
+4. Submit PR with confidence
-5. Submit PR with confidence
 
-### For Using AI Assistants
+### For Reviewers/Maintainers
 
-See "Using AI Assistants" section above for:
+1. Use [CODE_AUDIT.md](CODE_AUDIT.md) as review guide
-
+2. Reference [docs/TECHNICAL_REFERENCE.md](../TECHNICAL_REFERENCE.md) for architecture
-- How to structure prompts
+3. Check [docs/EXIT_CODES.md](../EXIT_CODES.md) for error handling
-- What information to provide
-- How to validate AI output
 
 ---
 
 ## 🚀 Ready to Contribute?
 
 1. **Fork** the repository
-2. **Clone** your fork and **setup** with `bash docs/contribution/setup-fork.sh --full`
+2. **Clone** your fork and **setup** with `bash docs/contribution/setup-fork.sh`
 3. **Choose** your contribution type (container, installation, tools, etc.)
 4. **Read** the appropriate detailed guide
 5. **Create** your feature branch
@@ -644,9 +345,9 @@ See "Using AI Assistants" section above for:
 
 ## 📞 Contact & Support
 
-- **GitHub**: [community-scripts/ProxmoxVE](https://github.com/community-scripts/ProxmoxVE)
+- **GitHub**: https://github.com/community-scripts/ProxmoxVE
-- **Issues**: [GitHub Issues](https://github.com/community-scripts/ProxmoxVE/issues)
+- **Issues**: https://github.com/community-scripts/ProxmoxVE/issues
-- **Discussions**: [GitHub Discussions](https://github.com/community-scripts/ProxmoxVE/discussions)
+- **Discussions**: https://github.com/community-scripts/ProxmoxVE/discussions
 - **Discord**: [Join Server](https://discord.gg/UHrpNWGwkH)
 
 ---

docs/contribution/setup-fork.sh

@@ -8,15 +8,13 @@
 # Updates all hardcoded links to point to your fork
 #
 # Usage:
-#   ./setup-fork.sh                    # Auto-detect from git config (updates misc/ only)
+#   ./setup-fork.sh                    # Auto-detect from git config
-#   ./setup-fork.sh YOUR_USERNAME      # Specify username (updates misc/ only)
+#   ./setup-fork.sh YOUR_USERNAME      # Specify username
-#   ./setup-fork.sh YOUR_USERNAME REPO_NAME  # Specify both (updates misc/ only)
+#   ./setup-fork.sh YOUR_USERNAME REPO_NAME  # Specify both
-#   ./setup-fork.sh --full             # Update all files including ct/, install/, vm/, etc.
 #
 # Examples:
-#   ./setup-fork.sh john               # Uses john/ProxmoxVE, updates misc/ only
+#   ./setup-fork.sh john               # Uses john/ProxmoxVE
-#   ./setup-fork.sh john my-fork       # Uses john/my-fork, updates misc/ only
+#   ./setup-fork.sh john my-fork       # Uses john/my-fork
-#   ./setup-fork.sh --full             # Auto-detect + update all files
 ################################################################################
 
 set -e
@@ -32,136 +30,131 @@ NC='\033[0m' # No Color
 REPO_NAME="ProxmoxVE"
 USERNAME=""
 AUTO_DETECT=true
-UPDATE_ALL=false
 
 ################################################################################
 # FUNCTIONS
 ################################################################################
 
 print_header() {
-  echo -e "\n${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
+    echo -e "\n${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
-  echo -e "${BLUE}║${NC} ProxmoxVE Fork Setup Script"
+    echo -e "${BLUE}║${NC} ProxmoxVE Fork Setup Script"
-  echo -e "${BLUE}║${NC} Configuring for your fork..."
+    echo -e "${BLUE}║${NC} Configuring for your fork..."
-  echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}\n"
+    echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}\n"
 }
 
 print_info() {
-  echo -e "${BLUE}ℹ${NC}  $1"
+    echo -e "${BLUE}ℹ${NC}  $1"
 }
 
 print_success() {
-  echo -e "${GREEN}✓${NC}  $1"
+    echo -e "${GREEN}✓${NC}  $1"
 }
 
 print_warning() {
-  echo -e "${YELLOW}⚠${NC}  $1"
+    echo -e "${YELLOW}⚠${NC}  $1"
 }
 
 print_error() {
-  echo -e "${RED}✗${NC}  $1"
+    echo -e "${RED}✗${NC}  $1"
 }
 
 # Detect username from git remote
 detect_username() {
-  local remote_url
+    local remote_url
 
-  # Try to get from origin
+    # Try to get from origin
-  if ! remote_url=$(git config --get remote.origin.url 2>/dev/null); then
+    if ! remote_url=$(git config --get remote.origin.url 2>/dev/null); then
-    return 1
+        return 1
-  fi
+    fi
 
-  # Extract username from SSH or HTTPS URL
+    # Extract username from SSH or HTTPS URL
-  if [[ $remote_url =~ git@github.com:([^/]+) ]]; then
+    if [[ $remote_url =~ git@github.com:([^/]+) ]]; then
-    echo "${BASH_REMATCH[1]}"
+        echo "${BASH_REMATCH[1]}"
-  elif [[ $remote_url =~ github.com/([^/]+) ]]; then
+    elif [[ $remote_url =~ github.com/([^/]+) ]]; then
-    echo "${BASH_REMATCH[1]}"
+        echo "${BASH_REMATCH[1]}"
-  else
+    else
-    return 1
+        return 1
-  fi
+    fi
 }
 
 # Detect repo name from git remote
 detect_repo_name() {
-  local remote_url
+    local remote_url
 
-  if ! remote_url=$(git config --get remote.origin.url 2>/dev/null); then
+    if ! remote_url=$(git config --get remote.origin.url 2>/dev/null); then
-    return 1
+        return 1
-  fi
+    fi
 
-  # Extract repo name (remove .git if present)
+    # Extract repo name (remove .git if present)
-  if [[ $remote_url =~ /([^/]+?)(.git)?$ ]]; then
+    if [[ $remote_url =~ /([^/]+?)(.git)?$ ]]; then
-    local repo="${BASH_REMATCH[1]}"
+        local repo="${BASH_REMATCH[1]}"
-    echo "${repo%.git}"
+        echo "${repo%.git}"
-  else
+    else
-    return 1
+        return 1
-  fi
+    fi
 }
 
 # Ask user for confirmation
 confirm() {
-  local prompt="$1"
+    local prompt="$1"
-  local response
+    local response
 
-  echo -ne "${YELLOW}${prompt} (y/n)${NC} "
+    read -p "$(echo -e ${YELLOW})$prompt (y/n)${NC} " -r response
-  read -r response
+    [[ $response =~ ^[Yy]$ ]]
-  [[ $response =~ ^[Yy]$ ]]
 }
 
 # Update links in files
 update_links() {
-  local old_repo="community-scripts"
+    local old_repo="community-scripts"
-  local old_name="ProxmoxVE"
+    local old_name="ProxmoxVE"
-  local new_owner="$1"
+    local new_owner="$1"
-  local new_repo="$2"
+    local new_repo="$2"
-  local files_updated=0
+    local files_updated=0
 
-  print_info "Scanning for hardcoded links..."
+    print_info "Scanning for hardcoded links..."
 
-  # Change to repo root
+    # Find all markdown and shell files
-  local repo_root=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+    local -a files_to_update=(
+        "docs/DEFAULTS_SYSTEM_GUIDE.md"
+        "docs/alpine-install.func.md"
+        "docs/install.func.md"
+        "docs/APP-install.md"
+        "docs/APP-ct.md"
+        "docs/CONTRIBUTION_GUIDE.md"
+        "docs/INDEX.md"
+        "docs/README.md"
+        "docs/EXIT_CODES.md"
+        "docs/api/README.md"
+    )
 
-  # Determine search path
+    echo ""
-  local search_path="$repo_root/misc"
-  if [[ "$UPDATE_ALL" == "true" ]]; then
-    search_path="$repo_root"
-    print_info "Searching all files (--full mode)"
-  else
-    print_info "Searching misc/ directory only (core functions)"
-  fi
 
-  echo ""
+    for file in "${files_to_update[@]}"; do
+        if [[ -f "$file" ]]; then
+            # Count occurrences
+            local count=$(grep -c "github.com/$old_repo/$old_name" "$file" 2>/dev/null || echo 0)
 
-  # Find all files containing the old repo reference
+            if [[ $count -gt 0 ]]; then
-  while IFS= read -r file; do
+                # Backup original
-    # Count occurrences
+                cp "$file" "$file.backup"
-    local count=$(grep -c "github.com/$old_repo/$old_name" "$file" 2>/dev/null || echo 0)
 
-    if [[ $count -gt 0 ]]; then
+                # Replace links
-      # Backup original
+                sed -i "s|github.com/$old_repo/$old_name|github.com/$new_owner/$new_repo|g" "$file"
-      cp "$file" "$file.backup"
 
-      # Replace links - use different sed syntax for BSD/macOS vs GNU sed
+                ((files_updated++))
-      if sed --version &>/dev/null 2>&1; then
+                print_success "Updated $file ($count links)"
-        # GNU sed
+            fi
-        sed -i "s|github.com/$old_repo/$old_name|github.com/$new_owner/$new_repo|g" "$file"
+        fi
-      else
+    done
-        # BSD sed (macOS)
-        sed -i '' "s|github.com/$old_repo/$old_name|github.com/$new_owner/$new_repo|g" "$file"
-      fi
 
-      ((files_updated++))
+    return $files_updated
-      print_success "Updated $file ($count links)"
-    fi
-  done < <(find "$search_path" -type f \( -name "*.md" -o -name "*.sh" -o -name "*.func" -o -name "*.json" \) -not -path "*/.git/*" 2>/dev/null | xargs grep -l "github.com/$old_repo/$old_name" 2>/dev/null)
-
-  return $files_updated
 }
 
 # Create user git config setup info
 create_git_setup_info() {
-  local username="$1"
+    local username="$1"
 
-  cat >.git-setup-info <<'EOF'
+    cat >.git-setup-info <<'EOF'
 # Git Configuration for ProxmoxVE Development
 
 ## Recommended Git Configuration
@@ -220,10 +213,10 @@ git merge upstream/main
 
 ---
 
-For more help, see: docs/contribution/README.md
+For more help, see: docs/CONTRIBUTION_GUIDE.md
 EOF
 
-  print_success "Created .git-setup-info file"
+    print_success "Created .git-setup-info file"
 }
 
 ################################################################################
@@ -234,79 +227,65 @@ print_header
 
 # Parse command line arguments
 if [[ $# -gt 0 ]]; then
-  # Check for --full flag
-  if [[ "$1" == "--full" ]]; then
-    UPDATE_ALL=true
-    AUTO_DETECT=true
-    shift # Remove --full from arguments
-  fi
-
-  # Process remaining arguments
-  if [[ $# -gt 0 ]]; then
     USERNAME="$1"
     AUTO_DETECT=false
 
     if [[ $# -gt 1 ]]; then
-      REPO_NAME="$2"
+        REPO_NAME="$2"
     fi
-  fi
 else
-  # Try auto-detection
+    # Try auto-detection
-  if username=$(detect_username); then
+    if username=$(detect_username); then
-    USERNAME="$username"
+        USERNAME="$username"
-    print_success "Detected GitHub username: $USERNAME"
+        print_success "Detected GitHub username: $USERNAME"
-  else
-    print_error "Could not auto-detect GitHub username from git config"
-    echo -e "${YELLOW}Please run:${NC}"
-    echo "  ./setup-fork.sh YOUR_USERNAME"
-    exit 1
-  fi
-
-  if repo_name=$(detect_repo_name); then
-    REPO_NAME="$repo_name"
-    if [[ "$REPO_NAME" != "ProxmoxVE" ]]; then
-      print_info "Detected custom repo name: $REPO_NAME"
     else
-      print_success "Using default repo name: ProxmoxVE"
+        print_error "Could not auto-detect GitHub username from git config"
+        echo -e "${YELLOW}Please run:${NC}"
+        echo "  ./setup-fork.sh YOUR_USERNAME"
+        exit 1
+    fi
+
+    if repo_name=$(detect_repo_name); then
+        REPO_NAME="$repo_name"
+        if [[ "$REPO_NAME" != "ProxmoxVE" ]]; then
+            print_info "Detected custom repo name: $REPO_NAME"
+        else
+            print_success "Using default repo name: ProxmoxVE"
+        fi
     fi
-  fi
 fi
 
 # Validate inputs
 if [[ -z "$USERNAME" ]]; then
-  print_error "Username cannot be empty"
+    print_error "Username cannot be empty"
-  exit 1
+    exit 1
 fi
 
 if [[ -z "$REPO_NAME" ]]; then
-  print_error "Repository name cannot be empty"
+    print_error "Repository name cannot be empty"
-  exit 1
+    exit 1
 fi
 
 # Show what we'll do
 echo -e "${BLUE}Configuration Summary:${NC}"
 echo "  Repository URL: https://github.com/$USERNAME/$REPO_NAME"
-if [[ "$UPDATE_ALL" == "true" ]]; then
+echo "  Files to update: 10 files with documentation"
-  echo "  Files to update: ALL files (ct/, install/, vm/, misc/, docs/, etc.)"
-else
-  echo "  Files to update: misc/ directory only (core functions)"
-fi
 echo ""
 
 # Ask for confirmation
 if ! confirm "Apply these changes?"; then
-  print_warning "Setup cancelled"
+    print_warning "Setup cancelled"
-  exit 0
+    exit 0
 fi
 
 echo ""
 
 # Update all links
 if update_links "$USERNAME" "$REPO_NAME"; then
-  links_changed=$?
+    links_changed=$?
-  print_success "Updated $links_changed files"
+    print_success "Updated $links_changed files"
 else
-  print_warning "No links needed updating or some files not found"
+    print_warning "No links needed updating or some files not found"
 fi
 
 # Create git setup info file
@@ -328,7 +307,7 @@ echo -e "${BLUE}Next Steps:${NC}"
 echo "  1. Review the changes: git diff"
 echo "  2. Check .git-setup-info for recommended git workflow"
 echo "  3. Start developing: git checkout -b feature/my-app"
-echo "  4. Read: docs/contribution/README.md"
+echo "  4. Read: docs/CONTRIBUTION_GUIDE.md"
 echo ""
 
 print_success "Happy contributing! 🚀"

docs/contribution/templates_ct/AppName.md

@@ -1,189 +1,197 @@
-# CT Container Scripts - Quick Reference
+# **AppName<span></span>.sh Scripts**
 
-> [!WARNING]
+ `AppName.sh` scripts found in the `/ct` directory. These scripts are responsible for the installation of the desired application. For this guide we take `/ct/snipeit.sh` as example.
-> **This is legacy documentation.** Refer to the **modern template** at [templates_ct/AppName.sh](AppName.sh) for best practices.
->
-> Current templates use:
->
-> - `tools.func` helpers instead of manual patterns
-> - `check_for_gh_release` and `fetch_and_deploy_gh_release` from build.func
-> - Automatic setup-fork.sh configuration
 
----
+## Table of Contents
 
-## Before Creating a Script
+- [**AppName.sh Scripts**](#appnamesh-scripts)
+  - [Table of Contents](#table-of-contents)
+  - [1. **File Header**](#1-file-header)
+    - [1.1 **Shebang**](#11-shebang)
+    - [1.2 **Import Functions**](#12-import-functions)
+    - [1.3 **Metadata**](#13-metadata)
+  - [2 **Variables and function import**](#2-variables-and-function-import)
+    - [2.1 **Default Values**](#21-default-values)
+  - [2.2 **📋 App output \& base settings**](#22--app-output--base-settings)
+  - [2.3 **🛠 Core functions**](#23--core-functions)
+  - [3 **Update function**](#3-update-function)
+    - [3.1 **Function Header**](#31-function-header)
+    - [3.2 **Check APP**](#32-check-app)
+    - [3.3 **Check version**](#33-check-version)
+    - [3.4 **Verbosity**](#34-verbosity)
+    - [3.5 **Backups**](#35-backups)
+    - [3.6 **Cleanup**](#36-cleanup)
+    - [3.7 **No update function**](#37-no-update-function)
+  - [4 **End of the script**](#4-end-of-the-script)
+  - [5. **Contribution checklist**](#5-contribution-checklist)
 
-1. **Fork & Clone:**
+## 1. **File Header**
 
-   ```bash
+### 1.1 **Shebang**
-   git clone https://github.com/YOUR_USERNAME/ProxmoxVE.git
-   cd ProxmoxVE
-   ```
 
-2. **Run setup-fork.sh** (updates all curl URLs to your fork):
+- Use `#!/usr/bin/env bash` as the shebang.
-
-   ```bash
-   bash docs/contribution/setup-fork.sh
-   ```
-
-3. **Copy the Modern Template:**
-
-   ```bash
-   cp templates_ct/AppName.sh ct/MyApp.sh
-   # Edit ct/MyApp.sh with your app details
-   ```
-
-4. **Test Your Script (via GitHub):**
-
-   ⚠️ **Important:** You must push to GitHub and test via curl, not `bash ct/MyApp.sh`!
-
-   ```bash
-   # Push your changes to your fork first
-   git push origin feature/my-awesome-app
-
-   # Then test via curl (this loads from YOUR fork, not local files)
-   bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/MyApp.sh)"
-   ```
-
-   > 💡 **Why?** The script's curl commands are modified by setup-fork.sh, but local execution uses local files, not the updated GitHub URLs. Testing via curl ensures your script actually works.
-   >
-   > ⏱️ **Note:** GitHub sometimes takes 10-30 seconds to update files. If you don't see your changes, wait and try again.
-
-5. **Cherry-Pick for PR** (submit ONLY your 3-4 files):
-   - See [Cherry-Pick Guide](../README.md) for step-by-step git commands
-
----
-
-## Template Structure
-
-The modern template includes:
-
-### Header
 
 ```bash
 #!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
-# (Note: setup-fork.sh changes this URL to point to YOUR fork during development)
 ```
 
-### Metadata
+### 1.2 **Import Functions**
+
+- Import the build.func file.
+- When developing your own script, change the URL to your own repository.
+
+> [!IMPORTANT]
+> You also need to change all apperances of this URL in `misc/build.func` and `misc/install.func`
+
+Example for development:
+
+```bash
+source <(curl -fsSL https://raw.githubusercontent.com/[USER]/[REPO]/refs/heads/[BRANCH]/misc/build.func)
+```
+
+Final script:
+
+```bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+```
+
+> [!CAUTION]
+> Before opening a Pull Request, change the URLs to point to the community-scripts repo.
+
+### 1.3 **Metadata**
+
+- Add clear comments for script metadata, including author, copyright, and license information.
+
+Example:
 
 ```bash
 # Copyright (c) 2021-2026 community-scripts ORG
-# Author: YourUsername
+# Author: [YourUserName]
-# License: MIT
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-APP="MyApp"
+# Source: [SOURCE_URL]
-var_tags="app-category;foss"
+```
+
+> [!NOTE]:
+>
+> - Add your username and source URL
+> - For existing scripts, add "| Co-Author [YourUserName]" after the current author
+
+---
+
+## 2 **Variables and function import**
+>
+> [!NOTE]
+> You need to have all this set in your script, otherwise it will not work!
+
+### 2.1 **Default Values**
+
+- This section sets the default values for the container.
+- `APP` needs to be set to the application name and must be equal to the filenames of your scripts.
+- `var_tags`: You can set Tags for the CT wich show up in the Proxmox UI. Don´t overdo it!
+
+>[!NOTE]
+>Description for all Default Values
+>
+>| Variable | Description | Notes |
+>|----------|-------------|-------|
+>| `APP` | Application name | Must match ct\AppName.sh |
+>| `var_tags` | Proxmox display tags without Spaces, only ; | Limit the number |
+>| `var_cpu` | CPU cores | Number of cores |
+>| `var_ram` | RAM | In MB |
+>| `var_disk` | Disk capacity | In GB |
+>| `var_os` | Operating system | alpine, debian, ubuntu |
+>| `var_version` | OS version | e.g., 3.20, 11, 12, 20.04 |
+>| `var_unprivileged` | Container type | 1 = Unprivileged, 0 = Privileged |
+
+Example:
+
+```bash
+APP="SnipeIT"
+var_tags="asset-management;foss"
 var_cpu="2"
 var_ram="2048"
 var_disk="4"
-var_os="alpine"
+var_os="debian"
-var_version="3.20"
+var_version="12"
 var_unprivileged="1"
 ```
 
-### Core Setup
+## 2.2 **📋 App output & base settings**
 
 ```bash
 header_info "$APP"
+```
+- `header_info`: Generates ASCII header for APP
+
+## 2.3 **🛠 Core functions**
+
+```bash
 variables
 color
 catch_errors
 ```
 
-### Update Function
+- `variables`: Processes input and prepares variables
+- `color`: Sets icons, colors, and formatting
+- `catch_errors`: Enables error handling
 
-The modern template provides a standard update pattern:
+---
+
+## 3 **Update function**
+
+### 3.1 **Function Header**
+
+- If applicable write a function that updates the application and the OS in the container.
+- Each update function starts with the same code:
 
 ```bash
 function update_script() {
   header_info
   check_container_storage
   check_container_resources
+```
 
-  # Use tools.func helpers:
+### 3.2 **Check APP**
-  check_for_gh_release "myapp" "owner/repo"
+
-  fetch_and_deploy_gh_release "myapp" "owner/repo" "tarball" "latest" "/opt/myapp"
+- Before doing anything update-wise, check if the app is installed in the container.
+
+Example:
+
+```bash
+if [[ ! -d /opt/snipe-it ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+```
+
+### 3.3 **Check version**
+
+- Before updating, check if a new version exists.
+  - We use the `${APPLICATION}_version.txt` file created in `/opt` during the install to compare new versions against the currently installed version.
+
+Example with a Github Release:
+
+```bash
+ RELEASE=$(curl -fsSL https://api.github.com/repos/snipe/snipe-it/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4) }')
+  if [[ ! -f /opt/${APP}_version.txt ]] || [[ "${RELEASE}" != "$(cat /opt/${APP}_version.txt)" ]]; then
+    msg_info "Updating ${APP} to v${RELEASE}"
+    #DO UPDATE
+  else
+    msg_ok "No update required. ${APP} is already at v${RELEASE}."
+  fi
+  exit
 }
 ```
 
----
-
-## Key Patterns
-
-### Check for Updates (App Repository)
-
-Use `check_for_gh_release` with the **app repo**:
-
-```bash
-check_for_gh_release "myapp" "owner/repo"
-```
-
-### Deploy External App
-
-Use `fetch_and_deploy_gh_release` with the **app repo**:
-
-```bash
-fetch_and_deploy_gh_release "myapp" "owner/repo"
-```
-
-### Avoid Manual Version Checking
-
-❌ OLD (manual):
-
-```bash
-RELEASE=$(curl -fsSL https://api.github.com/repos/myapp/myapp/releases/latest | grep tag_name)
-```
-
-✅ NEW (use tools.func):
-
-```bash
-fetch_and_deploy_gh_release "myapp" "owner/repo"
-```
-
----
-
-## Best Practices
-
-1. **Use tools.func helpers** - Don't manually curl for versions
-2. **Only add app-specific dependencies** - Don't add ca-certificates, curl, gnupg (handled by build.func)
-3. **Test via curl from your fork** - Push first, then: `bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/MyApp.sh)"`
-4. **Wait for GitHub to update** - Takes 10-30 seconds after git push
-5. **Cherry-pick only YOUR files** - Submit only ct/MyApp.sh, install/MyApp-install.sh, frontend/public/json/myapp.json (3 files)
-6. **Verify before PR** - Run `git diff upstream/main --name-only` to confirm only your files changed
-
----
-
-## Common Update Patterns
-
-See the [modern template](AppName.sh) and [AI.md](../AI.md) for complete working examples.
-
-Recent reference scripts with good update functions:
-
-- [Trip](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/trip.sh)
-- [Thingsboard](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/thingsboard.sh)
-- [UniFi](https://github.com/community-scripts/ProxmoxVE/blob/main/ct/unifi.sh)
-
----
-
-## Need Help?
-
-- **[README.md](../README.md)** - Full contribution workflow
-- **[AI.md](../AI.md)** - AI-generated script guidelines
-- **[FORK_SETUP.md](../FORK_SETUP.md)** - Why setup-fork.sh is important
-- **[Slack Community](https://discord.gg/your-link)** - Ask questions
-
-````
-
 ### 3.4 **Verbosity**
 
 - Use the appropriate flag (**-q** in the examples) for a command to suppress its output.
-  Example:
+Example:
 
 ```bash
 curl -fsSL
 unzip -q
-````
+```
 
 - If a command does not come with this functionality use `$STD` to suppress it's output.
 
@@ -199,8 +207,8 @@ $STD php artisan config:clear
 - Backup user data if necessary.
 - Move all user data back in the directory when the update is finished.
 
-> [!NOTE]
+>[!NOTE]
-> This is not meant to be a permanent backup
+>This is not meant to be a permanent backup
 
 Example backup:
 
@@ -219,7 +227,7 @@ Example config restore:
 ### 3.6 **Cleanup**
 
 - Do not forget to remove any temporary files/folders such as zip-files or temporary backups.
-  Example:
+Example:
 
 ```bash
   rm -rf /opt/v${RELEASE}.zip
@@ -269,7 +277,7 @@ echo -e "${TAB}${GATEWAY}${BGN}http://${IP}${CL}"
 ## 5. **Contribution checklist**
 
 - [ ] Shebang is correctly set (`#!/usr/bin/env bash`).
-- [ ] Correct link to _build.func_
+- [ ] Correct link to *build.func*
 - [ ] Metadata (author, license) is included at the top.
 - [ ] Variables follow naming conventions.
 - [ ] Update function exists.

docs/contribution/templates_ct/AppName.sh

@@ -5,133 +5,89 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 # Source: [SOURCE_URL e.g. https://github.com/example/app]
 
-# ============================================================================
+# App Default Values
-# APP CONFIGURATION
-# ============================================================================
-# These values are sent to build.func and define default container resources.
-# Users can customize these during installation via the interactive prompts.
-# ============================================================================
-
 APP="[AppName]"
-var_tags="${var_tags:-[category1];[category2]}" # Max 2 tags, semicolon-separated
+var_tags="${var_tags:-[category]}"
-var_cpu="${var_cpu:-2}"                         # CPU cores: 1-4 typical
+var_cpu="${var_cpu:-2}"
-var_ram="${var_ram:-2048}"                      # RAM in MB: 512, 1024, 2048, etc.
+var_ram="${var_ram:-2048}"
-var_disk="${var_disk:-8}"                       # Disk in GB: 6, 8, 10, 20 typical
+var_disk="${var_disk:-4}"
-var_os="${var_os:-debian}"                      # OS: debian, ubuntu, alpine
+var_os="${var_os:-debian}"
-var_version="${var_version:-13}"                # OS Version: 13 (Debian), 24.04 (Ubuntu), 3.21 (Alpine)
+var_version="${var_version:-12}"
-var_unprivileged="${var_unprivileged:-1}"       # 1=unprivileged (secure), 0=privileged (for Docker/Podman)
+var_unprivileged="${var_unprivileged:-1}"
 
-# ============================================================================
+# =============================================================================
-# INITIALIZATION - These are required in all CT scripts
+# CONFIGURATION GUIDE
-# ============================================================================
+# =============================================================================
-header_info "$APP" # Display app name and setup header
+# APP           - Display name, title case (e.g. "Koel", "Wallabag", "Actual Budget")
-variables          # Initialize build.func variables
+# var_tags      - Max 2 tags, semicolon separated (e.g. "music;streaming", "finance")
-color              # Load color variables for output
+# var_cpu       - CPU cores: 1-4 typical
-catch_errors       # Enable error handling with automatic exit on failure
+# 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"
-# UPDATE SCRIPT - Called when user selects "Update" from web interface
+variables
-# ============================================================================
+color
-# This function is triggered by the web interface to update the application.
+catch_errors
-# It should:
-#   1. Check if installation exists
-#   2. Check for new GitHub releases
-#   3. Stop running services
-#   4. Backup critical data
-#   5. Deploy new version
-#   6. Run post-update commands (migrations, config updates, etc.)
-#   7. Restore data if needed
-#   8. Start services
-#
-# Exit with `exit` at the end to prevent container restart.
-# ============================================================================
 
 function update_script() {
   header_info
   check_container_storage
   check_container_resources
 
-  # Step 1: Verify installation exists
+  # Check if installation exists
   if [[ ! -d /opt/[appname] ]]; then
     msg_error "No ${APP} Installation Found!"
     exit
   fi
 
-  # Step 2: Check if update is available
+  # check_for_gh_release returns 0 (true) if update available, 1 (false) if not
-  if check_for_gh_release "[appname]" "YourUsername/YourRepo"; then
+  if check_for_gh_release "[appname]" "[owner/repo]"; then
-
+    msg_info "Stopping Services"
-    # Step 3: Stop services before update
-    msg_info "Stopping Service"
     systemctl stop [appname]
-    msg_ok "Stopped Service"
+    msg_ok "Stopped Services"
 
-    # Step 4: Backup critical data before overwriting
+    # Optional: Backup important data before update
-    msg_info "Backing up Data"
+    msg_info "Creating Backup"
-    cp -r /opt/[appname]/data /opt/[appname]_data_backup 2>/dev/null || true
+    mkdir -p /tmp/[appname]_backup
-    msg_ok "Backed up Data"
+    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"
 
-    # Step 5: Download and deploy new version
+    # CLEAN_INSTALL=1 removes old directory before extracting new version
-    # CLEAN_INSTALL=1 removes old directory before extracting
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "[appname]" "[owner/repo]" "tarball" "latest" "/opt/[appname]"
-    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "[appname]" "owner/repo" "tarball" "latest" "/opt/[appname]"
 
-    # Step 6: Run post-update commands (uncomment as needed)
+    # Restore configuration and data
-    # These examples show common patterns - use what applies to your app:
-    #
-    # For Node.js apps:
-    # msg_info "Installing Dependencies"
-    # cd /opt/[appname]
-    # $STD npm ci --production
-    # msg_ok "Installed Dependencies"
-    #
-    # For Python apps:
-    # msg_info "Installing Dependencies"
-    # cd /opt/[appname]
-    # $STD uv sync --frozen
-    # msg_ok "Installed Dependencies"
-    #
-    # For database migrations:
-    # msg_info "Running Database Migrations"
-    # cd /opt/[appname]
-    # $STD npm run migrate
-    # msg_ok "Ran Database Migrations"
-    #
-    # For PHP apps:
-    # msg_info "Installing Dependencies"
-    # cd /opt/[appname]
-    # $STD composer install --no-dev
-    # msg_ok "Installed Dependencies"
-
-    # Step 7: Restore data from backup
     msg_info "Restoring Data"
-    cp -r /opt/[appname]_data_backup/. /opt/[appname]/data/ 2>/dev/null || true
+    cp /tmp/[appname]_backup/.env /opt/[appname]/ 2>/dev/null || true
-    rm -rf /opt/[appname]_data_backup
+    cp -r /tmp/[appname]_backup/data/* /opt/[appname]/data/ 2>/dev/null || true
+    rm -rf /tmp/[appname]_backup
     msg_ok "Restored Data"
 
-    # Step 8: Restart service with new version
+    # Optional: Run any post-update commands
-    msg_info "Starting Service"
+    msg_info "Running Post-Update Tasks"
+    cd /opt/[appname] 
+    # Examples:
+    # $STD npm ci --production
+    # $STD php artisan migrate --force
+    # $STD composer install --no-dev
+    msg_ok "Ran Post-Update Tasks"
+
+    msg_info "Starting Services"
     systemctl start [appname]
-    msg_ok "Started Service"
+    msg_ok "Started Services"
+
     msg_ok "Updated successfully!"
   fi
   exit
 }
 
-# ============================================================================
-# MAIN EXECUTION - Container creation flow
-# ============================================================================
-# These are called by build.func and handle the full installation process:
-#   1. start              - Initialize container creation
-#   2. build_container    - Execute the install script inside container
-#   3. description        - Display completion info and access details
-# ============================================================================
-
 start
 build_container
 description
 
-# ============================================================================
-# COMPLETION MESSAGE
-# ============================================================================
 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}"

docs/contribution/templates_install/AppName-install.md

@@ -1,195 +1,54 @@
-# Install Scripts - Quick Reference
 
-> [!WARNING]
+# **AppName<span></span>-install.sh Scripts**
-> **This is legacy documentation.** Refer to the **modern template** at [templates_install/AppName-install.sh](AppName-install.sh) for best practices.
->
-> Current templates use:
->
-> - `tools.func` helpers (setup_nodejs, setup_uv, setup_postgresql_db, etc.)
-> - Automatic dependency installation via build.func
-> - Standardized environment variable patterns
 
----
+ `AppName-install.sh` scripts found in the `/install` directory. These scripts are responsible for the installation of the application. For this guide we take `/install/snipeit-install.sh` as example.
 
-## Before Creating a Script
+## Table of Contents
 
-1. **Copy the Modern Template:**
+- [**AppName-install.sh Scripts**](#appname-installsh-scripts)
+  - [Table of Contents](#table-of-contents)
+  - [1. **File header**](#1-file-header)
+    - [1.1 **Shebang**](#11-shebang)
+    - [1.2 **Comments**](#12-comments)
+    - [1.3 **Variables and function import**](#13-variables-and-function-import)
+  - [2. **Variable naming and management**](#2-variable-naming-and-management)
+    - [2.1 **Naming conventions**](#21-naming-conventions)
+  - [3. **Dependencies**](#3-dependencies)
+    - [3.1 **Install all at once**](#31-install-all-at-once)
+    - [3.2 **Collapse dependencies**](#32-collapse-dependencies)
+  - [4. **Paths to application files**](#4-paths-to-application-files)
+  - [5. **Version management**](#5-version-management)
+    - [5.1 **Install the latest release**](#51-install-the-latest-release)
+    - [5.2 **Save the version for update checks**](#52-save-the-version-for-update-checks)
+  - [6. **Input and output management**](#6-input-and-output-management)
+    - [6.1 **User feedback**](#61-user-feedback)
+    - [6.2 **Verbosity**](#62-verbosity)
+  - [7. **String/File Manipulation**](#7-stringfile-manipulation)
+    - [7.1 **File Manipulation**](#71-file-manipulation)
+  - [8. **Security practices**](#8-security-practices)
+    - [8.1 **Password generation**](#81-password-generation)
+    - [8.2 **File permissions**](#82-file-permissions)
+  - [9. **Service Configuration**](#9-service-configuration)
+    - [9.1 **Configuration files**](#91-configuration-files)
+    - [9.2 **Credential management**](#92-credential-management)
+    - [9.3 **Enviroment files**](#93-enviroment-files)
+    - [9.4 **Services**](#94-services)
+  - [10. **Cleanup**](#10-cleanup)
+    - [10.1 **Remove temporary files**](#101-remove-temporary-files)
+    - [10.2 **Autoremove and autoclean**](#102-autoremove-and-autoclean)
+  - [11. **Best Practices Checklist**](#11-best-practices-checklist)
+    - [Example: High-Level Script Flow](#example-high-level-script-flow)
 
-   ```bash
+## 1. **File header**
-   cp templates_install/AppName-install.sh install/MyApp-install.sh
-   # Edit install/MyApp-install.sh
-   ```
 
-2. **Key Pattern:**
+### 1.1 **Shebang**
-   - CT scripts source build.func and call the install script
-   - Install scripts use sourced FUNCTIONS_FILE_PATH (via build.func)
-   - Both scripts work together in the container
 
-3. **Test via GitHub:**
+- Use `#!/usr/bin/env bash` as the shebang.
-
-   ```bash
-   # Push your changes to your fork first
-   git push origin feature/my-awesome-app
-
-   # Test the CT script via curl (it will call the install script)
-   bash -c "$(curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/ProxmoxVE/main/ct/MyApp.sh)"
-   # ⏱️ Wait 10-30 seconds after pushing - GitHub takes time to update
-   ```
-
----
-
-## Template Structure
-
-### Header
 
 ```bash
 #!/usr/bin/env bash
-source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/install.func)
-# (setup-fork.sh modifies this URL to point to YOUR fork during development)
 ```
 
-### Dependencies (App-Specific Only)
-
-```bash
-# Don't add: ca-certificates, curl, gnupg, wget, git, jq
-# These are handled by build.func
-msg_info "Installing dependencies"
-$STD apt-get install -y app-specific-deps
-msg_ok "Installed dependencies"
-```
-
-### Runtime Setup
-
-Use tools.func helpers instead of manual installation:
-
-```bash
-# ✅ NEW (use tools.func):
-NODE_VERSION="20"
-setup_nodejs
-# OR
-PYTHON_VERSION="3.12"
-setup_uv
-# OR
-PG_DB_NAME="myapp_db"
-PG_DB_USER="myapp"
-setup_postgresql_db
-```
-
-### Service Configuration
-
-```bash
-# Create .env file
-msg_info "Configuring MyApp"
-cat << EOF > /opt/myapp/.env
-DEBUG=false
-PORT=8080
-DATABASE_URL=postgresql://...
-EOF
-msg_ok "Configuration complete"
-
-# Create systemd service
-msg_info "Creating systemd service"
-cat << EOF > /etc/systemd/system/myapp.service
-[Unit]
-Description=MyApp
-[Service]
-ExecStart=/usr/bin/node /opt/myapp/app.js
-[Install]
-WantedBy=multi-user.target
-EOF
-msg_ok "Service created"
-```
-
-### Finalization
-
-```bash
-msg_info "Finalizing MyApp installation"
-systemctl enable --now myapp
-motd_ssh
-customize
-msg_ok "MyApp installation complete"
-cleanup_lxc
-```
-
----
-
-## Key Patterns
-
-### Avoid Manual Version Checking
-
-❌ OLD (manual):
-
-```bash
-RELEASE=$(curl -fsSL https://api.github.com/repos/app/repo/releases/latest | grep tag_name)
-wget https://github.com/app/repo/releases/download/$RELEASE/app.tar.gz
-```
-
-✅ NEW (use tools.func via CT script's fetch_and_deploy_gh_release):
-
-```bash
-# In CT script, not install script:
-fetch_and_deploy_gh_release "myapp" "app/repo" "app.tar.gz" "latest" "/opt/myapp"
-```
-
-### Database Setup
-
-```bash
-# Use setup_postgresql_db, setup_mysql_db, etc.
-PG_DB_NAME="myapp"
-PG_DB_USER="myapp"
-setup_postgresql_db
-```
-
-### Node.js Setup
-
-```bash
-NODE_VERSION="20"
-setup_nodejs
-npm install --no-save
-```
-
----
-
-## Best Practices
-
-1. **Only add app-specific dependencies**
-   - Don't add: ca-certificates, curl, gnupg, wget, git, jq
-   - These are handled by build.func
-
-2. **Use tools.func helpers**
-   - setup_nodejs, setup_python, setup_uv, setup_postgresql_db, setup_mysql_db, etc.
-
-3. **Don't do version checks in install script**
-   - Version checking happens in CT script's update_script()
-   - Install script just installs the latest
-
-4. **Structure:**
-   - Dependencies
-   - Runtime setup (tools.func)
-   - Deployment (fetch from CT script)
-   - Configuration files
-   - Systemd service
-   - Finalization
-
----
-
-## Reference Scripts
-
-See working examples:
-
-- [Trip](https://github.com/community-scripts/ProxmoxVE/blob/main/install/trip-install.sh)
-- [Thingsboard](https://github.com/community-scripts/ProxmoxVE/blob/main/install/thingsboard-install.sh)
-- [UniFi](https://github.com/community-scripts/ProxmoxVE/blob/main/install/unifi-install.sh)
-
----
-
-## Need Help?
-
-- **[Modern Template](AppName-install.sh)** - Start here
-- **[CT Template](../templates_ct/AppName.sh)** - How CT scripts work
-- **[README.md](../README.md)** - Full contribution workflow
-- **[AI.md](../AI.md)** - AI-generated script guidelines
-
 ### 1.2 **Comments**
 
 - Add clear comments for script metadata, including author, copyright, and license information.
@@ -330,7 +189,7 @@ msg_ok "Installed Dependencies"
 ### 6.2 **Verbosity**
 
 - Use the appropiate flag (**-q** in the examples) for a command to suppres its output
-  Example:
+Example:
 
 ```bash
 curl -fsSL

docs/contribution/templates_install/AppName-install.sh

@@ -5,6 +5,7 @@
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 # Source: [SOURCE_URL e.g. https://github.com/example/app]
 
+# Import Functions and Setup
 source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
 color
 verb_ip6
@@ -14,51 +15,48 @@ network_check
 update_os
 
 # =============================================================================
-# DEPENDENCIES - Only add app-specific dependencies here!
+# DEPENDENCIES
-# Don't add: ca-certificates, curl, gnupg, git, build-essential (handled by build.func)
 # =============================================================================
+# Only install what's actually needed - curl/sudo/mc are already in the base image
 
 msg_info "Installing Dependencies"
 $STD apt install -y \
-  libharfbuzz0b \
+  nginx \
-  fontconfig
+  build-essential
 msg_ok "Installed Dependencies"
 
 # =============================================================================
-# SETUP RUNTIMES & DATABASES (if needed)
+# HELPER FUNCTIONS FROM tools.func
 # =============================================================================
-# Examples (uncomment as needed):
+# These functions are available via $FUNCTIONS_FILE_PATH (tools.func)
+# Call them with optional environment variables for configuration
 #
-#   NODE_VERSION="22" setup_nodejs
+# --- Runtime & Language Setup ---
-#   NODE_VERSION="22" NODE_MODULE="pnpm" setup_nodejs  # Installs pnpm
+# NODE_VERSION="22" setup_nodejs           # Install Node.js (22, 24)
-#   PYTHON_VERSION="3.13" setup_uv
+# NODE_VERSION="24" NODE_MODULE="pnpm" setup_nodejs  # With pnpm
-#   JAVA_VERSION="21" setup_java
+# PYTHON_VERSION="3.13" setup_uv           # Python with uv package manager
-#   GO_VERSION="1.22" setup_go
+# setup_go                                 # Install Go (latest)
-#   PHP_VERSION="8.4" PHP_FPM="YES" setup_php
+# setup_rust                               # Install Rust via rustup
-#   setup_postgresql           # Server only
+# setup_ruby                               # Install Ruby
-#   setup_mariadb              # Server only
+# PHP_VERSION="8.4" PHP_FPM="YES" PHP_MODULE="mysqli,gd" setup_php
-#   setup_meilisearch          # Search engine
+# 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)
 #
-#   Then set up DB and user (sets $[DB]_DB_PASS):
+# --- Database Setup ---
-#   PG_DB_NAME="myapp" PG_DB_USER="myapp" setup_postgresql_db
+# setup_mariadb                            # Install MariaDB server
-#   MARIADB_DB_NAME="myapp" MARIADB_DB_USER="myapp" setup_mariadb_db
+# 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)
-# DOWNLOAD & DEPLOY APPLICATION
+# PG_VERSION="17" PG_MODULES="postgis" setup_postgresql  # With extensions
-# =============================================================================
+# PG_DB_NAME="mydb" PG_DB_USER="myuser" setup_postgresql_db
-# fetch_and_deploy_gh_release modes:
+# setup_mongodb                            # Install MongoDB
-#   "tarball"  - Source tarball (default if omitted)
+#
-#   "binary"   - .deb package (auto-detects amd64/arm64)
+# --- GitHub Release (PREFERRED METHOD) ---
-#   "prebuild" - Pre-built archive (.tar.gz)
+# fetch_and_deploy_gh_release "appname" "owner/repo" "tarball"  # Downloads, extracts, tracks version
-#   "singlefile" - Single binary file
+# 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"
 #
-# Examples:
-#   fetch_and_deploy_gh_release "myapp" "YourUsername/myapp" "tarball" "latest" "/opt/myapp"
-#   fetch_and_deploy_gh_release "myapp" "YourUsername/myapp" "binary" "latest" "/tmp"
-#   fetch_and_deploy_gh_release "myapp" "YourUsername/myapp" "prebuild" "latest" "/opt/myapp" "myapp-*.tar.gz"
-
-fetch_and_deploy_gh_release "[appname]" "owner/repo" "tarball" "latest" "/opt/[appname]"
-
 # --- Tools & Utilities ---
 # get_lxc_ip                          # Sets $LOCAL_IP variable (call early!)
 # setup_ffmpeg                             # Install FFmpeg with codecs
@@ -69,11 +67,8 @@ fetch_and_deploy_gh_release "[appname]" "owner/repo" "tarball" "latest" "/opt/[a
 # create_self_signed_cert                  # Creates cert in /etc/ssl/[appname]/
 
 # =============================================================================
-# EXAMPLES
-# =============================================================================
-#
 # 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
@@ -89,9 +84,10 @@ fetch_and_deploy_gh_release "[appname]" "owner/repo" "tarball" "latest" "/opt/[a
 # PORT=3000
 # EOF
 # msg_ok "Configured MyApp"
-#
+
+# =============================================================================
 # EXAMPLE 2: Python Application with uv
-# ------------------------------------
+# =============================================================================
 # PYTHON_VERSION="3.13" setup_uv
 # get_lxc_ip
 # fetch_and_deploy_gh_release "myapp" "owner/myapp" "tarball" "latest" "/opt/myapp"
@@ -145,7 +141,7 @@ fetch_and_deploy_gh_release "[appname]" "[owner/repo]" "tarball" "latest" "/opt/
 
 msg_info "Setting up [AppName]"
 cd /opt/[appname]
-# $STD npm ci
+$STD npm ci
 msg_ok "Setup [AppName]"
 
 # =============================================================================
@@ -153,25 +149,14 @@ msg_ok "Setup [AppName]"
 # =============================================================================
 
 msg_info "Configuring [AppName]"
-cd /opt/[appname]
-
-# Install application dependencies (uncomment as needed):
-# $STD npm ci --production         # Node.js apps
-# $STD uv sync --frozen            # Python apps
-# $STD composer install --no-dev   # PHP apps
-# $STD cargo build --release       # Rust apps
-
-# Create .env file if needed:
 cat <<EOF >/opt/[appname]/.env
-# Use import_local_ip to get container IP, or hardcode if building on Proxmox
+HOST=${LOCAL_IP}
-APP_URL=http://localhost
 PORT=8080
 EOF
-
 msg_ok "Configured [AppName]"
 
 # =============================================================================
-# CREATE SYSTEMD SERVICE
+# SERVICE CREATION
 # =============================================================================
 
 msg_info "Creating Service"
@@ -197,11 +182,9 @@ msg_ok "Created Service"
 # =============================================================================
 # CLEANUP & FINALIZATION
 # =============================================================================
-# These are called automatically, but shown here for clarity:
-#   motd_ssh           - Displays service info on SSH login
-#   customize          - Enables optional customizations
-#   cleanup_lxc        - Removes temp files, bash history, logs
 
 motd_ssh
 customize
+
+# cleanup_lxc handles: apt autoremove, autoclean, temp files, bash history
 cleanup_lxc

docs/contribution/templates_json/AppName.json

@@ -4,26 +4,25 @@
   "categories": [
     0
   ],
-  "date_created": "2026-01-18",
+  "date_created": "DATE CREATED",
   "type": "ct",
   "updateable": true,
   "privileged": false,
-  "interface_port": 3000,
+  "interface_port": "DEFAULT-PORT",
-  "documentation": "https://docs.example.com/",
+  "documentation": null,
-  "website": "https://example.com/",
+  "website": "LINK TO WEBSITE",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/appname.webp",
+  "logo": "LINK TO LOGO",
-  "config_path": "/opt/appname/.env",
+  "description": "Description of the app",
-  "description": "Short description of what AppName does and its main features.",
   "install_methods": [
     {
       "type": "default",
-      "script": "ct/appname.sh",
+      "script": "ct/AppName.sh",
       "resources": {
         "cpu": 2,
         "ram": 2048,
-        "hdd": 8,
+        "hdd": 4,
-        "os": "Debian",
+        "os": "debian",
-        "version": "13"
+        "version": "12"
       }
     }
   ],
@@ -31,10 +30,5 @@
     "username": null,
     "password": null
   },
-  "notes": [
+  "notes": []
-    {
-      "text": "Change the default password after first login!",
-      "type": "warning"
-    }
-  ]
 }

docs/contribution/templates_json/AppName.md

@@ -1,165 +1,13 @@
-# JSON Metadata Files - Quick Reference
+# **AppName<span></span>.json Files**
 
-The metadata file (`frontend/public/json/myapp.json`) tells the web interface how to display your application.
+ `AppName.json` files found in the `/json` directory. These files are used to provide informations for the website. For this guide we take `/json/snipeit.json` as example.
 
----
+## Table of Contents
 
-## Quick Start
+- [**AppName.json Files**](#appnamejson-files)
+  - [Table of Contents](#table-of-contents)
+  - [1. JSON Generator](#1-json-generator)
 
-**Use the JSON Generator Tool:**
+## 1. JSON Generator
-[https://community-scripts.github.io/ProxmoxVE/json-editor](https://community-scripts.github.io/ProxmoxVE/json-editor)
 
-1. Enter application details
+Use the [JSON Generator](https://community-scripts.github.io/ProxmoxVE/json-editor) to create this file for your application.
-2. Generator creates `frontend/public/json/myapp.json`
-3. Copy the output to your contribution
-
----
-
-## File Structure
-
-```json
-{
-  "name": "MyApp",
-  "slug": "myapp",
-  "categories": [1],
-  "date_created": "2026-01-18",
-  "type": "ct",
-  "updateable": true,
-  "privileged": false,
-  "interface_port": 3000,
-  "documentation": "https://docs.example.com/",
-  "website": "https://example.com/",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/myapp.webp",
-  "config_path": "/opt/myapp/.env",
-  "description": "Brief description of what MyApp does",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "ct/myapp.sh",
-      "resources": {
-        "cpu": 2,
-        "ram": 2048,
-        "hdd": 8,
-        "os": "Debian",
-        "version": "13"
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": null,
-    "password": null
-  },
-  "notes": [
-    {
-      "text": "Change the default password after first login!",
-      "type": "warning"
-    }
-  ]
-}
-```
-
----
-
-## Field Reference
-
-| Field                 | Required | Example           | Notes                                          |
-| --------------------- | -------- | ----------------- | ---------------------------------------------- |
-| `name`                | Yes      | "MyApp"           | Display name                                   |
-| `slug`                | Yes      | "myapp"           | URL-friendly identifier (lowercase, no spaces) |
-| `categories`          | Yes      | [1]               | One or more category IDs                       |
-| `date_created`        | Yes      | "2026-01-18"      | Format: YYYY-MM-DD                             |
-| `type`                | Yes      | "ct"              | Container type: "ct" or "vm"                   |
-| `interface_port`      | Yes      | 3000              | Default web interface port                     |
-| `logo`                | No       | "https://..."     | Logo URL (64px x 64px PNG)                     |
-| `config_path`         | Yes      | "/opt/myapp/.env" | Main config file location                      |
-| `description`         | Yes      | "App description" | Brief description (100 chars)                  |
-| `install_methods`     | Yes      | See below         | Installation resources (array)                 |
-| `default_credentials` | No       | See below         | Optional default login                         |
-| `notes`               | No       | See below         | Additional notes (array)                       |
-
----
-
-## Install Methods
-
-Each installation method specifies resource requirements:
-
-```json
-"install_methods": [
-  {
-    "type": "default",
-    "script": "ct/myapp.sh",
-    "resources": {
-      "cpu": 2,
-      "ram": 2048,
-      "hdd": 8,
-      "os": "Debian",
-      "version": "13"
-    }
-  }
-]
-```
-
-**Resource Defaults:**
-
-- CPU: Cores (1-8)
-- RAM: Megabytes (256-4096)
-- Disk: Gigabytes (4-50)
-
----
-
-## Common Categories
-
-- `0` Miscellaneous
-- `1` Proxmox & Virtualization
-- `2` Operating Systems
-- `3` Containers & Docker
-- `4` Network & Firewall
-- `5` Adblock & DNS
-- `6` Authentication & Security
-- `7` Backup & Recovery
-- `8` Databases
-- `9` Monitoring & Analytics
-- `10` Dashboards & Frontends
-- `11` Files & Downloads
-- `12` Documents & Notes
-- `13` Media & Streaming
-- `14` \*Arr Suite
-- `15` NVR & Cameras
-- `16` IoT & Smart Home
-- `17` ZigBee, Z-Wave & Matter
-- `18` MQTT & Messaging
-- `19` Automation & Scheduling
-- `20` AI / Coding & Dev-Tools
-- `21` Webservers & Proxies
-- `22` Bots & ChatOps
-- `23` Finance & Budgeting
-- `24` Gaming & Leisure
-- `25` Business & ERP
-
----
-
-## Best Practices
-
-1. **Use the JSON Generator** - It validates structure
-2. **Keep descriptions short** - 100 characters max
-3. **Use real resource requirements** - Based on your testing
-4. **Include sensible defaults** - Pre-filled in install_methods
-5. **Slug must be lowercase** - No spaces, use hyphens
-
----
-
-## Reference Examples
-
-See actual examples in the repo:
-
-- [frontend/public/json/trip.json](https://github.com/community-scripts/ProxmoxVE/blob/main/frontend/public/json/trip.json)
-- [frontend/public/json/thingsboard.json](https://github.com/community-scripts/ProxmoxVE/blob/main/frontend/public/json/thingsboard.json)
-- [frontend/public/json/unifi.json](https://github.com/community-scripts/ProxmoxVE/blob/main/frontend/public/json/unifi.json)
-
----
-
-## Need Help?
-
-- **[JSON Generator](https://community-scripts.github.io/ProxmoxVE/json-editor)** - Interactive tool
-- **[README.md](../README.md)** - Full contribution workflow
-- **[Quick Start](../README.md)** - Step-by-step guide

docs/guides/CONFIGURATION_REFERENCE.md

@@ -539,69 +539,6 @@ var_nesting=0    # Nested containers disabled
 
 ---
 
-### var_diagnostics
-
-**Type:** Boolean (yes or no)
-**Default:** `yes`
-**Description:** Determines if anonymous telemetry and diagnostic data is sent to Community-Scripts API.
-
-```bash
-var_diagnostics=yes      # Allow telemetry (helps us improve scripts)
-var_diagnostics=no       # Disable all telemetry
-```
-
-**Privacy & Usage:**
-- Data is strictly anonymous (random session ID)
-- Reports success/failure of installations
-- Maps error codes (e.g., APT lock, out of RAM)
-- No user-specific data, hostnames, or secret keys are ever sent
-
----
-
-### var_gpu
-
-**Type:** Boolean/Toggle
-**Options:** `yes` or `no`
-**Default:** `no`
-**Description:** Enable GPU passthrough for the container.
-
-```bash
-var_gpu=yes      # Enable GPU passthrough (auto-detect)
-var_gpu=no       # Disable GPU passthrough (default)
-```
-
-**Features enabled:**
-- Auto-detects Intel (QuickSync), NVIDIA, and AMD GPUs
-- Passes through `/dev/dri` and render nodes
-- Configures appropriate container permissions
-- Crucial for media servers (Plex, Jellyfin, Immich)
-
-**Prerequisites:**
-- Host drivers installed correctly
-- Hardware present and visible to Proxmox
-- IOMMU enabled (for some configurations)
-
----
-
-### var_tun
-
-**Type:** Boolean/Toggle
-**Options:** `yes` or `no`
-**Default:** `no`
-**Description:** Enable TUN/TAP device support.
-
-```bash
-var_tun=yes      # Enable TUN/TAP support
-var_tun=no       # Disable TUN/TAP support (default)
-```
-
-**Required for:**
-- VPN software (WireGuard, OpenVPN)
-- Network tunneling (Tailscale, ZeroTier)
-- Custom network bridges
-
----
-
 ### var_keyctl
 
 **Type:** Boolean (0 or 1)
@@ -623,14 +560,13 @@ var_keyctl=0     # Keyctl disabled
 
 ### var_fuse
 
-**Type:** Boolean/Toggle
+**Type:** Boolean (0 or 1)
-**Options:** `yes` or `no`
+**Default:** `0`
-**Default:** `no`
 **Description:** Enable FUSE filesystem support.
 
 ```bash
-var_fuse=yes     # FUSE enabled
+var_fuse=1       # FUSE enabled
-var_fuse=no      # FUSE disabled
+var_fuse=0       # FUSE disabled
 ```
 
 **Required for:**

docs/guides/UNATTENDED_DEPLOYMENTS.md

@@ -57,7 +57,7 @@ pveversion
 ### 2. Network Connectivity
 ```bash
 # Test GitHub access
-curl -I https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/debian.sh
+curl -I https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/debian.sh
 
 # Test internet connectivity
 ping -c 1 1.1.1.1
@@ -108,8 +108,6 @@ var_cpu=4 \
 var_ram=4096 \
 var_disk=30 \
 var_hostname=production-app \
-var_os=debian \
-var_version=13 \
 var_brg=vmbr0 \
 var_net=dhcp \
 var_ipv6_method=none \
@@ -119,7 +117,7 @@ var_nesting=1 \
 var_tags=production,automated \
 var_protection=yes \
 var_verbose=no \
-  bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/debian.sh)"
+  bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/debian.sh)"
 
 echo "✓ Container deployed successfully"
 ```
@@ -153,7 +151,7 @@ var_gateway=192.168.1.1 \
 
 **Step 1: Create defaults once (interactive)**
 ```bash
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/pihole.sh)"
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/pihole.sh)"
 # Select "Advanced Settings" → Configure → Save as "App Defaults"
 ```
 
@@ -163,30 +161,10 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/Proxmo
 # deploy-with-defaults.sh
 
 # App defaults are loaded automatically
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/pihole.sh)"
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/pihole.sh)"
 # Script will use /usr/local/community-scripts/defaults/pihole.vars
 ```
 
-### Advanced Configuration Variables
-
-Beyond the basic resource settings, you can control advanced container features:
-
-| Variable | Description | Options |
-|----------|-------------|---------|
-| `var_os` | Operating system template | `debian`, `ubuntu`, `alpine` |
-| `var_version` | OS version | `12`, `13` (Debian), `22.04`, `24.04` (Ubuntu) |
-| `var_gpu` | Enable GPU passthrough | `yes`, `no` (Default: `no`) |
-| `var_tun` | Enable TUN/TAP device | `yes`, `no` (Default: `no`) |
-| `var_nesting` | Enable nesting | `1`, `0` (Default: `1`) |
-
-**Example with GPU and TUN:**
-```bash
-var_gpu=yes \
-var_tun=yes \
-var_hostname=transcoder \
-  bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/plex.sh)"
-```
-
 ---
 
 ## Batch Deployments
@@ -199,14 +177,14 @@ var_hostname=transcoder \
 #!/bin/bash
 # batch-deploy-simple.sh
 
-apps=("thingsboard" "qui" "flatnotes")
+apps=("debian" "ubuntu" "alpine")
 
 for app in "${apps[@]}"; do
   echo "Deploying $app..."
-  var_hostname="$app-server" \
+  var_hostname="$app-container" \
   var_cpu=2 \
   var_ram=2048 \
-    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${app}.sh)"
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${app}.sh)"
 
   echo "✓ $app deployed"
   sleep 5  # Wait between deployments
@@ -220,10 +198,10 @@ done
 # batch-deploy-advanced.sh - Deploy multiple containers with individual configs
 
 declare -A CONTAINERS=(
-  ["beszel"]="1:512:8:vmbr0:monitoring"
+  ["pihole"]="2:1024:8:vmbr0:dns,network"
-  ["qui"]="2:1024:10:vmbr0:torrent,ui"
+  ["homeassistant"]="4:4096:20:vmbr0:automation,ha"
-  ["thingsboard"]="6:8192:50:vmbr1:iot,industrial"
+  ["docker"]="6:8192:50:vmbr1:containers,docker"
-  ["dockge"]="2:2048:10:vmbr0:docker,management"
+  ["nginx"]="2:2048:10:vmbr0:webserver,proxy"
 )
 
 for app in "${!CONTAINERS[@]}"; do
@@ -250,7 +228,7 @@ for app in "${!CONTAINERS[@]}"; do
   var_ipv6_method=none \
   var_ssh=yes \
   var_tags="$tags,automated" \
-    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${app}.sh)" 2>&1 | tee "deploy-${app}.log"
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${app}.sh)" 2>&1 | tee "deploy-${app}.log"
 
   if [ $? -eq 0 ]; then
     echo "✓ $app deployed successfully"
@@ -285,7 +263,7 @@ deploy_container() {
   var_disk="$disk" \
   var_hostname="$app" \
   var_net=dhcp \
-    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${app}.sh)" \
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${app}.sh)" \
     &> "deploy-${app}.log"
 
   echo "[$app] ✓ Completed"
@@ -316,7 +294,7 @@ echo "All deployments complete!"
 ```yaml
 ---
 # playbook-proxmox.yml
-- name: Deploy ProxmoxVE Containers
+- name: Deploy ProxmoxVED Containers
   hosts: proxmox_hosts
   become: yes
   tasks:
@@ -330,7 +308,7 @@ echo "All deployments complete!"
         var_net=dhcp \
         var_ssh=yes \
         var_tags=ansible,automated \
-        bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/debian.sh)"
+        bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/debian.sh)"
       args:
         executable: /bin/bash
       register: deploy_result
@@ -387,7 +365,7 @@ echo "All deployments complete!"
         var_ssh=yes \
         var_ssh_authorized_key="{{ ssh_key }}" \
         var_tags="{{ item.tags }},ansible" \
-        bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/{{ item.name }}.sh)"
+        bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/{{ item.name }}.sh)"
       args:
         executable: /bin/bash
       loop: "{{ containers }}"
@@ -439,7 +417,7 @@ resource "null_resource" "deploy_container" {
       "var_disk=${each.value.disk}",
       "var_hostname=${each.key}",
       "var_net=dhcp",
-      "bash -c \"$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${each.value.template}.sh)\""
+      "bash -c \"$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${each.value.template}.sh)\""
     ]
 
     connection {
@@ -520,7 +498,7 @@ jobs:
             var_net=dhcp \
             var_ssh=yes \
             var_tags=ci-cd,automated \
-            bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${{ github.event.inputs.container_type }}.sh)"
+            bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${{ github.event.inputs.container_type }}.sh)"
 
       - name: Notify deployment status
         if: success()
@@ -554,7 +532,7 @@ deploy_container:
         var_hostname=gitlab-ci-container \
         var_net=dhcp \
         var_tags=gitlab-ci,automated \
-        bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/debian.sh)"
+        bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/debian.sh)"
       EOF
   only:
     - main
@@ -586,7 +564,7 @@ deploy_container() {
   var_hostname="$HOSTNAME" \
   var_net=dhcp \
   var_ssh=yes \
-    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${APP}.sh)" 2>&1 | tee deploy.log
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${APP}.sh)" 2>&1 | tee deploy.log
 
   return ${PIPESTATUS[0]}
 }
@@ -678,7 +656,7 @@ deploy() {
   var_hostname="$HOSTNAME" \
   var_cpu=4 \
   var_ram=4096 \
-    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${APP}.sh)"
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${APP}.sh)"
   return $?
 }
 
@@ -781,7 +759,7 @@ deploy_secure() {
   var_protection=yes \
   var_tags=production,secure,automated \
   var_verbose=no \
-    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${APP}.sh)" 2>&1 | tee -a "$LOG_FILE"
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${APP}.sh)" 2>&1 | tee -a "$LOG_FILE"
 
   if [ ${PIPESTATUS[0]} -eq 0 ]; then
     log "✓ Deployment successful"
@@ -846,7 +824,7 @@ SSH_KEYS=$(load_ssh_keys)
 var_ssh=yes \
 var_ssh_authorized_key="$SSH_KEYS" \
 var_hostname=multi-key-server \
-  bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/debian.sh)"
+  bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/debian.sh)"
 ```
 
 ---
@@ -925,7 +903,7 @@ deploy_from_config() {
     var_ssh=yes \
     var_tags="$tags,automated" \
     var_protection=yes \
-      bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/${app}.sh)"
+      bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/ct/${app}.sh)"
 
     if [ $? -eq 0 ]; then
       log_success "Deployed: $name"

docs/misc/api.func/API_FUNCTIONS_REFERENCE.md

@@ -56,7 +56,7 @@ get_error_description 255   # "Unknown critical error, often due to missing perm
 - `DIAGNOSTICS` must be set to "yes"
 - `RANDOM_UUID` must be set and not empty
 
-**API Endpoint**: `https://api.community-scripts.org/dev/upload`
+**API Endpoint**: `http://api.community-scripts.org/dev/upload`
 
 **JSON Payload Structure**:
 ```json
@@ -110,7 +110,7 @@ post_to_api
 - `curl` command must be available
 - `RANDOM_UUID` must be set and not empty
 
-**API Endpoint**: `https://api.community-scripts.org/dev/upload`
+**API Endpoint**: `http://api.community-scripts.org/dev/upload`
 
 **JSON Payload Structure**:
 ```json
@@ -167,7 +167,7 @@ post_to_api_vm
 - `RANDOM_UUID` must be set and not empty
 - POST_UPDATE_DONE must be false (prevents duplicates)
 
-**API Endpoint**: `https://api.community-scripts.org/dev/upload/updatestatus`
+**API Endpoint**: `http://api.community-scripts.org/dev/upload/updatestatus`
 
 **JSON Payload Structure**:
 ```json

docs/misc/api.func/API_USAGE_EXAMPLES.md

@@ -461,7 +461,7 @@ check_api_health() {
     echo "Error description test: $test_error"
 
     # Test API connectivity (without sending data)
-    local api_url="https://api.community-scripts.org/dev/upload"
+    local api_url="http://api.community-scripts.org/dev/upload"
     if curl -s --head "$api_url" >/dev/null 2>&1; then
         echo "API endpoint is reachable"
     else

docs/misc/build.func/BUILD_FUNC_FUNCTIONS_REFERENCE.md

@@ -438,34 +438,6 @@ default_var_settings()  # Save global defaults
 maybe_offer_save_app_defaults()  # Save app defaults
 ```
 
-### Container Resource & ID Management
-
-#### `validate_container_id()`
-**Purpose**: Validates if a container ID is available for use.
-**Parameters**: `ctid` (Integer)
-**Returns**: `0` if available, `1` if already in use or invalid.
-**Description**: Checks for existing config files in `/etc/pve/lxc/` or `/etc/pve/qemu-server/`, and verifies LVM logical volumes.
-
-#### `get_valid_container_id()`
-**Purpose**: Returns the next available, unused container ID.
-**Parameters**: `suggested_id` (Optional)
-**Returns**: A valid container ID string.
-**Description**: If the suggested ID is taken, it increments until it finds an available one.
-
-#### `maxkeys_check()`
-**Purpose**: Ensures host kernel parameters support high numbers of keys (required for some apps).
-**Parameters**: None
-**Description**: Checks and optionally updates `kernel.keys.maxkeys` and `kernel.keys.maxbytes`.
-
-#### `get_current_ip()`
-**Purpose**: Retrieves the current IP address of the container.
-**Parameters**: `ctid` (Integer)
-**Returns**: IP address string.
-
-#### `update_motd_ip()`
-**Purpose**: Updates the Message of the Day (MOTD) file with the container's IP.
-**Parameters**: None
-
 ## Function Error Handling
 
 ### Validation Functions

docs/misc/build.func/BUILD_FUNC_USAGE_EXAMPLES.md

@@ -60,10 +60,10 @@ export var_gateway="192.168.1.1"
 export var_ip="192.168.1.101"
 export var_vlan="100"
 export var_mtu="9000"
-export var_template_storage="ssd-storage"
+export var_template_storage="nfs-storage"
 export var_container_storage="ssd-storage"
-export var_fuse="yes"
+export ENABLE_FUSE="true"
-export var_tun="yes"
+export ENABLE_TUN="true"
 export SSH="true"
 
 # Execute build.func

docs/misc/tools.func/TOOLS_FUNC_FUNCTIONS_REFERENCE.md

@@ -20,19 +20,14 @@ Complete alphabetical reference of all functions in tools.func with parameters,
 - `setup_nodejs(VERSION)` - Install Node.js and npm
 - `setup_php(VERSION)` - Install PHP-FPM and CLI
 - `setup_python(VERSION)` - Install Python 3 with pip
-- `setup_uv()` - Install Python uv (modern & fast)
 - `setup_ruby(VERSION)` - Install Ruby with gem
 - `setup_golang(VERSION)` - Install Go programming language
-- `setup_java(VERSION)` - Install OpenJDK (Adoptium)
 
 **Databases**:
-- `setup_mariadb()` - Install MariaDB server
+- `setup_mariadb()` - Install MariaDB server (distro packages by default)
-- `setup_mariadb_db()` - Create user/db in MariaDB
 - `setup_postgresql(VERSION)` - Install PostgreSQL
-- `setup_postgresql_db()` - Create user/db in PostgreSQL
 - `setup_mongodb(VERSION)` - Install MongoDB
 - `setup_redis(VERSION)` - Install Redis cache
-- `setup_meilisearch()` - Install Meilisearch engine
 
 **Web Servers**:
 - `setup_nginx()` - Install Nginx
@@ -49,7 +44,6 @@ Complete alphabetical reference of all functions in tools.func with parameters,
 - `setup_docker_compose()` - Install Docker Compose
 - `setup_composer()` - Install PHP Composer
 - `setup_build_tools()` - Install build-essential
-- `setup_yq()` - Install mikefarah/yq processor
 
 **Monitoring**:
 - `setup_grafana()` - Install Grafana
@@ -66,13 +60,13 @@ Complete alphabetical reference of all functions in tools.func with parameters,
 
 ## Core Functions
 
-### install_packages_with_retry()
+### pkg_install()
 
-Install one or more packages safely with automatic retry logic (3 attempts), APT refresh, and lock handling.
+Install one or more packages safely with automatic retry logic and error handling.
 
 **Signature**:
 ```bash
-install_packages_with_retry PACKAGE1 [PACKAGE2 ...]
+pkg_install PACKAGE1 [PACKAGE2 ...]
 ```
 
 **Parameters**:
@@ -80,122 +74,66 @@ install_packages_with_retry PACKAGE1 [PACKAGE2 ...]
 
 **Returns**:
 - `0` - All packages installed successfully
-- `1` - Installation failed after all retries
+- `1` - Installation failed after retries
 
-**Features**:
+**Environment Variables**:
-- Automatically sets `DEBIAN_FRONTEND=noninteractive`
+- `$STD` - Output suppression (`silent` or empty)
-- Handles DPKG lock errors with `dpkg --configure -a`
-- Retries on transient network or APT failures
 
 **Example**:
 ```bash
-install_packages_with_retry curl wget git
+pkg_install curl wget git
 ```
 
 ---
 
-### upgrade_packages_with_retry()
+### pkg_update()
 
-Upgrades installed packages with the same robust retry logic as the installation helper.
+Update package lists with automatic retry logic for network failures.
 
 **Signature**:
 ```bash
-upgrade_packages_with_retry
+pkg_update
 ```
 
+**Parameters**: None
+
 **Returns**:
-- `0` - Upgrade successful
+- `0` - Package lists updated
-- `1` - Upgrade failed
+- `1` - Failed after 3 retries
-
----
-
-### fetch_and_deploy_gh_release()
-
-The primary tool for downloading and installing software from GitHub Releases. Supports binaries, tarballs, and Debian packages.
-
-**Signature**:
-```bash
-fetch_and_deploy_gh_release APPREPO TYPE [VERSION] [DEST] [ASSET_PATTERN]
-```
-
-**Environment Variables**:
-- `APPREPO`: GitHub repository (e.g., `owner/repo`)
-- `TYPE`: Asset type (`binary`, `tarball`, `prebuild`, `singlefile`)
-- `VERSION`: Specific tag or `latest` (Default: `latest`)
-- `DEST`: Target directory (Default: `/opt/$APP`)
-- `ASSET_PATTERN`: Regex or string pattern to match the release asset (Required for `prebuild` and `singlefile`)
-
-**Supported Operation Modes**:
-- `tarball`: Downloads and extracts the source tarball.
-- `binary`: Detects host architecture and installs a `.deb` package using `apt` or `dpkg`.
-- `prebuild`: Downloads and extracts a pre-built binary archive (supports `.tar.gz`, `.zip`, `.tgz`, `.txz`).
-- `singlefile`: Downloads a single binary file to the destination.
-
-**Environment Variables**:
-- `CLEAN_INSTALL=1`: Removes all contents of the destination directory before extraction.
-- `DPKG_FORCE_CONFOLD=1`: Forces `dpkg` to keep old config files during package updates.
-- `SYSTEMD_OFFLINE=1`: Used automatically for `.deb` installs to prevent systemd-tmpfiles failures in unprivileged containers.
 
 **Example**:
 ```bash
-fetch_and_deploy_gh_release "muesli/duf" "binary" "latest" "/opt/duf" "duf_.*_linux_amd64.tar.gz"
+pkg_update
 ```
 
 ---
 
-### check_for_gh_release()
+### pkg_remove()
 
-Checks if a newer version is available on GitHub compared to the installed version.
+Remove packages completely including dependencies.
 
 **Signature**:
 ```bash
-check_for_gh_release APP REPO
+pkg_remove PACKAGE1 [PACKAGE2 ...]
 ```
 
+**Parameters**:
+- `PACKAGE1, PACKAGE2, ...` - Package names to remove
+
+**Returns**:
+- `0` - Packages removed
+- `1` - Removal failed
+
 **Example**:
 ```bash
-if check_for_gh_release "nodejs" "nodesource/distributions"; then
+pkg_remove old-package outdated-tool
-  # update logic
-fi
-```
-
----
-
-### prepare_repository_setup()
-
-Performs safe repository preparation by cleaning up old files, keyrings, and ensuring the APT system is in a working state.
-
-**Signature**:
-```bash
-prepare_repository_setup REPO_NAME [REPO_NAME2 ...]
-```
-
-**Example**:
-```bash
-prepare_repository_setup "mariadb" "mysql"
-```
-
----
-
-### verify_tool_version()
-
-Validates if the installed major version matches the expected version.
-
-**Signature**:
-```bash
-verify_tool_version NAME EXPECTED INSTALLED
-```
-
-**Example**:
-```bash
-verify_tool_version "nodejs" "22" "$(node -v | grep -oP '^v\K[0-9]+')"
 ```
 
 ---
 
 ### setup_deb822_repo()
 
-Add repository in modern deb822 format.
+Add repository in modern deb822 format (recommended over legacy format).
 
 **Signature**:
 ```bash
@@ -250,234 +188,12 @@ cleanup_repo_metadata
 
 ## Tool Installation Functions
 
-### setup_nodejs()
+### setup_nodejs(VERSION)
 
-Install Node.js and npm from official repositories. Handles legacy version cleanup (nvm) automatically.
+Install Node.js and npm from official repositories.
 
 **Signature**:
 ```bash
-setup_nodejs
-```
-
-**Environment Variables**:
-- `NODE_VERSION`: Major version to install (e.g. "20", "22", "24"). Default: "24".
-- `NODE_MODULE`: Optional npm package to install globally during setup (e.g. "pnpm", "yarn").
-
-**Example**:
-```bash
-NODE_VERSION="22" NODE_MODULE="pnpm" setup_nodejs
-```
-
----
-
-### setup_php()
-
-Install PHP with configurable extensions and FPM/Apache integration.
-
-**Signature**:
-```bash
-setup_php
-```
-
-**Environment Variables**:
-- `PHP_VERSION`: Version to install (e.g. "8.3", "8.4"). Default: "8.4".
-- `PHP_MODULE`: Comma-separated list of additional extensions.
-- `PHP_FPM`: Set to "YES" to install php-fpm.
-- `PHP_APACHE`: Set to "YES" to install libapache2-mod-php.
-
-**Example**:
-```bash
-PHP_VERSION="8.3" PHP_FPM="YES" PHP_MODULE="mysql,xml,zip" setup_php
-```
-
----
-
-### setup_mariadb_db()
-
-Creates a new MariaDB database and a dedicated user with all privileges. Automatically generates a password if not provided and saves it to a credentials file.
-
-**Environment Variables**:
-- `MARIADB_DB_NAME`: Name of the database (required)
-- `MARIADB_DB_USER`: Name of the database user (required)
-- `MARIADB_DB_PASS`: User password (optional, auto-generated if omitted)
-
-**Example**:
-```bash
-MARIADB_DB_NAME="myapp" MARIADB_DB_USER="myapp_user" setup_mariadb_db
-```
-
----
-
-### setup_postgresql_db()
-
-Creates a new PostgreSQL database and a dedicated user/role with all privileges. Automatically generates a password if not provided and saves it to a credentials file.
-
-**Environment Variables**:
-- `PG_DB_NAME`: Name of the database (required)
-- `PG_DB_USER`: Name of the database user (required)
-- `PG_DB_PASS`: User password (optional, auto-generated if omitted)
-
----
-
-### setup_java()
-
-Installs Temurin JDK.
-
-**Signature**:
-```bash
-JAVA_VERSION="21" setup_java
-```
-
-**Parameters**:
-- `JAVA_VERSION` - JDK version (e.g., "17", "21") (default: "21")
-
-**Example**:
-```bash
-JAVA_VERSION="17" setup_java
-```
-
----
-
-### setup_uv()
-
-Installs `uv` (modern Python package manager).
-
-**Signature**:
-```bash
-PYTHON_VERSION="3.13" setup_uv
-```
-
-**Parameters**:
-- `PYTHON_VERSION` - Optional Python version to pre-install via uv (e.g., "3.12", "3.13")
-
-**Example**:
-```bash
-PYTHON_VERSION="3.13" setup_uv
-```
-
----
-
-### setup_go()
-
-Installs Go programming language.
-
-**Signature**:
-```bash
-GO_VERSION="1.23" setup_go
-```
-
-**Parameters**:
-- `GO_VERSION` - Go version to install (default: "1.23")
-
-**Example**:
-```bash
-GO_VERSION="1.24" setup_go
-```
-
----
-
-### setup_yq()
-
-Installs `yq` (YAML processor).
-
-**Signature**:
-```bash
-setup_yq
-```
-
-**Example**:
-```bash
-setup_yq
-```
-
----
-
-### setup_composer()
-
-Installs PHP Composer.
-
-**Signature**:
-```bash
-setup_composer
-```
-
-**Example**:
-```bash
-setup_composer
-```
-
----
-
-### setup_meilisearch()
-
-Install and configure Meilisearch search engine.
-
-**Environment Variables**:
-- `MEILISEARCH_BIND`: Address and port to bind to (Default: "127.0.0.1:7700")
-- `MEILISEARCH_ENV`: Environment mode (Default: "production")
-
----
-
-### setup_yq()
-
-Install the `mikefarah/yq` YAML processor. Removes existing non-compliant versions.
-
-**Example**:
-```bash
-setup_yq
-yq eval '.app.version = "1.0.0"' -i config.yaml
-```
-
----
-
-### setup_composer()
-
-Install or update the PHP Composer package manager. Handles `COMPOSER_ALLOW_SUPERUSER` automatically and performs self-updates if already installed.
-
-**Example**:
-```bash
-setup_php
-setup_composer
-$STD composer install --no-dev
-```
-
----
-
-### setup_build_tools()
-
-Install the `build-essential` package suite for compiling software.
-
----
-
-### setup_uv()
-
-Install the modern Python package manager `uv`. Extremely fast replacement for pip/venv.
-
-**Environment Variables**:
-- `PYTHON_VERSION`: Major.Minor version to ensure is installed.
-
-**Example**:
-```bash
-PYTHON_VERSION="3.12" setup_uv
-uv sync --locked
-```
-
----
-
-### setup_java()
-
-Install OpenJDK via the Adoptium repository.
-
-**Environment Variables**:
-- `JAVA_VERSION`: Major version to install (e.g. "17", "21"). Default: "21".
-
-**Example**:
-```bash
-JAVA_VERSION="21" setup_java
-```
-
----
-```bash
 setup_nodejs VERSION
 ```
 

docs/vm/README.md

@@ -40,15 +40,14 @@ vm/OsName-vm.sh (host-side)
 
 See `/vm` directory for all VM creation scripts. Examples:
 
-- `ubuntu2504-vm.sh` - Ubuntu 25.04 VM (Latest)
+- `ubuntu2404-vm.sh` - Ubuntu 24.04 VM
-- `ubuntu2404-vm.sh` - Ubuntu 24.04 VM (LTS)
+- `ubuntu2204-vm.sh` - Ubuntu 22.04 VM
-- `debian-13-vm.sh` - Debian 13 VM (Trixie)
+- `debian-vm.sh` - Debian VM
-- `archlinux-vm.sh` - Arch Linux VM
+- `debian-13-vm.sh` - Debian 13 VM
-- `haos-vm.sh` - Home Assistant OS
-- `mikrotik-routeros.sh` - MikroTik RouterOS
-- `openwrt-vm.sh` - OpenWrt VM
 - `opnsense-vm.sh` - OPNsense firewall
-- `umbrel-os-vm.sh` - Umbrel OS VM
+- `haos-vm.sh` - Home Assistant OS
+- `unifi-os-vm.sh` - Unifi Dream Machine
+- `k3s-vm.sh` - Kubernetes lightweight
 - And 10+ more...
 
 ## VM vs Container

frontend/public/json/github-versions.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-02-05T18:19:13Z",
+  "generated": "2026-02-02T06:25:10Z",
   "versions": [
     {
       "slug": "2fauth",
@@ -95,9 +95,9 @@
     {
       "slug": "bar-assistant",
       "repo": "karlomikus/bar-assistant",
-      "version": "v5.13.1",
+      "version": "v5.13.0",
       "pinned": false,
-      "date": "2026-02-02T18:47:43Z"
+      "date": "2026-02-01T15:49:21Z"
     },
     {
       "slug": "bazarr",
@@ -109,9 +109,9 @@
     {
       "slug": "bentopdf",
       "repo": "alam00000/bentopdf",
-      "version": "v2.1.0",
+      "version": "v2.0.0",
       "pinned": false,
-      "date": "2026-02-02T14:30:55Z"
+      "date": "2026-01-31T10:13:47Z"
     },
     {
       "slug": "beszel",
@@ -158,9 +158,9 @@
     {
       "slug": "bytestash",
       "repo": "jordan-dalby/ByteStash",
-      "version": "v1.5.11",
+      "version": "v1.5.10",
       "pinned": false,
-      "date": "2026-02-03T22:12:19Z"
+      "date": "2026-01-26T14:07:59Z"
     },
     {
       "slug": "caddy",
@@ -179,16 +179,16 @@
     {
       "slug": "cloudreve",
       "repo": "cloudreve/cloudreve",
-      "version": "4.13.0",
+      "version": "4.12.1",
       "pinned": false,
-      "date": "2026-02-05T12:53:24Z"
+      "date": "2026-01-28T07:29:16Z"
     },
     {
       "slug": "comfyui",
       "repo": "comfyanonymous/ComfyUI",
-      "version": "v0.12.3",
+      "version": "v0.11.1",
       "pinned": false,
-      "date": "2026-02-05T07:04:07Z"
+      "date": "2026-01-29T07:52:21Z"
     },
     {
       "slug": "commafeed",
@@ -221,9 +221,9 @@
     {
       "slug": "cronicle",
       "repo": "jhuckaby/Cronicle",
-      "version": "v0.9.105",
+      "version": "v0.9.102",
       "pinned": false,
-      "date": "2026-02-05T18:16:11Z"
+      "date": "2025-12-19T03:45:13Z"
     },
     {
       "slug": "cryptpad",
@@ -256,9 +256,9 @@
     {
       "slug": "docmost",
       "repo": "docmost/docmost",
-      "version": "v0.25.1",
+      "version": "v0.24.1",
       "pinned": false,
-      "date": "2026-02-04T15:19:51Z"
+      "date": "2025-12-14T13:49:16Z"
     },
     {
       "slug": "domain-locker",
@@ -291,9 +291,9 @@
     {
       "slug": "elementsynapse",
       "repo": "etkecc/synapse-admin",
-      "version": "v0.11.1-etke53",
+      "version": "v0.11.1-etke52",
       "pinned": false,
-      "date": "2026-02-03T20:38:15Z"
+      "date": "2026-01-09T08:41:29Z"
     },
     {
       "slug": "emby",
@@ -312,9 +312,9 @@
     {
       "slug": "ersatztv",
       "repo": "ErsatzTV/ErsatzTV",
-      "version": "v26.2.0",
+      "version": "v26.1.1",
       "pinned": false,
-      "date": "2026-02-02T20:54:26Z"
+      "date": "2026-01-08T22:02:15Z"
     },
     {
       "slug": "excalidraw",
@@ -375,9 +375,9 @@
     {
       "slug": "ghostfolio",
       "repo": "ghostfolio/ghostfolio",
-      "version": "2.235.0",
+      "version": "2.234.0",
       "pinned": false,
-      "date": "2026-02-03T19:27:17Z"
+      "date": "2026-01-30T19:00:22Z"
     },
     {
       "slug": "gitea",
@@ -445,9 +445,9 @@
     {
       "slug": "headscale",
       "repo": "juanfont/headscale",
-      "version": "v0.28.0",
+      "version": "v0.27.1",
       "pinned": false,
-      "date": "2026-02-04T20:40:23Z"
+      "date": "2025-11-11T19:32:29Z"
     },
     {
       "slug": "healthchecks",
@@ -494,9 +494,9 @@
     {
       "slug": "homepage",
       "repo": "gethomepage/homepage",
-      "version": "v1.10.1",
+      "version": "v1.9.0",
       "pinned": false,
-      "date": "2026-02-05T15:03:45Z"
+      "date": "2026-01-19T05:46:09Z"
     },
     {
       "slug": "homer",
@@ -515,9 +515,9 @@
     {
       "slug": "huntarr",
       "repo": "plexguide/Huntarr.io",
-      "version": "9.2.1",
+      "version": "9.1.8",
       "pinned": false,
-      "date": "2026-02-05T16:39:35Z"
+      "date": "2026-02-02T01:29:45Z"
     },
     {
       "slug": "inspircd",
@@ -536,16 +536,16 @@
     {
       "slug": "invoiceninja",
       "repo": "invoiceninja/invoiceninja",
-      "version": "v5.12.55",
+      "version": "v5.12.52",
       "pinned": false,
-      "date": "2026-02-05T01:06:15Z"
+      "date": "2026-02-01T02:08:10Z"
     },
     {
       "slug": "jackett",
       "repo": "Jackett/Jackett",
-      "version": "v0.24.1032",
+      "version": "v0.24.1008",
       "pinned": false,
-      "date": "2026-02-05T05:55:27Z"
+      "date": "2026-02-02T05:55:21Z"
     },
     {
       "slug": "joplin-server",
@@ -596,13 +596,6 @@
       "pinned": false,
       "date": "2026-01-31T18:10:59Z"
     },
-    {
-      "slug": "kitchenowl",
-      "repo": "TomBursch/kitchenowl",
-      "version": "v0.7.6",
-      "pinned": false,
-      "date": "2026-01-24T01:21:14Z"
-    },
     {
       "slug": "koel",
       "repo": "koel/koel",
@@ -669,9 +662,9 @@
     {
       "slug": "libretranslate",
       "repo": "LibreTranslate/LibreTranslate",
-      "version": "v1.8.4",
+      "version": "v1.8.3",
       "pinned": false,
-      "date": "2026-02-02T17:45:16Z"
+      "date": "2025-12-04T21:07:00Z"
     },
     {
       "slug": "lidarr",
@@ -746,9 +739,9 @@
     {
       "slug": "mealie",
       "repo": "mealie-recipes/mealie",
-      "version": "v3.10.2",
+      "version": "v3.9.2",
       "pinned": false,
-      "date": "2026-02-04T23:32:32Z"
+      "date": "2026-01-02T19:40:09Z"
     },
     {
       "slug": "mediamanager",
@@ -767,9 +760,9 @@
     {
       "slug": "meilisearch",
       "repo": "riccox/meilisearch-ui",
-      "version": "v0.15.1",
+      "version": "v0.15.0",
       "pinned": false,
-      "date": "2026-02-04T03:56:59Z"
+      "date": "2026-01-29T03:54:27Z"
     },
     {
       "slug": "memos",
@@ -781,9 +774,9 @@
     {
       "slug": "metube",
       "repo": "alexta69/metube",
-      "version": "2026.02.04",
+      "version": "2026.02.01",
       "pinned": false,
-      "date": "2026-02-04T20:01:18Z"
+      "date": "2026-02-01T00:20:00Z"
     },
     {
       "slug": "miniflux",
@@ -823,23 +816,16 @@
     {
       "slug": "navidrome",
       "repo": "navidrome/navidrome",
-      "version": "v0.60.0",
+      "version": "v0.59.0",
       "pinned": false,
-      "date": "2026-02-03T18:57:04Z"
+      "date": "2025-12-06T18:08:42Z"
     },
     {
       "slug": "netbox",
       "repo": "netbox-community/netbox",
-      "version": "v4.5.2",
+      "version": "v4.5.1",
       "pinned": false,
-      "date": "2026-02-03T13:54:26Z"
+      "date": "2026-01-20T19:45:05Z"
-    },
-    {
-      "slug": "nginx-ui",
-      "repo": "0xJacky/nginx-ui",
-      "version": "v2.3.2",
-      "pinned": false,
-      "date": "2025-12-09T09:47:15Z"
     },
     {
       "slug": "nocodb",
@@ -883,19 +869,12 @@
       "pinned": false,
       "date": "2026-01-17T12:24:31Z"
     },
-    {
-      "slug": "opencloud",
-      "repo": "opencloud-eu/opencloud",
-      "version": "v5.0.1",
-      "pinned": true,
-      "date": "2026-01-28T15:08:23Z"
-    },
     {
       "slug": "opengist",
       "repo": "thomiceli/opengist",
-      "version": "v1.12.1",
+      "version": "v1.12.0",
       "pinned": false,
-      "date": "2026-02-03T09:00:43Z"
+      "date": "2026-01-27T15:31:57Z"
     },
     {
       "slug": "ots",
@@ -1068,9 +1047,9 @@
     {
       "slug": "prometheus-alertmanager",
       "repo": "prometheus/alertmanager",
-      "version": "v0.31.0",
+      "version": "v0.30.1",
       "pinned": false,
-      "date": "2026-02-02T13:34:15Z"
+      "date": "2026-01-12T23:30:06Z"
     },
     {
       "slug": "prometheus-blackbox-exporter",
@@ -1110,9 +1089,9 @@
     {
       "slug": "pulse",
       "repo": "rcourtman/Pulse",
-      "version": "v5.1.2",
+      "version": "v5.0.17",
       "pinned": false,
-      "date": "2026-02-05T00:18:57Z"
+      "date": "2026-01-20T19:07:30Z"
     },
     {
       "slug": "pve-scripts-local",
@@ -1198,13 +1177,6 @@
       "pinned": false,
       "date": "2026-01-12T05:38:30Z"
     },
-    {
-      "slug": "rustypaste",
-      "repo": "orhun/rustypaste",
-      "version": "v0.16.1",
-      "pinned": false,
-      "date": "2025-03-21T20:44:47Z"
-    },
     {
       "slug": "sabnzbd",
       "repo": "sabnzbd/sabnzbd",
@@ -1215,9 +1187,9 @@
     {
       "slug": "scanopy",
       "repo": "scanopy/scanopy",
-      "version": "v0.14.3",
+      "version": "v0.14.0",
       "pinned": false,
-      "date": "2026-02-04T01:41:01Z"
+      "date": "2026-02-01T17:02:37Z"
     },
     {
       "slug": "scraparr",
@@ -1285,16 +1257,16 @@
     {
       "slug": "speedtest-tracker",
       "repo": "alexjustesen/speedtest-tracker",
-      "version": "v1.13.8",
+      "version": "v1.13.5",
       "pinned": false,
-      "date": "2026-02-04T19:24:23Z"
+      "date": "2026-01-08T22:35:28Z"
     },
     {
       "slug": "spoolman",
       "repo": "Donkie/Spoolman",
-      "version": "v0.23.1",
+      "version": "v0.23.0",
       "pinned": false,
-      "date": "2026-02-03T19:03:55Z"
+      "date": "2026-01-23T20:42:34Z"
     },
     {
       "slug": "sportarr",
@@ -1306,9 +1278,9 @@
     {
       "slug": "stirling-pdf",
       "repo": "Stirling-Tools/Stirling-PDF",
-      "version": "v2.4.4",
+      "version": "v2.4.3",
       "pinned": false,
-      "date": "2026-02-05T00:15:53Z"
+      "date": "2026-01-31T22:19:14Z"
     },
     {
       "slug": "streamlink-webui",
@@ -1369,9 +1341,9 @@
     {
       "slug": "thingsboard",
       "repo": "thingsboard/thingsboard",
-      "version": "v4.3.0.1",
+      "version": "v4.3",
       "pinned": false,
-      "date": "2026-02-03T12:39:14Z"
+      "date": "2026-01-20T14:27:07Z"
     },
     {
       "slug": "threadfin",
@@ -1383,9 +1355,9 @@
     {
       "slug": "tianji",
       "repo": "msgbyte/tianji",
-      "version": "v1.31.10",
+      "version": "v1.31.9",
       "pinned": false,
-      "date": "2026-02-04T17:21:04Z"
+      "date": "2026-01-31T18:22:40Z"
     },
     {
       "slug": "traccar",
@@ -1425,9 +1397,9 @@
     {
       "slug": "trip",
       "repo": "itskovacs/TRIP",
-      "version": "1.38.1",
+      "version": "1.38.0",
       "pinned": false,
-      "date": "2026-02-04T18:10:15Z"
+      "date": "2026-01-31T15:56:30Z"
     },
     {
       "slug": "tududi",
@@ -1439,9 +1411,9 @@
     {
       "slug": "tunarr",
       "repo": "chrisbenincasa/tunarr",
-      "version": "v1.1.12",
+      "version": "v1.1.11",
       "pinned": false,
-      "date": "2026-02-03T20:19:00Z"
+      "date": "2026-01-30T22:34:30Z"
     },
     {
       "slug": "uhf",
@@ -1485,19 +1457,12 @@
       "pinned": false,
       "date": "2025-10-22T17:03:54Z"
     },
-    {
-      "slug": "vaultwarden",
-      "repo": "dani-garcia/vaultwarden",
-      "version": "1.35.2",
-      "pinned": false,
-      "date": "2026-01-09T18:37:04Z"
-    },
     {
       "slug": "victoriametrics",
       "repo": "VictoriaMetrics/VictoriaMetrics",
-      "version": "v1.135.0",
+      "version": "v1.134.0",
       "pinned": false,
-      "date": "2026-02-02T14:20:15Z"
+      "date": "2026-01-19T13:29:43Z"
     },
     {
       "slug": "vikunja",
@@ -1523,9 +1488,9 @@
     {
       "slug": "wanderer",
       "repo": "meilisearch/meilisearch",
-      "version": "v1.35.0",
+      "version": "v1.34.3",
       "pinned": false,
-      "date": "2026-02-02T09:57:03Z"
+      "date": "2026-01-28T17:52:24Z"
     },
     {
       "slug": "warracker",
@@ -1555,13 +1520,6 @@
       "pinned": false,
       "date": "2025-12-31T16:53:34Z"
     },
-    {
-      "slug": "wealthfolio",
-      "repo": "afadil/wealthfolio",
-      "version": "v2.1.0",
-      "pinned": false,
-      "date": "2025-12-01T21:57:36Z"
-    },
     {
       "slug": "web-check",
       "repo": "CrazyWolf13/web-check",
@@ -1576,13 +1534,6 @@
       "pinned": false,
       "date": "2026-01-08T09:50:00Z"
     },
-    {
-      "slug": "wishlist",
-      "repo": "cmintey/wishlist",
-      "version": "v0.59.0",
-      "pinned": false,
-      "date": "2026-01-19T16:42:14Z"
-    },
     {
       "slug": "wizarr",
       "repo": "wizarrrr/wizarr",
@@ -1590,13 +1541,6 @@
       "pinned": false,
       "date": "2025-12-09T14:30:23Z"
     },
-    {
-      "slug": "writefreely",
-      "repo": "writefreely/writefreely",
-      "version": "v0.16.0",
-      "pinned": false,
-      "date": "2025-08-29T19:30:02Z"
-    },
     {
       "slug": "yt-dlp-webui",
       "repo": "marcopiovanello/yt-dlp-web-ui",
@@ -1642,9 +1586,9 @@
     {
       "slug": "zwave-js-ui",
       "repo": "zwave-js/zwave-js-ui",
-      "version": "v11.11.0",
+      "version": "v11.10.1",
       "pinned": false,
-      "date": "2026-02-03T13:13:05Z"
+      "date": "2026-01-15T15:58:06Z"
     }
   ]
 }

frontend/public/json/immich-public-proxy.json

@@ -1,44 +0,0 @@
-{
-  "name": "Immich Public Proxy",
-  "slug": "immich-public-proxy",
-  "categories": [
-    21
-  ],
-  "date_created": "2026-02-04",
-  "type": "addon",
-  "updateable": true,
-  "privileged": false,
-  "interface_port": 3000,
-  "documentation": "https://github.com/alangrainger/immich-public-proxy/tree/main/docs",
-  "website": "https://github.com/alangrainger/immich-public-proxy",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/immich-public-proxy.webp",
-  "config_path": "/opt/immich-proxy/app/.env",
-  "description": "Share your Immich photos and albums in a safe way without exposing your Immich instance to the public.",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "tools/addon/immich-public-proxy.sh",
-      "resources": {
-        "cpu": null,
-        "ram": null,
-        "hdd": null,
-        "os": null,
-        "version": null
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": null,
-    "password": null
-  },
-  "notes": [
-    {
-      "text": "Requires Node.js 24+",
-      "type": "info"
-    },
-    {
-      "text": "Update with: update_immich-public-proxy",
-      "type": "info"
-    }
-  ]
-}

frontend/public/json/nginx-ui.json

@@ -1,48 +0,0 @@
-{
-    "name": "Nginx UI",
-    "slug": "nginx-ui",
-    "categories": [
-        21
-    ],
-    "date_created": "2026-02-05",
-    "type": "ct",
-    "updateable": true,
-    "privileged": false,
-    "interface_port": 9000,
-    "documentation": "https://nginxui.com/guide/",
-    "website": "https://nginxui.com",
-    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/nginx-ui.webp",
-    "config_path": "/usr/local/etc/nginx-ui/app.ini",
-    "description": "Nginx UI is a comprehensive web-based interface designed to simplify the management and configuration of Nginx servers. It provides features like online statistics, ChatGPT-powered config assistant, automatic Let's Encrypt certificates, and config file editing with syntax highlighting.",
-    "install_methods": [
-        {
-            "type": "default",
-            "script": "ct/nginx-ui.sh",
-            "resources": {
-                "cpu": 1,
-                "ram": 512,
-                "hdd": 4,
-                "os": "Debian",
-                "version": "13"
-            }
-        }
-    ],
-    "default_credentials": {
-        "username": "admin",
-        "password": null
-    },
-    "notes": [
-        {
-            "text": "Nginx runs on ports 80/443, Nginx UI management interface on port 9000.",
-            "type": "info"
-        },
-        {
-            "text": "SSL certificates can be managed automatically with Let's Encrypt integration.",
-            "type": "info"
-        },
-        {
-            "text": "Initial Login data: `cat ~/nginx-ui.creds`",
-            "type": "info"
-        }
-    ]
-}

frontend/public/json/nginxproxymanager.json

@@ -13,8 +13,6 @@
   "website": "https://nginxproxymanager.com/",
   "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/nginx-proxy-manager.webp",
   "config_path": "",
-  "disable": true,
-  "disable_description": "This script is temporarily disabled due to an external issue with the OpenResty APT repository. The repository's GPG key uses SHA-1 signatures, which are no longer accepted by Debian as of February 1, 2026. This causes installation to fail with APT errors. The issue is tracked in openresty/openresty#1097. A workaround exists but requires manual configuration. The script will be re-enabled once OpenResty updates their repository signing key. For more details, see: https://github.com/community-scripts/ProxmoxVE/issues/11406",
   "description": "Nginx Proxy Manager is a tool that provides a web-based interface to manage Nginx reverse proxies. It enables users to easily and securely expose their services to the internet by providing features such as HTTPS encryption, domain mapping, and access control. It eliminates the need for manual configuration of Nginx reverse proxies, making it easy for users to quickly and securely expose their services to the public.",
   "install_methods": [
     {

frontend/public/json/opencloud.json

@@ -1,64 +0,0 @@
-{
-  "name": "OpenCloud",
-  "slug": "opencloud",
-  "categories": [
-    11
-  ],
-  "date_created": "2026-02-05",
-  "type": "ct",
-  "updateable": true,
-  "privileged": false,
-  "interface_port": 443,
-  "documentation": "https://docs.opencloud.eu",
-  "config_path": "/etc/opencloud/opencloud.env, /etc/opencloud/opencloud.yaml, /etc/opencloud/csp.yaml",
-  "website": "https://opencloud.eu",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/opencloud.webp",
-  "description": "OpenCloud is the file sharing and collaboration solution of the Heinlein Group. Through intelligent file management and a strong open source community, files become valuable resources, effectively structured and usable in the long term. With flexible data rooms and intelligent access rights, teams can access and work together on data anytime, anywhere without barriers, but with a lot of productivity.",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "ct/opencloud.sh",
-      "resources": {
-        "cpu": 2,
-        "ram": 2048,
-        "hdd": 20,
-        "os": "Debian",
-        "version": "13"
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": "admin",
-    "password": "randomly generated during the installation process"
-  },
-  "notes": [
-    {
-      "text": "Valid TLS certificates and fully-qualified domain names behind a reverse proxy (Caddy) for 3 services - OpenCloud, Collabora, and WOPI are **REQUIRED**",
-      "type": "warning"
-    },
-    {
-      "text": "Forgot your admin password? Check `admin_password` in the 'idm' section in `/etc/opencloud/opencloud.yaml`",
-      "type": "info"
-    },
-    {
-      "text": "**Optional External Apps**: extract zip archives from App Store to `/etc/opencloud/assets/apps`",
-      "type": "info"
-    },
-    {
-      "text": "**Optional CalDAV and CardDAV**: requires separate Radicale install. Edit and rename `/opt/opencloud/proxy.yaml.bak` and change your Radicale config to use `http_x_remote_user` as the auth method",
-      "type": "info"
-    },
-    {
-      "text": "**Optional OpenID**: Authelia and PocketID supported. Uncomment relevant lines in `/opt/opencloud/opencloud.env` and consult OpenCloud GitHub discussions for configuration tips",
-      "type": "info"
-    },
-    {
-      "text": "**Optional Full-text Search with Apache Tika**: requires your own Tika LXC. See `https://community-scripts.github.io/ProxmoxVE/scripts?id=apache-tika`",
-      "type": "info"
-    },
-    {
-      "text": "**Relevant services**: `opencloud.service`, `opencloud-wopi.service`, `coolwsd.service`",
-      "type": "info"
-    }
-  ]
-}

frontend/public/json/rustypaste.json

@@ -1,51 +0,0 @@
-{
-  "name": "RustyPaste",
-  "slug": "rustypaste",
-  "categories": [
-    11
-  ],
-  "date_created": "2026-02-02",
-  "type": "ct",
-  "updateable": true,
-  "privileged": false,
-  "interface_port": 8000,
-  "documentation": "https://github.com/orhun/rustypaste",
-  "config_path": "/opt/rustypaste/config.toml",
-  "website": "https://github.com/orhun/rustypaste",
-  "logo": "https://github.com/orhun/rustypaste/raw/master/img/rustypaste_logo.png",
-  "description": "Rustypaste is a minimal file upload/pastebin service.",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "ct/rustypaste.sh",
-      "resources": {
-        "cpu": 1,
-        "ram": 1024,
-        "hdd": 20,
-        "os": "Debian",
-        "version": "13"
-      }
-    },
-    {
-      "type": "alpine",
-      "script": "ct/alpine-rustypaste.sh",
-      "resources": {
-        "cpu": 1,
-        "ram": 256,
-        "hdd": 4,
-        "os": "Alpine",
-        "version": "3.23"
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": null,
-    "password": null
-  },
-  "notes": [
-    {
-      "text": "When updating the script it will backup the whole project including all the uploaded files, make sure to extract it to a safe location or remove",
-      "type": "info"
-    }
-  ]
-}

frontend/public/json/scanopy.json

@@ -37,7 +37,7 @@
       "type": "info"
     },
     {
-      "text": "The integrated daemon config is located at `/root/.config/daemon/`",
+      "text": "The integrated daemon config is located at `/root/.config/daemon/config.json`",
       "type": "info"
     }
   ]

frontend/public/json/sqlserver2025.json

@@ -1,52 +0,0 @@
-{
-  "name": "SQL Server 2025",
-  "slug": "sqlserver2025",
-  "categories": [
-    8
-  ],
-  "date_created": "2026-02-05",
-  "type": "ct",
-  "updateable": true,
-  "privileged": true,
-  "interface_port": 1433,
-  "documentation": "https://learn.microsoft.com/en-us/sql/sql-server/?view=sql-server-ver17",
-  "website": "https://www.microsoft.com/en-us/sql-server/sql-server-2025",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/microsoft-sql-server.webp",
-  "config_path": "",
-  "description": "Script to automatically set up a SQL Server 2025 installation with Ubuntu 24.04 support.",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "ct/sqlserver2025.sh",
-      "resources": {
-        "cpu": 2,
-        "ram": 2048,
-        "hdd": 10,
-        "os": "Ubuntu",
-        "version": "24.04"
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": null,
-    "password": null
-  },
-  "notes": [
-    {
-      "text": "If you choose not to run the installation setup, execute: `/opt/mssql/bin/mssql-conf setup` in LXC shell.",
-      "type": "info"
-    },
-    {
-      "text": "You can setup the admin account 'SA' during installation",
-      "type": "info"
-    },
-    {
-      "text": "Make sure you disable the SA account if you intend to use this in production!",
-      "type": "warning"
-    },
-    {
-      "text": "Ubuntu 24.04 support requires SQL Server 2025 CU1 or later",
-      "type": "info"
-    }
-  ]
-}

frontend/public/json/wealthfolio.json

@@ -1,40 +0,0 @@
-{
-    "name": "Wealthfolio",
-    "slug": "wealthfolio",
-    "categories": [
-        23
-    ],
-    "date_created": "2026-02-03",
-    "type": "ct",
-    "updateable": true,
-    "privileged": false,
-    "interface_port": 8080,
-    "documentation": "https://wealthfolio.app/docs/introduction/",
-    "config_path": "/opt/wealthfolio/.env",
-    "website": "https://wealthfolio.app/",
-    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/wealthfolio.webp",
-    "description": "Wealthfolio is a beautiful, privacy-focused investment tracker with local data storage. Track your portfolio across multiple accounts and asset types with detailed performance analytics, goal planning, and multi-currency support.",
-    "install_methods": [
-        {
-            "type": "default",
-            "script": "ct/wealthfolio.sh",
-            "resources": {
-                "cpu": 4,
-                "ram": 4096,
-                "hdd": 10,
-                "os": "Debian",
-                "version": "13"
-            }
-        }
-    ],
-    "default_credentials": {
-        "username": null,
-        "password": "See ~/wealthfolio.creds"
-    },
-    "notes": [
-        {
-            "text": "Login password is stored in ~/wealthfolio.creds",
-            "type": "info"
-        }
-    ]
-}

frontend/public/json/wishlist.json

@@ -1,35 +0,0 @@
-{
-    "name": "Wishlist",
-    "slug": "wishlist",
-    "categories": [
-        12
-    ],
-    "date_created": "2026-02-04",
-    "type": "ct",
-    "updateable": true,
-    "privileged": false,
-    "interface_port": 3280,
-    "documentation": "https://github.com/cmintey/wishlist/blob/main/README.md#getting-started",
-    "config_path": "/opt/wishlist/.env",
-    "website": "https://github.com/cmintey/wishlist",
-    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/cmintey-wishlist.webp",
-    "description": "Wishlist is a self-hosted wishlist application that you can share with your friends and family. You no longer have to wonder what to get your family for the holidays, simply check their wishlist and claim any available item!",
-    "install_methods": [
-        {
-            "type": "default",
-            "script": "ct/wishlist.sh",
-            "resources": {
-                "cpu": 2,
-                "ram": 2048,
-                "hdd": 5,
-                "os": "Debian",
-                "version": "13"
-            }
-        }
-    ],
-    "default_credentials": {
-        "username": null,
-        "password": null
-    },
-    "notes": []
-}

frontend/public/json/writefreely.json

@@ -1,40 +0,0 @@
-{
-    "name": "WriteFreely",
-    "slug": "writefreely",
-    "categories": [
-        12
-    ],
-    "date_created": "2026-02-04",
-    "type": "ct",
-    "updateable": true,
-    "privileged": false,
-    "interface_port": 80,
-    "documentation": "https://writefreely.org/docs",
-    "config_path": "/opt/writefreely/config.ini",
-    "website": "https://writefreely.org/",
-    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/writefreely-light.webp",
-    "description": "WriteFreely is free and open source software for easily publishing writing on the web with support for the ActivityPub protocol. Use it to start a personal blog — or an entire community.",
-    "install_methods": [
-        {
-            "type": "default",
-            "script": "ct/writefreely.sh",
-            "resources": {
-                "cpu": 2,
-                "ram": 1024,
-                "hdd": 4,
-                "os": "Debian",
-                "version": "13"
-            }
-        }
-    ],
-    "default_credentials": {
-        "username": null,
-        "password": null
-    },
-    "notes": [
-        {
-            "text": "After installation execute `writefreely user create --admin <username>:<password>` to create your user.",
-            "type": "info"
-        }
-    ]
-}

frontend/src/app/category-view/page.tsx

@@ -0,0 +1,320 @@
+"use client";
+
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import React, { useEffect, useState } from "react";
+import { useRouter } from "next/navigation";
+
+import type { Category } from "@/lib/types";
+
+import { Card, CardContent } from "@/components/ui/card";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+
+const defaultLogo = "/default-logo.png"; // Fallback logo path
+const MAX_DESCRIPTION_LENGTH = 100; // Set max length for description
+const MAX_LOGOS = 5; // Max logos to display at once
+
+function formattedBadge(type: string) {
+  switch (type) {
+    case "vm":
+      return <Badge className="text-blue-500/75 border-blue-500/75 badge">VM</Badge>;
+    case "ct":
+      return <Badge className="text-yellow-500/75 border-yellow-500/75 badge">LXC</Badge>;
+    case "pve":
+      return <Badge className="text-orange-500/75 border-orange-500/75 badge">PVE</Badge>;
+    case "addon":
+      return <Badge className="text-green-500/75 border-green-500/75 badge">ADDON</Badge>;
+  }
+  return null;
+}
+
+function CategoryView() {
+  const [categories, setCategories] = useState<Category[]>([]);
+  const [selectedCategoryIndex, setSelectedCategoryIndex] = useState<number | null>(null);
+  const [currentScripts, setCurrentScripts] = useState<any[]>([]);
+  const [logoIndices, setLogoIndices] = useState<{ [key: string]: number }>({});
+  const router = useRouter();
+
+  useEffect(() => {
+    const fetchCategories = async () => {
+      try {
+        // eslint-disable-next-line node/no-process-env
+        const basePath = process.env.NODE_ENV === "production" ? "/ProxmoxVE" : "";
+        const response = await fetch(`${basePath}/api/categories`);
+        if (!response.ok) {
+          throw new Error("Failed to fetch categories");
+        }
+        const data = await response.json();
+        setCategories(data);
+
+        // Initialize logo indices
+        const initialLogoIndices: { [key: string]: number } = {};
+        data.forEach((category: any) => {
+          initialLogoIndices[category.name] = 0;
+        });
+        setLogoIndices(initialLogoIndices);
+      }
+      catch (error) {
+        console.error("Error fetching categories:", error);
+      }
+    };
+
+    fetchCategories();
+  }, []);
+
+  const handleCategoryClick = (index: number) => {
+    setSelectedCategoryIndex(index);
+    setCurrentScripts(categories[index]?.scripts || []); // Update scripts for the selected category
+  };
+
+  const handleBackClick = () => {
+    setSelectedCategoryIndex(null);
+    setCurrentScripts([]); // Clear scripts when going back
+  };
+
+  const handleScriptClick = (scriptSlug: string) => {
+    // Include category context when navigating to scripts
+    const categoryName = selectedCategoryIndex !== null ? categories[selectedCategoryIndex]?.name : null;
+    const queryParams = new URLSearchParams({ id: scriptSlug });
+    if (categoryName) {
+      queryParams.append("category", categoryName);
+    }
+    router.push(`/scripts?${queryParams.toString()}`);
+  };
+
+  const navigateCategory = (direction: "prev" | "next") => {
+    if (selectedCategoryIndex !== null) {
+      const newIndex
+        = direction === "prev"
+          ? (selectedCategoryIndex - 1 + categories.length) % categories.length
+          : (selectedCategoryIndex + 1) % categories.length;
+      setSelectedCategoryIndex(newIndex);
+      setCurrentScripts(categories[newIndex]?.scripts || []); // Update scripts for the new category
+    }
+  };
+
+  const switchLogos = (categoryName: string, direction: "prev" | "next") => {
+    setLogoIndices((prev) => {
+      const currentIndex = prev[categoryName] || 0;
+      const category = categories.find(cat => cat.name === categoryName);
+      if (!category || !category.scripts)
+        return prev;
+
+      const totalLogos = category.scripts.length;
+      const newIndex
+        = direction === "prev"
+          ? (currentIndex - MAX_LOGOS + totalLogos) % totalLogos
+          : (currentIndex + MAX_LOGOS) % totalLogos;
+
+      return { ...prev, [categoryName]: newIndex };
+    });
+  };
+
+  const truncateDescription = (text: string) => {
+    return text.length > MAX_DESCRIPTION_LENGTH ? `${text.slice(0, MAX_DESCRIPTION_LENGTH)}...` : text;
+  };
+
+  const renderResources = (script: any) => {
+    const cpu = script.install_methods[0]?.resources.cpu;
+    const ram = script.install_methods[0]?.resources.ram;
+    const hdd = script.install_methods[0]?.resources.hdd;
+
+    const resourceParts = [];
+    if (cpu) {
+      resourceParts.push(
+        <span key="cpu">
+          <b>CPU:</b>
+          {" "}
+          {cpu}
+          vCPU
+        </span>,
+      );
+    }
+    if (ram) {
+      resourceParts.push(
+        <span key="ram">
+          <b>RAM:</b>
+          {" "}
+          {ram}
+          MB
+        </span>,
+      );
+    }
+    if (hdd) {
+      resourceParts.push(
+        <span key="hdd">
+          <b>HDD:</b>
+          {" "}
+          {hdd}
+          GB
+        </span>,
+      );
+    }
+
+    return resourceParts.length > 0
+      ? (
+          <div className="text-sm text-gray-400">
+            {resourceParts.map((part, index) => (
+              <React.Fragment key={index}>
+                {part}
+                {index < resourceParts.length - 1 && " | "}
+              </React.Fragment>
+            ))}
+          </div>
+        )
+      : null;
+  };
+
+  return (
+    <div className="p-6 mt-20">
+      {categories.length === 0 && (
+        <p className="text-center text-gray-500">No categories available. Please check the API endpoint.</p>
+      )}
+      {selectedCategoryIndex !== null
+        ? (
+            <div>
+              {/* Header with Navigation */}
+              <div className="flex items-center justify-between mb-6">
+                <Button
+                  variant="ghost"
+                  onClick={() => navigateCategory("prev")}
+                  className="p-2 transition-transform duration-300 hover:scale-105"
+                >
+                  <ChevronLeft className="h-6 w-6" />
+                </Button>
+                <h2 className="text-3xl font-semibold transition-opacity duration-300 hover:opacity-90">
+                  {categories[selectedCategoryIndex].name}
+                </h2>
+                <Button
+                  variant="ghost"
+                  onClick={() => navigateCategory("next")}
+                  className="p-2 transition-transform duration-300 hover:scale-105"
+                >
+                  <ChevronRight className="h-6 w-6" />
+                </Button>
+              </div>
+
+              {/* Scripts Grid */}
+              <div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-6">
+                {currentScripts
+                  .sort((a, b) => a.name.localeCompare(b.name))
+                  .map(script => (
+                    <Card
+                      key={script.name}
+                      className="p-4 cursor-pointer hover:shadow-md transition-shadow duration-300"
+                      onClick={() => handleScriptClick(script.slug)}
+                    >
+                      <CardContent className="flex flex-col gap-4">
+                        <h3 className="text-lg font-bold script-text text-center hover:text-blue-600 transition-colors duration-300">
+                          {script.name}
+                        </h3>
+                        <img
+                          src={script.logo || defaultLogo}
+                          alt={script.name || "Script logo"}
+                          className="h-12 w-12 object-contain mx-auto"
+                        />
+                        <p className="text-sm text-gray-500 text-center">
+                          <b>Created at:</b>
+                          {" "}
+                          {script.date_created || "No date available"}
+                        </p>
+                        <p
+                          className="text-sm text-gray-700 hover:text-gray-900 text-center transition-colors duration-300"
+                          title={script.description || "No description available."}
+                        >
+                          {truncateDescription(script.description || "No description available.")}
+                        </p>
+                        {renderResources(script)}
+                      </CardContent>
+                    </Card>
+                  ))}
+              </div>
+
+              {/* Back to Categories Button */}
+              <div className="mt-8 text-center">
+                <Button
+                  variant="default"
+                  onClick={handleBackClick}
+                  className="px-6 py-2 text-white bg-blue-600 hover:bg-blue-700 rounded-lg shadow-md transition-transform duration-300 hover:scale-105"
+                >
+                  Back to Categories
+                </Button>
+              </div>
+            </div>
+          )
+        : (
+            <div>
+              {/* Categories Grid */}
+              <div className="flex justify-between items-center mb-8">
+                <h1 className="text-3xl font-semibold mb-4">Categories</h1>
+                <p className="text-sm text-gray-500">
+                  {categories.reduce((total, category) => total + (category.scripts?.length || 0), 0)}
+                  {" "}
+                  Total scripts
+                </p>
+              </div>
+              <div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-8">
+                {categories.map((category, index) => (
+                  <Card
+                    key={category.name}
+                    onClick={() => handleCategoryClick(index)}
+                    className="cursor-pointer hover:shadow-lg flex flex-col items-center justify-center py-6 transition-shadow duration-300"
+                  >
+                    <CardContent className="flex flex-col items-center">
+                      <h3 className="text-xl font-bold mb-4 category-title transition-colors duration-300 hover:text-blue-600">
+                        {category.name}
+                      </h3>
+                      <div className="flex justify-center items-center gap-2 mb-4">
+                        <Button
+                          variant="ghost"
+                          onClick={(e) => {
+                            e.stopPropagation();
+                            switchLogos(category.name, "prev");
+                          }}
+                          className="p-1 transition-transform duration-300 hover:scale-110"
+                        >
+                          <ChevronLeft className="h-4 w-4" />
+                        </Button>
+                        {category.scripts
+                          && category.scripts
+                            .slice(logoIndices[category.name] || 0, (logoIndices[category.name] || 0) + MAX_LOGOS)
+                            .map((script, i) => (
+                              <div key={i} className="flex flex-col items-center">
+                                <img
+                                  src={script.logo || defaultLogo}
+                                  alt={script.name || "Script logo"}
+                                  title={script.name}
+                                  className="h-8 w-8 object-contain cursor-pointer"
+                                  onClick={(e) => {
+                                    e.stopPropagation();
+                                    handleScriptClick(script.slug);
+                                  }}
+                                />
+                                {formattedBadge(script.type)}
+                              </div>
+                            ))}
+                        <Button
+                          variant="ghost"
+                          onClick={(e) => {
+                            e.stopPropagation();
+                            switchLogos(category.name, "next");
+                          }}
+                          className="p-1 transition-transform duration-300 hover:scale-110"
+                        >
+                          <ChevronRight className="h-4 w-4" />
+                        </Button>
+                      </div>
+                      <p className="text-sm text-gray-400 text-center">
+                        {(category as any).description || "No description available."}
+                      </p>
+                    </CardContent>
+                  </Card>
+                ))}
+              </div>
+            </div>
+          )}
+    </div>
+  );
+}
+
+export default CategoryView;

frontend/src/app/data/page.tsx

@@ -94,8 +94,7 @@ const chartConfigApps = {
 export default function DataPage() {
   const [data, setData] = useState<DataModel[]>([]);
   const [summary, setSummary] = useState<SummaryData | null>(null);
-  const [summaryLoading, setSummaryLoading] = useState<boolean>(true);
+  const [loading, setLoading] = useState<boolean>(true);
-  const [dataLoading, setDataLoading] = useState<boolean>(true);
   const [error, setError] = useState<string | null>(null);
   const [currentPage, setCurrentPage] = useState(1);
   const [itemsPerPage, setItemsPerPage] = useState(25);
@@ -106,40 +105,35 @@ export default function DataPage() {
 
   const nf = new Intl.NumberFormat("en-US", { maximumFractionDigits: 0 });
 
-  // Fetch summary only once on mount
   useEffect(() => {
-    const fetchSummary = async () => {
+    const fetchData = async () => {
+      setLoading(true);
       try {
-        const summaryRes = await fetch("https://api.htl-braunau.at/data/summary");
+        const [summaryRes, dataRes] = await Promise.all([
+          fetch("https://api.htl-braunau.at/data/summary"),
+          fetch(
+            `https://api.htl-braunau.at/data/paginated?page=${currentPage}&limit=${
+              itemsPerPage === 0 ? "" : itemsPerPage
+            }`,
+          ),
+        ]);
+
         if (!summaryRes.ok) {
           throw new Error(`Failed to fetch summary: ${summaryRes.statusText}`);
         }
-        const summaryData: SummaryData = await summaryRes.json();
-        setSummary(summaryData);
-      } catch (err) {
-        setError((err as Error).message);
-      } finally {
-        setSummaryLoading(false);
-      }
-    };
-
-    fetchSummary();
-  }, []);
-
-  useEffect(() => {
-    const fetchData = async () => {
-      setDataLoading(true);
-      try {
-        const dataRes = await fetch(`https://api.htl-braunau.at/data/paginated?page=${currentPage}&limit=${itemsPerPage}`);
         if (!dataRes.ok) {
           throw new Error(`Failed to fetch data: ${dataRes.statusText}`);
         }
+
+        const summaryData: SummaryData = await summaryRes.json();
         const pageData: DataModel[] = await dataRes.json();
+
+        setSummary(summaryData);
         setData(pageData);
       } catch (err) {
         setError((err as Error).message);
       } finally {
-        setDataLoading(false);
+        setLoading(false);
       }
     };
 
@@ -312,7 +306,7 @@ export default function DataPage() {
             </CardHeader>
             <CardContent className="pl-2">
               <div className="h-[300px] w-full">
-                {summaryLoading ? (
+                {loading ? (
                   <div className="flex h-full w-full items-center justify-center">
                     <Loader2 className="h-8 w-8 animate-spin text-muted-foreground" />
                   </div>
@@ -417,7 +411,7 @@ export default function DataPage() {
                     </TableRow>
                   </TableHeader>
                   <TableBody>
-                    {dataLoading ? (
+                    {loading ? (
                       <TableRow>
                         <TableCell colSpan={8} className="h-24 text-center">
                           <div className="flex items-center justify-center gap-2">
@@ -484,7 +478,7 @@ export default function DataPage() {
                   variant="outline"
                   size="sm"
                   onClick={() => setCurrentPage((prev) => Math.max(prev - 1, 1))}
-                  disabled={currentPage === 1 || dataLoading}
+                  disabled={currentPage === 1 || loading}
                 >
                   <ChevronLeft className="mr-2 h-4 w-4" />
                   Previous
@@ -494,7 +488,7 @@ export default function DataPage() {
                   variant="outline"
                   size="sm"
                   onClick={() => setCurrentPage((prev) => prev + 1)}
-                  disabled={dataLoading || sortedData.length < itemsPerPage}
+                  disabled={loading || sortedData.length < itemsPerPage}
                 >
                   Next
                   <ChevronRight className="ml-2 h-4 w-4" />

frontend/src/app/json-editor/_components/note.tsx

@@ -105,7 +105,7 @@ function Note({
   const addNote = useCallback(() => {
     setScript({
       ...script,
-      notes: [...script.notes, { text: "", type: "info" }],
+      notes: [...script.notes, { text: "", type: "" }],
     });
   }, [script, setScript]);
 

frontend/src/app/json-editor/_schemas/schemas.ts

@@ -1,5 +1,4 @@
 import { z } from "zod";
-import { AlertColors } from "@/config/site-config";
 
 export const InstallMethodSchema = z.object({
   type: z.enum(["default", "alpine"], {
@@ -17,9 +16,7 @@ export const InstallMethodSchema = z.object({
 
 const NoteSchema = z.object({
   text: z.string().min(1, "Note text cannot be empty"),
-  type: z.enum(Object.keys(AlertColors) as [keyof typeof AlertColors, ...(keyof typeof AlertColors)[]], {
+  type: z.string().min(1, "Note type cannot be empty"),
-    message: `Type must be one of: ${Object.keys(AlertColors).join(", ")}`,
-  }),
 });
 
 export const ScriptSchema = z.object({
@@ -45,7 +42,7 @@ export const ScriptSchema = z.object({
     username: z.string().nullable(),
     password: z.string().nullable(),
   }),
-  notes: z.array(NoteSchema).optional().default([]),
+  notes: z.array(NoteSchema),
 }).refine((data) => {
   if (data.disable === true && !data.disable_description) {
     return false;

frontend/src/app/json-editor/page.tsx

@@ -18,7 +18,6 @@ import { Button } from "@/components/ui/button";
 import { Switch } from "@/components/ui/switch";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { fetchCategories } from "@/lib/data";
 import { cn } from "@/lib/utils";
 
@@ -29,10 +28,8 @@ import { ScriptSchema } from "./_schemas/schemas";
 import Categories from "./_components/categories";
 import Note from "./_components/note";
 
-import { githubGist, nord } from "react-syntax-highlighter/dist/esm/styles/hljs";
+import { nord } from "react-syntax-highlighter/dist/esm/styles/hljs";
 import SyntaxHighlighter from "react-syntax-highlighter";
-import { ScriptItem } from "../scripts/_components/script-item";
-import { useTheme } from "next-themes";
 
 const initialScript: Script = {
   name: "",
@@ -59,12 +56,10 @@ const initialScript: Script = {
 };
 
 export default function JSONGenerator() {
-  const { theme } = useTheme();
   const [script, setScript] = useState<Script>(initialScript);
   const [isCopied, setIsCopied] = useState(false);
   const [isValid, setIsValid] = useState(false);
   const [categories, setCategories] = useState<Category[]>([]);
-  const [currentTab, setCurrentTab] = useState<"json" | "preview">("json");
   const [zodErrors, setZodErrors] = useState<z.ZodError | null>(null);
 
   useEffect(() => {
@@ -73,13 +68,6 @@ export default function JSONGenerator() {
       .catch((error) => console.error("Error fetching categories:", error));
   }, []);
 
-  useEffect(() => {
-    if (!isValid && currentTab === "preview") {
-      setCurrentTab("json");
-      toast.error("Switched to JSON tab due to invalid configuration.");
-    }
-  }, [isValid, currentTab]);
-
   const updateScript = useCallback((key: keyof Script, value: Script[keyof Script]) => {
     setScript((prev) => {
       const updated = { ...prev, [key]: value };
@@ -208,7 +196,7 @@ export default function JSONGenerator() {
             <Input
               placeholder="Path to config file"
               value={script.config_path || ""}
-              onChange={(e) => updateScript("config_path", e.target.value || "")}
+              onChange={(e) => updateScript("config_path", e.target.value || null)}
             />
           </div>
           <div>
@@ -335,41 +323,25 @@ export default function JSONGenerator() {
         </form>
       </div>
       <div className="w-1/2 p-4 bg-background overflow-y-auto">
-        <Tabs
+        {validationAlert}
-          defaultValue="json"
+        <div className="relative">
-          className="w-full"
+          <div className="absolute right-2 top-2 flex gap-1">
-          onValueChange={(value) => setCurrentTab(value as "json" | "preview")}
+            <Button size="icon" variant="outline" onClick={handleCopy}>
-          value={currentTab}
+              {isCopied ? <Check className="h-4 w-4" /> : <Clipboard className="h-4 w-4" />}
-        >
+            </Button>
-          <TabsList className="grid w-full grid-cols-2">
+            <Button size="icon" variant="outline" onClick={handleDownload}>
-            <TabsTrigger value="json">JSON</TabsTrigger>
+              <Download className="h-4 w-4" />
-            <TabsTrigger disabled={!isValid} value="preview">Preview</TabsTrigger>
+            </Button>
-          </TabsList>
+          </div>
-          <TabsContent value="json" className="h-full w-full">
-            {validationAlert}
-            <div className="relative">
-              <div className="absolute right-2 top-2 flex gap-1">
-                <Button size="icon" variant="outline" onClick={handleCopy}>
-                  {isCopied ? <Check className="h-4 w-4" /> : <Clipboard className="h-4 w-4" />}
-                </Button>
-                <Button size="icon" variant="outline" onClick={handleDownload}>
-                  <Download className="h-4 w-4" />
-                </Button>
-              </div>
 
-              <SyntaxHighlighter
+          <SyntaxHighlighter
-                language="json"
+            language="json"
-                style={theme === "light" ? githubGist : nord}
+            style={nord}
-                className="mt-4 p-4 bg-secondary rounded shadow overflow-x-scroll"
+            className="mt-4 p-4 bg-secondary rounded shadow overflow-x-scroll"
-              >
+          >
-                {JSON.stringify(script, null, 2)}
+            {JSON.stringify(script, null, 2)}
-              </SyntaxHighlighter>
+          </SyntaxHighlighter>
-            </div>
+        </div>
-          </TabsContent>
-          <TabsContent value="preview" className="h-full w-full">
-            <ScriptItem item={script} />
-          </TabsContent>
-        </Tabs>
       </div>
     </div>
   );

frontend/src/app/scripts/_components/script-item.tsx

@@ -4,8 +4,7 @@ import { X, HelpCircle } from "lucide-react";
 import { Suspense } from "react";
 import Image from "next/image";
 
-import type { AppVersion } from "@/lib/types";
+import type { AppVersion, Script } from "@/lib/types";
-import type { Script } from "@/app/json-editor/_schemas/schemas";
 
 import { Separator } from "@/components/ui/separator";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip";
@@ -27,6 +26,7 @@ import Alerts from "./script-items/alerts";
 
 type ScriptItemProps = {
   item: Script;
+  setSelectedScript: (script: string | null) => void;
 };
 
 function ScriptHeader({ item }: { item: Script }) {
@@ -135,10 +135,25 @@ function VersionInfo({ item }: { item: Script }) {
   );
 }
 
-export function ScriptItem({ item }: ScriptItemProps) {
+export function ScriptItem({ item, setSelectedScript }: ScriptItemProps) {
+  const closeScript = () => {
+    window.history.pushState({}, document.title, window.location.pathname);
+    setSelectedScript(null);
+  };
+
   return (
     <div className="w-full mx-auto">
       <div className="flex w-full flex-col">
+        <div className="mb-3 flex items-center justify-between">
+          <h2 className="text-2xl font-semibold tracking-tight text-foreground/90">Selected Script</h2>
+          <button
+            onClick={closeScript}
+            className="rounded-full p-2 text-muted-foreground hover:bg-card/50 transition-colors"
+          >
+            <X className="h-5 w-5" />
+          </button>
+        </div>
+
         <div className="rounded-xl border border-border bg-accent/30 backdrop-blur-sm shadow-sm">
           <div className="p-6 space-y-6">
             <Suspense fallback={<div className="animate-pulse h-32 bg-accent/20 rounded-xl" />}>
@@ -147,7 +162,7 @@ export function ScriptItem({ item }: ScriptItemProps) {
 
             {item.disable && item.disable_description && (
               <DisableDescription item={item} />
-            )}
+            ) }
 
             {!item.disable && (
               <>

frontend/src/app/scripts/page.tsx

@@ -1,6 +1,6 @@
 "use client";
 import { Suspense, useEffect, useState } from "react";
-import { Loader2, X } from "lucide-react";
+import { Loader2 } from "lucide-react";
 import { useQueryState } from "nuqs";
 
 import type { Category, Script } from "@/lib/types";
@@ -20,11 +20,6 @@ function ScriptContent() {
   const [item, setItem] = useState<Script>();
   const [latestPage, setLatestPage] = useState(1);
 
-  const closeScript = () => {
-    window.history.pushState({}, document.title, window.location.pathname);
-    setSelectedScript(null);
-  };
-
   useEffect(() => {
     if (selectedScript && links.length > 0) {
       const script = links
@@ -58,18 +53,7 @@ function ScriptContent() {
         <div className="px-4 w-full sm:max-w-[calc(100%-350px-16px)]">
           {selectedScript && item
             ? (
-                <div className="flex w-full flex-col">
+                <ScriptItem item={item} setSelectedScript={setSelectedScript} />
-                  <div className="mb-3 flex items-center justify-between">
-                    <h2 className="text-2xl font-semibold tracking-tight text-foreground/90">Selected Script</h2>
-                    <button
-                      onClick={closeScript}
-                      className="rounded-full p-2 text-muted-foreground hover:bg-card/50 transition-colors"
-                    >
-                      <X className="h-5 w-5" />
-                    </button>
-                  </div>
-                  <ScriptItem item={item} />
-                </div>
               )
             : (
                 <div className="flex w-full flex-col gap-5">

frontend/src/components/command-menu.tsx

@@ -23,34 +23,6 @@ import { Button } from "./ui/button";
 import { Badge } from "./ui/badge";
 import Link from "next/link";
 
-function search(scripts: Script[], query: string): Script[] {
-  const queryLower = query.toLowerCase().trim();
-  const searchWords = queryLower.split(/\s+/).filter(Boolean);
-
-  return scripts
-    .map(script => {
-      const nameLower = script.name.toLowerCase();
-      const descriptionLower = (script.description || "").toLowerCase();
-
-      let score = 0;
-
-      for (const word of searchWords) {
-        if (nameLower.includes(word)) {
-          score += 10;
-        }
-        if (descriptionLower.includes(word)) {
-          score += 5;
-        }
-      }
-
-      return { script, score };
-    })
-    .filter(({ score }) => score > 0)
-    .sort((a, b) => b.score - a.score)
-    .slice(0, 20)
-    .map(({ script }) => script);
-}
-
 export function formattedBadge(type: string) {
   switch (type) {
     case "vm":
@@ -79,11 +51,9 @@ function getRandomScript(categories: Category[], previouslySelected: Set<string>
 }
 
 function CommandMenu() {
-  const [query, setQuery] = React.useState("");
   const [open, setOpen] = React.useState(false);
   const [links, setLinks] = React.useState<Category[]>([]);
   const [isLoading, setIsLoading] = React.useState(false);
-  const [results, setResults] = React.useState<Script[]>([]);
   const [selectedScripts, setSelectedScripts] = React.useState<Set<string>>(new Set());
   const router = useRouter();
 
@@ -100,27 +70,6 @@ function CommandMenu() {
       });
   };
 
-  React.useEffect(() => {
-    if (query.trim() === "") {
-      fetchSortedCategories();
-    }
-    else {
-      const scriptMap = new Map<string, Script>();
-
-      for (const category of links) {
-        for (const script of category.scripts || []) {
-          if (!scriptMap.has(script.slug)) {
-            scriptMap.set(script.slug, script);
-          }
-        }
-      }
-
-      const uniqueScripts = Array.from(scriptMap.values());
-      const filteredResults = search(uniqueScripts, query);
-      setResults(filteredResults);
-    }
-  }, [query]);
-
   React.useEffect(() => {
     const handleKeyDown = (e: KeyboardEvent) => {
       if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
@@ -248,20 +197,20 @@ function CommandMenu() {
 
       <CommandDialog
         open={open}
-        onOpenChange={(open) => {
+        onOpenChange={setOpen}
-          setOpen(open);
+        filter={(value: string, search: string) => {
-          if (open) {
+          const searchLower = search.toLowerCase().trim();
-            setQuery("");
+          if (!searchLower)
-            setResults([]);
+            return 1;
-          }
+          const valueLower = value.toLowerCase();
+          const searchWords = searchLower.split(/\s+/).filter(Boolean);
+          // All search words must appear somewhere in the value (name + description)
+          const allWordsMatch = searchWords.every((word: string) => valueLower.includes(word));
+          return allWordsMatch ? 1 : 0;
         }}
       >
         <DialogTitle className="sr-only">Search scripts</DialogTitle>
-        <CommandInput
+        <CommandInput placeholder="Search for a script..." />
-          placeholder="Search for a script..."
-          onValueChange={setQuery}
-          value={query}
-        />
         <CommandList>
           <CommandEmpty>
             {isLoading ? (
@@ -284,10 +233,9 @@ function CommandMenu() {
               </div>
             )}
           </CommandEmpty>
-
+          {Object.entries(uniqueScriptsByCategory).map(([categoryName, scripts]) => (
-          {results.length > 0 ? (
+            <CommandGroup key={`category:${categoryName}`} heading={categoryName}>
-            <CommandGroup heading="Search Results">
+              {scripts.map(script => (
-              {results.map(script => (
                 <CommandItem
                   key={`script:${script.slug}`}
                   value={`${script.name} ${script.type} ${script.description || ""}`}
@@ -320,44 +268,7 @@ function CommandMenu() {
                 </CommandItem>
               ))}
             </CommandGroup>
-          ) : ( // When no search results, show all scripts grouped by category
+          ))}
-            Object.entries(uniqueScriptsByCategory).map(([categoryName, scripts]) => (
-              <CommandGroup key={`category:${categoryName}`} heading={categoryName}>
-                {scripts.map(script => (
-                  <CommandItem
-                    key={`script:${script.slug}`}
-                    value={`${script.name} ${script.type} ${script.description || ""}`}
-                    onSelect={() => {
-                      setOpen(false);
-                      router.push(`/scripts?id=${script.slug}`);
-                    }}
-                    tabIndex={0}
-                    aria-label={`Open script ${script.name}`}
-                    onKeyDown={(e) => {
-                      if (e.key === "Enter" || e.key === " ") {
-                        setOpen(false);
-                        router.push(`/scripts?id=${script.slug}`);
-                      }
-                    }}
-                  >
-                    <div className="flex gap-2" onClick={() => setOpen(false)}>
-                      <Image
-                        src={script.logo || `/${basePath}/logo.png`}
-                        onError={e => ((e.currentTarget as HTMLImageElement).src = `/${basePath}/logo.png`)}
-                        unoptimized
-                        width={16}
-                        height={16}
-                        alt=""
-                        className="h-5 w-5"
-                      />
-                      <span>{script.name}</span>
-                      <span>{formattedBadge(script.type)}</span>
-                    </div>
-                  </CommandItem>
-                ))}
-              </CommandGroup>
-            ))
-          )}
         </CommandList>
       </CommandDialog>
     </>

frontend/src/components/navigation/mobile-sidebar.tsx

@@ -119,6 +119,7 @@ function MobileSidebar() {
                   <p className="text-sm font-medium">Last Viewed</p>
                   <ScriptItem
                     item={lastViewedScript}
+                    setSelectedScript={isOnScriptsPage ? setSelectedScript : setTempSelectedScript}
                   />
                 </div>
               )
@@ -130,4 +131,3 @@ function MobileSidebar() {
 }
 
 export default MobileSidebar;
-

frontend/src/lib/types.ts

@@ -5,7 +5,7 @@ export type Script = {
   slug: string;
   categories: number[];
   date_created: string;
-  type: "vm" | "ct" | "pve" | "addon" | "turnkey";
+  type: "vm" | "ct" | "pve" | "addon";
   updateable: boolean;
   privileged: boolean;
   interface_port: number | null;
@@ -31,10 +31,12 @@ export type Script = {
     username: string | null;
     password: string | null;
   };
-  notes: {
+  notes: [
-    text: string;
+    {
-    type: keyof typeof AlertColors;
+      text: string;
-  }[];
+      type: keyof typeof AlertColors;
+    },
+  ];
 };
 
 export type Category = {

install/alpine-rustypaste-install.sh

@@ -1,55 +0,0 @@
-#!/usr/bin/env bash
-
-# Copyright (c) 2021-2026 community-scripts ORG
-# Author: MickLesk (CanbiZ)
-# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
-# Source: https://github.com/orhun/rustypaste
-
-source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
-color
-verb_ip6
-catch_errors
-setting_up_container
-network_check
-update_os
-
-msg_info "Installing RustyPaste"
-$STD apk add --no-cache rustypaste --repository=https://dl-cdn.alpinelinux.org/alpine/edge/community
-msg_ok "Installed RustyPaste"
-
-msg_info "Configuring RustyPaste"
-mkdir -p /var/lib/rustypaste
-sed -i 's|^address = ".*"|address = "0.0.0.0:8000"|' /etc/rustypaste/config.toml
-msg_ok "Configured RustyPaste"
-
-msg_info "Creating Service"
-cat <<'EOF' >/etc/init.d/rustypaste
-#!/sbin/openrc-run
-
-name="rustypaste"
-description="RustyPaste - A minimal file upload/pastebin service"
-command="/usr/bin/rustypaste"
-command_args=""
-command_user="root"
-command_background=true
-pidfile="/run/${RC_SVCNAME}.pid"
-directory="/var/lib/rustypaste"
-
-depend() {
-    need net
-    after firewall
-}
-
-start_pre() {
-    export CONFIG=/etc/rustypaste/config.toml
-    checkpath --directory --owner root:root --mode 0755 /var/lib/rustypaste
-}
-EOF
-chmod +x /etc/init.d/rustypaste
-$STD rc-update add rustypaste default
-$STD rc-service rustypaste start
-msg_ok "Created Service"
-
-motd_ssh
-customize
-cleanup_lxc

install/grist-install.sh

@@ -17,8 +17,7 @@ msg_info "Installing Dependencies"
 $STD apt install -y \
   make \
   ca-certificates \
-  python3-venv \
+  python3-venv
-  git
 msg_ok "Installed Dependencies"
 NODE_VERSION="22" NODE_MODULE="yarn@latest" setup_nodejs
 fetch_and_deploy_gh_release "grist" "gristlabs/grist-core" "tarball"

install/immich-install.sh

@@ -13,44 +13,44 @@ setting_up_container
 network_check
 update_os
 
-if [ -d /dev/dri ]; then
+echo ""
-  echo ""
+echo ""
-  echo ""
+echo -e "🤖 ${BL}Immich Machine Learning Options${CL}"
-  echo -e "🤖 ${BL}Immich Machine Learning Options${CL}"
+echo "─────────────────────────────────────────"
-  echo "─────────────────────────────────────────"
+echo "Please choose your machine-learning type:"
-  echo "Please choose your machine-learning type:"
+echo ""
-  echo ""
+echo " 1) CPU only (default)"
-  echo " 1) CPU only (default)"
+echo " 2) Intel OpenVINO (requires GPU passthrough)"
-  echo " 2) Intel OpenVINO (requires GPU passthrough)"
+echo ""
-  echo ""
 
-  read -r -p "${TAB3}Select machine-learning type [1]: " ML_TYPE
+read -r -p "${TAB3}Select machine-learning type [1]: " ML_TYPE
-  ML_TYPE="${ML_TYPE:-1}"
+ML_TYPE="${ML_TYPE:-1}"
-  if [[ "$ML_TYPE" == "2" ]]; then
+if [[ "$ML_TYPE" == "2" ]]; then
-    msg_info "Installing OpenVINO dependencies"
+  msg_info "Installing OpenVINO dependencies"
-    touch ~/.openvino
+  touch ~/.openvino
-    $STD apt install -y --no-install-recommends patchelf
+  $STD apt install -y --no-install-recommends patchelf
-    tmp_dir=$(mktemp -d)
+  tmp_dir=$(mktemp -d)
-    $STD pushd "$tmp_dir"
+  $STD pushd "$tmp_dir"
-    curl -fsSLO https://raw.githubusercontent.com/immich-app/base-images/refs/heads/main/server/Dockerfile
+  curl -fsSLO https://raw.githubusercontent.com/immich-app/base-images/refs/heads/main/server/Dockerfile
-    readarray -t INTEL_URLS < <(
+  readarray -t INTEL_URLS < <(
-      sed -n "/intel-[igc|opencl]/p" ./Dockerfile | awk '{print $2}'
+    sed -n "/intel-[igc|opencl]/p" ./Dockerfile | awk '{print $2}'
-      sed -n "/libigdgmm12/p" ./Dockerfile | awk '{print $3}'
+    sed -n "/libigdgmm12/p" ./Dockerfile | awk '{print $3}'
-    )
+  )
-    for url in "${INTEL_URLS[@]}"; do
+  for url in "${INTEL_URLS[@]}"; do
-      curl -fsSLO "$url"
+    curl -fsSLO "$url"
-    done
+  done
-    $STD apt install -y ./libigdgmm12*.deb
+  $STD apt install -y ./libigdgmm12*.deb
-    rm ./libigdgmm12*.deb
+  rm ./libigdgmm12*.deb
-    $STD apt install -y ./*.deb
+  $STD apt install -y ./*.deb
-    $STD apt-mark hold libigdgmm12
+  $STD apt-mark hold libigdgmm12
-    $STD popd
+  $STD popd
-    rm -rf "$tmp_dir"
+  rm -rf "$tmp_dir"
-    dpkg-query -W -f='${Version}\n' intel-opencl-icd >~/.intel_version
+  dpkg-query -W -f='${Version}\n' intel-opencl-icd >~/.intel_version
-    msg_ok "Installed OpenVINO dependencies"
+  msg_ok "Installed OpenVINO dependencies"
-  fi
 fi
 
+setup_uv
+
 msg_info "Installing dependencies"
 $STD apt install --no-install-recommends -y \
   git \
@@ -144,7 +144,8 @@ msg_info "Installing packages from Debian Testing repo"
 $STD apt install -t testing --no-install-recommends -yqq libmimalloc3 libde265-dev
 msg_ok "Installed packages from Debian Testing repo"
 
-setup_uv
+PNPM_VERSION="$(curl -fsSL "https://raw.githubusercontent.com/immich-app/immich/refs/heads/main/package.json" | jq -r '.packageManager | split("@")[1]')"
+NODE_VERSION="24" NODE_MODULE="pnpm@${PNPM_VERSION}" setup_nodejs
 PG_VERSION="16" PG_MODULES="pgvector" setup_postgresql
 
 VCHORD_RELEASE="0.5.3"
@@ -289,9 +290,7 @@ ML_DIR="${APP_DIR}/machine-learning"
 GEO_DIR="${INSTALL_DIR}/geodata"
 mkdir -p {"${APP_DIR}","${UPLOAD_DIR}","${GEO_DIR}","${INSTALL_DIR}"/cache}
 
-fetch_and_deploy_gh_release "immich" "immich-app/immich" "tarball" "v2.5.3" "$SRC_DIR"
+fetch_and_deploy_gh_release "immich" "immich-app/immich" "tarball" "v2.5.2" "$SRC_DIR"
-PNPM_VERSION="$(jq -r '.packageManager | split("@")[1]' ${SRC_DIR}/package.json)"
-NODE_VERSION="24" NODE_MODULE="pnpm@${PNPM_VERSION}" setup_nodejs
 
 msg_info "Installing Immich (patience)"