Update tools.func

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

CHANGELOG.md

@@ -14,16 +14,27 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
 All LXC instances created using this repository come pre-installed with Midnight Commander, which is a command-line tool (`mc`) that offers a user-friendly file and directory management interface for the terminal environment.
 
 
+## 2025-07-01
+
 ## 2025-06-30
 
+### 🆕 New Scripts
+
+  - Alpine Syncthing [@MickLesk](https://github.com/MickLesk) ([#5586](https://github.com/community-scripts/ProxmoxVE/pull/5586))
+- Kapowarr ([#5584](https://github.com/community-scripts/ProxmoxVE/pull/5584))
+
 ### 🚀 Updated Scripts
 
+  - Fixing Cloudflare DDNS - lack of resources [@meszolym](https://github.com/meszolym) ([#5600](https://github.com/community-scripts/ProxmoxVE/pull/5600))
+
   - #### 🐞 Bug Fixes
 
+    - Immich: make changes to automatically enable QuickSync [@vhsdream](https://github.com/vhsdream) ([#5560](https://github.com/community-scripts/ProxmoxVE/pull/5560))
     - Apache Guacamole: Install auth-jdbc component that matches release version [@tremor021](https://github.com/tremor021) ([#5563](https://github.com/community-scripts/ProxmoxVE/pull/5563))
 
   - #### ✨ New Features
 
+    - tools.func: optimize binary installs with fetch_and_deploy helper [@MickLesk](https://github.com/MickLesk) ([#5588](https://github.com/community-scripts/ProxmoxVE/pull/5588))
     - [core]: add ipv6 configuration support [@MickLesk](https://github.com/MickLesk) ([#5575](https://github.com/community-scripts/ProxmoxVE/pull/5575))
 
 ## 2025-06-29

ct/alpine-syncthing.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://syncthing.net/
+
+APP="Alpine-Syncthing"
+var_tags="${var_tags:-alpine;networking}"
+var_cpu="${var_cpu:-1}"
+var_ram="${var_ram:-256}"
+var_disk="${var_disk:-1}"
+var_os="${var_os:-alpine}"
+var_version="${var_version:-3.22}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  msg_info "Updating Alpine Packages"
+  $STD apk -U upgrade
+  msg_ok "Updated Alpine Packages"
+
+  msg_info "Updating Syncthing"
+  $STD apk upgrade syncthing
+  msg_ok "Updated Syncthing"
+
+  msg_info "Restarting Syncthing"
+  $STD rc-service syncthing restart
+  msg_ok "Restarted Syncthing"
+
+  exit 1
+}
+
+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}:8384${CL}"

ct/cloudflare-ddns.sh

@@ -7,8 +7,8 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 
 APP="Cloudflare-DDNS"
 var_tags="${var_tags:-network}"
-var_cpu="${var_cpu:-1}"
-var_ram="${var_ram:-512}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-1024}"
 var_disk="${var_disk:-3}"
 var_os="${var_os:-debian}"
 var_version="${var_version:-12}"

ct/headers/alpine-syncthing

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

ct/headers/kapowarr

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

ct/kapowarr.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: Slaviša Arežina (tremor021)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/Casvt/Kapowarr
+
+APP="Kapowarr"
+var_tags="${var_tags:-Arr}"
+var_cpu="${var_cpu:-1}"
+var_ram="${var_ram:-256}"
+var_disk="${var_disk:-2}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-12}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+
+  if [[ ! -f /etc/systemd/system/kapowarr.service ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+  RELEASE=$(curl -s https://api.github.com/repos/Casvt/Kapowarr/releases/latest | grep "tag_name" | awk '{print substr($2, 2, length($2)-3) }')
+  if [[ "${RELEASE}" != "$(cat $HOME/.kapowarr)" ]] || [[ ! -f $HOME/.kapowarr ]]; then
+    setup_uv 
+    
+    msg_info "Stopping $APP"
+    systemctl stop kapowarr
+    msg_ok "Stopped $APP"
+
+    msg_info "Creating Backup"
+    mv /opt/kapowarr/db /opt/
+    msg_ok "Backup Created"
+
+    fetch_and_deploy_gh_release "kapowarr" "Casvt/Kapowarr"
+    msg_info "Updating $APP to ${RELEASE}"
+    mv /opt/db /opt/kapowarr
+    msg_ok "Updated $APP to ${RELEASE}"
+
+    msg_info "Starting $APP"
+    systemctl start kapowarr
+    msg_ok "Started $APP"
+
+    msg_ok "Update Successful"
+  else
+    msg_ok "No update required. ${APP} is already at ${RELEASE}"
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:5656${CL}"

frontend/public/json/cloudflare-ddns.json

@@ -19,8 +19,8 @@
       "type": "default",
       "script": "ct/cloudflare-ddns.sh",
       "resources": {
-        "cpu": 1,
-        "ram": 512,
+        "cpu": 2,
+        "ram": 1024,
         "hdd": 2,
         "os": "Debian",
         "version": "12"

frontend/public/json/kapowarr.json

@@ -0,0 +1,35 @@
+{
+  "name": "Kapowarr",
+  "slug": "kapowarr",
+  "categories": [
+    14
+  ],
+  "date_created": "2025-06-30",
+  "type": "ct",
+  "updateable": true,
+  "privileged": false,
+  "interface_port": 5656,
+  "documentation": "https://casvt.github.io/Kapowarr/general_info/workings/",
+  "website": "https://casvt.github.io/Kapowarr/",
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/kapowarr.webp",
+  "config_path": "",
+  "description": "Kapowarr allows you to build a digital library of comics. You can add volumes, map them to a folder and start managing! Download, rename, move and convert issues of the volume (including TPB's, One Shots, Hard Covers, and more). The whole process is automated and can be customised in the settings.",
+  "install_methods": [
+    {
+      "type": "default",
+      "script": "ct/kapowarr.sh",
+      "resources": {
+        "cpu": 1,
+        "ram": 256,
+        "hdd": 2,
+        "os": "debian",
+        "version": "12"
+      }
+    }
+  ],
+  "default_credentials": {
+    "username": null,
+    "password": null
+  },
+  "notes": []
+}

frontend/public/json/syncthing.json

@@ -12,7 +12,7 @@
     "documentation": null,
     "website": "https://syncthing.net/",
     "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/syncthing.webp",
-    "config_path": "/root/.local/state/syncthing/config.xml",
+    "config_path": "/root/.local/state/syncthing/config.xml - Alpine: /var/lib/syncthing/.local/state/syncthing/config.xml",
     "description": "Syncthing is an open-source file syncing tool that allows users to keep their files in sync across multiple devices by using peer-to-peer synchronization. It doesn't rely on any central server, so all data transfers are directly between devices.",
     "install_methods": [
         {
@@ -25,8 +25,19 @@
                 "os": "debian",
                 "version": "12"
             }
-        }
-    ],
+        },
+    {
+      "type": "alpine",
+      "script": "ct/alpine-syncthing.sh",
+      "resources": {
+        "cpu": 1,
+        "ram": 256,
+        "hdd": 1,
+        "os": "alpine",
+        "version": "3.22"
+      }
+    }
+  ],
     "default_credentials": {
         "username": null,
         "password": null

frontend/public/json/versions.json

@@ -1,9 +1,59 @@
 [
+  {
+    "name": "MagicMirrorOrg/MagicMirror",
+    "version": "v2.32.0",
+    "date": "2025-06-30T22:12:48Z"
+  },
+  {
+    "name": "mongodb/mongo",
+    "version": "r8.0.11",
+    "date": "2025-06-30T20:30:31Z"
+  },
+  {
+    "name": "docker/compose",
+    "version": "v2.38.1",
+    "date": "2025-06-30T20:07:35Z"
+  },
+  {
+    "name": "home-assistant/core",
+    "version": "2025.6.3",
+    "date": "2025-06-24T13:00:12Z"
+  },
   {
     "name": "rcourtman/Pulse",
     "version": "v3.33.1",
     "date": "2025-06-30T11:29:32Z"
   },
+  {
+    "name": "jhuckaby/Cronicle",
+    "version": "v0.9.81",
+    "date": "2025-06-30T16:40:33Z"
+  },
+  {
+    "name": "ollama/ollama",
+    "version": "v0.9.4-rc2",
+    "date": "2025-06-27T18:45:33Z"
+  },
+  {
+    "name": "prometheus/prometheus",
+    "version": "v2.53.5",
+    "date": "2025-06-30T11:01:12Z"
+  },
+  {
+    "name": "n8n-io/n8n",
+    "version": "n8n@1.100.0",
+    "date": "2025-06-23T12:48:35Z"
+  },
+  {
+    "name": "jupyter/notebook",
+    "version": "v7.4.4",
+    "date": "2025-06-30T13:04:22Z"
+  },
+  {
+    "name": "keycloak/keycloak",
+    "version": "26.3.0",
+    "date": "2025-06-30T12:53:32Z"
+  },
   {
     "name": "Graylog2/graylog2-server",
     "version": "6.3.0",
@@ -14,11 +64,6 @@
     "version": "v8.1.17",
     "date": "2025-06-30T11:26:27Z"
   },
-  {
-    "name": "prometheus/prometheus",
-    "version": "v2.53.5",
-    "date": "2025-06-30T11:01:12Z"
-  },
   {
     "name": "documenso/documenso",
     "version": "v1.12.0-rc.8",
@@ -54,11 +99,6 @@
     "version": "v6.2.19",
     "date": "2025-06-28T06:53:45Z"
   },
-  {
-    "name": "keycloak/keycloak",
-    "version": "26.2.5",
-    "date": "2025-05-28T06:49:43Z"
-  },
   {
     "name": "sysadminsmedia/homebox",
     "version": "v0.20.0",
@@ -79,11 +119,6 @@
     "version": "v11.11.2",
     "date": "2025-06-29T01:40:39Z"
   },
-  {
-    "name": "home-assistant/core",
-    "version": "2025.6.3",
-    "date": "2025-06-24T13:00:12Z"
-  },
   {
     "name": "linkwarden/linkwarden",
     "version": "v2.11.2",
@@ -124,11 +159,6 @@
     "version": "v1.26.0",
     "date": "2025-06-27T19:15:24Z"
   },
-  {
-    "name": "ollama/ollama",
-    "version": "v0.9.4-rc1",
-    "date": "2025-06-27T18:45:33Z"
-  },
   {
     "name": "goauthentik/authentik",
     "version": "version/2025.6.3",
@@ -214,11 +244,6 @@
     "version": "18.0.7",
     "date": "2025-06-26T09:16:33Z"
   },
-  {
-    "name": "mongodb/mongo",
-    "version": "r8.1.2-rc1",
-    "date": "2025-06-25T22:42:04Z"
-  },
   {
     "name": "gristlabs/grist-core",
     "version": "v1.6.1",
@@ -249,11 +274,6 @@
     "version": "testing",
     "date": "2025-06-16T18:10:42Z"
   },
-  {
-    "name": "n8n-io/n8n",
-    "version": "n8n@1.100.0",
-    "date": "2025-06-23T12:48:35Z"
-  },
   {
     "name": "moghtech/komodo",
     "version": "v1.18.4",
@@ -284,11 +304,6 @@
     "version": "v1.132.0",
     "date": "2025-06-17T13:49:30Z"
   },
-  {
-    "name": "docker/compose",
-    "version": "v2.37.3",
-    "date": "2025-06-24T14:05:33Z"
-  },
   {
     "name": "Checkmk/checkmk",
     "version": "v2.4.0p5",
@@ -311,8 +326,8 @@
   },
   {
     "name": "runtipi/runtipi",
-    "version": "v4.2.1",
-    "date": "2025-06-03T20:04:28Z"
+    "version": "nightly",
+    "date": "2025-06-23T19:10:33Z"
   },
   {
     "name": "VictoriaMetrics/VictoriaMetrics",
@@ -789,11 +804,6 @@
     "version": "1.34.1",
     "date": "2025-05-26T21:40:54Z"
   },
-  {
-    "name": "jupyter/notebook",
-    "version": "v7.4.3",
-    "date": "2025-05-26T14:27:27Z"
-  },
   {
     "name": "stonith404/pingvin-share",
     "version": "v1.13.0",
@@ -924,11 +934,6 @@
     "version": "v1.13.5",
     "date": "2025-05-03T09:48:44Z"
   },
-  {
-    "name": "jhuckaby/Cronicle",
-    "version": "v0.9.80",
-    "date": "2025-05-02T16:48:15Z"
-  },
   {
     "name": "WordPress/WordPress",
     "version": "6.8.1",
@@ -1044,11 +1049,6 @@
     "version": "2.3",
     "date": "2025-04-05T18:05:36Z"
   },
-  {
-    "name": "MagicMirrorOrg/MagicMirror",
-    "version": "v2.31.0",
-    "date": "2025-04-01T18:12:45Z"
-  },
   {
     "name": "Kometa-Team/Kometa",
     "version": "v2.2.0",

install/alpine-syncthing-install.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://syncthing.net/
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Setup Syncthing"
+$STD apk add --no-cache syncthing
+sed -i "{s/127.0.0.1:8384/0.0.0.0:8384/g}" /var/lib/syncthing/.local/state/syncthing/config.xml
+msg_ok "Setup Syncthing"
+
+msg_info "Enabling Syncthing Service"
+$STD rc-update add syncthing default
+msg_ok "Enabled Syncthing Service"
+
+msg_info "Starting Syncthing"
+$STD rc-service syncthing start
+msg_ok "Started Syncthing"
+
+motd_ssh
+customize

install/apache-guacamole-install.sh

@@ -85,7 +85,7 @@ $STD mariadb -u root -e "GRANT ALL ON $DB_NAME.* TO '$DB_USER'@'localhost'; FLUS
   echo "Database Password: $DB_PASS"
   echo "Database Name: $DB_NAME"
 } >>~/guacamole.creds
-cd guacamole-auth-jdbc-1.5.5/mysql/schema
+cd guacamole-auth-jdbc-${RELEASE_SERVER}/mysql/schema
 cat *.sql | mariadb -u root ${DB_NAME}
 {
   echo "mysql-hostname: 127.0.0.1"

install/immich-install.sh

@@ -84,6 +84,13 @@ $STD apt-get update
 $STD apt-get install -y jellyfin-ffmpeg7
 ln -s /usr/lib/jellyfin-ffmpeg/ffmpeg /usr/bin/ffmpeg
 ln -s /usr/lib/jellyfin-ffmpeg/ffprobe /usr/bin/ffprobe
+if [[ "$CTTYPE" == "0" ]]; then
+  chgrp video /dev/dri
+  chmod 755 /dev/dri
+  chmod 660 /dev/dri/*
+  $STD adduser "$(id -u -n)" video
+  $STD adduser "$(id -u -n)" render
+fi
 msg_ok "Dependencies Installed"
 
 read -r -p "Install OpenVINO dependencies for Intel HW-accelerated machine-learning? y/N " prompt
@@ -100,13 +107,6 @@ if [[ ${prompt,,} =~ ^(y|yes)$ ]]; then
   $STD popd
   rm -rf "$tmp_dir"
   dpkg -l | grep "intel-opencl-icd" | awk '{print $3}' >~/.intel_version
-  if [[ "$CTTYPE" == "0" ]]; then
-    chgrp video /dev/dri
-    chmod 755 /dev/dri
-    chmod 660 /dev/dri/*
-    $STD adduser "$(id -u -n)" video
-    $STD adduser "$(id -u -n)" render
-  fi
   msg_ok "Installed OpenVINO dependencies"
 fi
 
@@ -360,9 +360,8 @@ msg_ok "Installed ${APPLICATION}"
 
 msg_info "Creating user, env file, scripts & services"
 $STD useradd -U -s /usr/sbin/nologin -r -M -d "$INSTALL_DIR" immich
-if [[ -f ~/.openvino ]]; then
-  usermod -aG video,render immich
-fi
+usermod -aG video,render immich
+
 cat <<EOF >"${INSTALL_DIR}"/.env
 TZ=$(cat /etc/timezone)
 IMMICH_VERSION=release

install/kapowarr-install.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2025 community-scripts ORG
+# Author: Slaviša Arežina (tremor021)
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/Casvt/Kapowarr
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Setup Python3"
+$STD apt-get install -y python3-pip
+msg_ok "Setup Python3"
+
+setup_uv
+fetch_and_deploy_gh_release "kapowarr" "Casvt/Kapowarr"
+
+msg_info "Setup Kapowarr"
+cd /opt/kapowarr
+$STD uv venv .venv
+$STD source .venv/bin/activate
+$STD uv pip install --upgrade pip
+$STD uv pip install --no-cache-dir -r requirements.txt
+msg_ok "Installed Kapowarr"
+
+msg_info "Creating Service"
+cat <<EOF >/etc/systemd/system/kapowarr.service
+[Unit]
+Description=Kapowarr Service
+After=network.target
+
+[Service]
+WorkingDirectory=/opt/kapowarr/
+ExecStart=/opt/kapowarr/.venv/bin/python3 Kapowarr.py
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl enable -q --now kapowarr
+msg_ok "Created Service"
+
+motd_ssh
+customize
+
+msg_info "Cleaning up"
+$STD apt-get -y autoremove
+$STD apt-get -y autoclean
+msg_ok "Cleaned"

misc/tools.func

@@ -761,7 +761,7 @@ function fetch_and_deploy_gh_release() {
   local app_lc=$(echo "${app,,}" | tr -d ' ')
   local version_file="$HOME/.${app_lc}"
 
-  local api_timeout="--connect-timeout 5 --max-time 30"
+  local api_timeout="--connect-timeout 10 --max-time 60"
   local download_timeout="--connect-timeout 15 --max-time 900"
 
   local current_version=""
@@ -776,6 +776,14 @@ function fetch_and_deploy_gh_release() {
   local header=()
   [[ -n "${GITHUB_TOKEN:-}" ]] && header=(-H "Authorization: token $GITHUB_TOKEN")
 
+  # dns pre check
+  local gh_host
+  gh_host=$(awk -F/ '{print $3}' <<<"$api_url")
+  if ! getent hosts "$gh_host" &>/dev/null; then
+    msg_error "DNS resolution failed for $gh_host – check /etc/resolv.conf or networking"
+    return 1
+  fi
+
   local max_retries=3 retry_delay=2 attempt=1 success=false resp http_code
 
   while ((attempt <= max_retries)); do
@@ -785,7 +793,7 @@ function fetch_and_deploy_gh_release() {
   done
 
   if ! $success; then
-    msg_error "Failed to fetch release metadata after $max_retries attempts"
+    msg_error "Failed to fetch release metadata from $api_url after $max_retries attempts"
     return 1
   fi
 
@@ -834,18 +842,26 @@ function fetch_and_deploy_gh_release() {
   elif [[ "$mode" == "binary" ]]; then
     local arch
     arch=$(dpkg --print-architecture 2>/dev/null || uname -m)
-    [[ "$arch" == "x86_64" ]] && arch="x86_64"
+    [[ "$arch" == "x86_64" ]] && arch="amd64"
     [[ "$arch" == "aarch64" ]] && arch="arm64"
 
     local assets url_match=""
     assets=$(echo "$json" | jq -r '.assets[].browser_download_url')
 
-    for u in $assets; do
-      if [[ "$u" =~ ($arch|amd64|x86_64|aarch64|arm64).*\.deb$ ]]; then
-        url_match="$u"
-        break
-      fi
-    done
+    if [[ -n "$6" ]]; then
+      for u in $assets; do
+        [[ "$u" =~ $6 || "$u" == *"$6" ]] && url_match="$u" && break
+      done
+    fi
+
+    if [[ -z "$url_match" ]]; then
+      for u in $assets; do
+        if [[ "$u" =~ ($arch|amd64|x86_64|aarch64|arm64).*\.deb$ ]]; then
+          url_match="$u"
+          break
+        fi
+      done
+    fi
 
     if [[ -z "$url_match" ]]; then
       for u in $assets; do