chore: add VERSION v0.4.9

Merge pull request #247 from community-scripts/fix/script-card-click-issues
Fix: Autosync disable functionality and multiple instance issues
2025-10-24 20:39:06 +00:00 · 2025-10-24 22:36:37 +02:00 · 2025-10-24 22:30:26 +02:00 · 2025-10-24 22:30:15 +02:00 · 2025-10-24 22:29:37 +02:00 · 2025-10-24 22:27:40 +02:00
52 changed files with 8226 additions and 3588 deletions
--- a/.env.example
+++ b/.env.example
@@ -26,4 +26,13 @@ AUTH_PASSWORD_HASH=
 AUTH_ENABLED=false
 AUTH_SETUP_COMPLETED=false
 JWT_SECRET=
-DATABASE_URL="file:./data/database.sqlite"
+DATABASE_URL="file:/opt/ProxmoxVE-Local/data/settings.db"
+AUTO_SYNC_ENABLED=false
+SYNC_INTERVAL_TYPE=
+SYNC_INTERVAL_PREDEFINED=
+AUTO_DOWNLOAD_NEW=
+AUTO_UPDATE_EXISTING=
+NOTIFICATION_ENABLED=
+APPRISE_URLS=
+LAST_AUTO_SYNC=
+SYNC_INTERVAL_CRON=
--- a/.github/workflows/publish_release.yml
+++ b/.github/workflows/publish_release.yml
@@ -46,35 +46,6 @@ jobs:
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git commit -m "chore: add VERSION $version" --allow-empty

-
-      - name: Sync upstream JSONs
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          set -euo pipefail
-          tmp_dir=$(mktemp -d)
-          api_url="https://api.github.com/repos/community-scripts/ProxmoxVE/contents/frontend/public/json"
-          # Fetch file list (no subfolders)
-          curl -sSL -H "Authorization: token $GH_TOKEN" "$api_url" \
-            | jq -r '.[] | select(.type=="file") | .name' > "$tmp_dir/files.txt"
-
-          # Download each file
-          while IFS= read -r name; do
-            curl -sSL -H "Authorization: token $GH_TOKEN" \
-              "https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/frontend/public/json/$name" \
-              -o "$tmp_dir/$name"
-          done < "$tmp_dir/files.txt"
-
-          mkdir -p json
-          rsync -a --delete "$tmp_dir/" json/
-
-          # Stage and amend commit to include JSON updates (and VERSION)
-          git add json VERSION
-          if ! git diff --cached --quiet; then
-            git commit --amend --no-edit
-          fi
-
-
      - name: Push changes
        run: |
          git push --force-with-lease --set-upstream origin "update-version-${{ steps.draft.outputs.tag_name }}"
--- a/.gitignore
+++ b/.gitignore
@@ -37,6 +37,9 @@ yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*

+update.log
+server.log
+
 # local env files
 # do not commit any .env files to git, except for the .env.example file. https://create.t3.gg/en/usage/env-variables#using-environment-variables
 .env
--- a/2
+++ b/2
@@ -1 +1 @@
-0.4.6
+0.4.9
--- a/json/frigate.json.bak
+++ b/json/frigate.json.bak
@@ -1,44 +0,0 @@
-{
-  "name": "Frigate",
-  "slug": "frigate",
-  "categories": [
-    15
-  ],
-  "date_created": "2024-05-02",
-  "type": "ct",
-  "updateable": false,
-  "privileged": true,
-  "interface_port": 5000,
-  "documentation": "https://docs.frigate.video/",
-  "website": "https://frigate.video/",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/frigate.webp",
-  "config_path": "",
-  "description": "Frigate is an open source NVR built around real-time AI object detection. All processing is performed locally on your own hardware, and your camera feeds never leave your home.",
-  "install_methods": [
-    {
-      "type": "default",
-      "script": "ct/frigate.sh",
-      "resources": {
-        "cpu": 4,
-        "ram": 4096,
-        "hdd": 20,
-        "os": "debian",
-        "version": "11"
-      }
-    }
-  ],
-  "default_credentials": {
-    "username": null,
-    "password": null
-  },
-  "notes": [
-    {
-      "text": "Discussions (explore more advanced methods): `https://github.com/tteck/Proxmox/discussions/2711`",
-      "type": "info"
-    },
-    {
-      "text": "go2rtc Interface port:`1984`",
-      "type": "info"
-    }
-  ]
-}
--- a/json/nextcloudpi.json
+++ b/json/nextcloudpi.json
@@ -23,7 +23,7 @@
        "ram": 2048,
        "hdd": 8,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    },
    {
--- a/json/open-archiver.json
+++ b/json/open-archiver.json
@@ -12,7 +12,7 @@
  "documentation": "https://docs.openarchiver.com/",
  "config_path": "/opt/openarchiver/.env",
  "website": "https://openarchiver.com/",
-  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/OpenArchiver.webp",
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/open-archiver.webp",
  "description": "Open Archiver is a secure, self-hosted email archiving solution, and it's completely open source. Get an email archiver that enables full-text search across email and attachments. Create a permanent, searchable, and compliant mail archive from Google Workspace, Microsoft 35, and any IMAP server.",
  "install_methods": [
    {
--- a/json/paperless-ai.json
+++ b/json/paperless-ai.json
@@ -19,8 +19,8 @@
      "type": "default",
      "script": "ct/paperless-ai.sh",
      "resources": {
-        "cpu": 2,
-        "ram": 2048,
+        "cpu": 4,
+        "ram": 4096,
        "hdd": 20,
        "os": "debian",
        "version": "13"
--- a/json/versions.json
+++ b/json/versions.json
@@ -1,29 +1,164 @@
 [
+  {
+    "name": "apache/cassandra",
+    "version": "5.0.6-tentative",
+    "date": "2025-10-21T11:42:35Z"
+  },
+  {
+    "name": "evcc-io/evcc",
+    "version": "0.209.3",
+    "date": "2025-10-21T10:53:07Z"
+  },
+  {
+    "name": "grafana/grafana",
+    "version": "v11.5.10",
+    "date": "2025-10-21T10:46:47Z"
+  },
+  {
+    "name": "zabbix/zabbix",
+    "version": "7.0.20rc1",
+    "date": "2025-10-21T09:14:14Z"
+  },
+  {
+    "name": "n8n-io/n8n",
+    "version": "n8n@1.115.3",
+    "date": "2025-10-14T14:40:17Z"
+  },
+  {
+    "name": "VictoriaMetrics/VictoriaMetrics",
+    "version": "pmm-6401-v1.128.0",
+    "date": "2025-10-21T08:30:52Z"
+  },
  {
    "name": "crowdsecurity/crowdsec",
    "version": "v1.7.1",
    "date": "2025-10-15T10:44:03Z"
  },
+  {
+    "name": "meilisearch/meilisearch",
+    "version": "prototype-v1.24.0.ignore-embedding-failures-2",
+    "date": "2025-10-21T07:36:22Z"
+  },
+  {
+    "name": "Jackett/Jackett",
+    "version": "v0.24.166",
+    "date": "2025-10-21T05:54:33Z"
+  },
+  {
+    "name": "openobserve/openobserve",
+    "version": "v0.16.0-rc1",
+    "date": "2025-10-21T00:37:47Z"
+  },
+  {
+    "name": "jeedom/core",
+    "version": "4.4.20",
+    "date": "2025-10-21T00:27:05Z"
+  },
+  {
+    "name": "steveiliop56/tinyauth",
+    "version": "v4.0.1",
+    "date": "2025-10-15T16:53:55Z"
+  },
+  {
+    "name": "documenso/documenso",
+    "version": "v1.13.0",
+    "date": "2025-10-21T00:21:04Z"
+  },
+  {
+    "name": "goauthentik/authentik",
+    "version": "version/2025.10.0-rc2",
+    "date": "2025-10-21T00:19:36Z"
+  },
+  {
+    "name": "TwiN/gatus",
+    "version": "v5.27.1",
+    "date": "2025-10-21T00:01:36Z"
+  },
+  {
+    "name": "henrygd/beszel",
+    "version": "v0.14.1",
+    "date": "2025-10-20T22:10:56Z"
+  },
+  {
+    "name": "keycloak/keycloak",
+    "version": "26.4.1",
+    "date": "2025-10-16T07:21:53Z"
+  },
+  {
+    "name": "booklore-app/booklore",
+    "version": "v1.8.1",
+    "date": "2025-10-20T20:53:56Z"
+  },
+  {
+    "name": "coder/code-server",
+    "version": "v4.105.1",
+    "date": "2025-10-20T20:19:23Z"
+  },
+  {
+    "name": "pymedusa/Medusa",
+    "version": "v1.0.23",
+    "date": "2025-10-20T19:51:33Z"
+  },
+  {
+    "name": "chrisbenincasa/tunarr",
+    "version": "v0.23.0-alpha.16",
+    "date": "2025-10-20T19:29:20Z"
+  },
+  {
+    "name": "MediaBrowser/Emby.Releases",
+    "version": "4.9.1.80",
+    "date": "2025-09-30T20:25:16Z"
+  },
+  {
+    "name": "kyantech/Palmr",
+    "version": "v3.2.4-beta",
+    "date": "2025-10-20T17:58:55Z"
+  },
+  {
+    "name": "tailscale/tailscale",
+    "version": "v1.91.0-pre",
+    "date": "2025-10-20T16:18:51Z"
+  },
+  {
+    "name": "louislam/uptime-kuma",
+    "version": "2.0.1",
+    "date": "2025-10-20T16:11:12Z"
+  },
+  {
+    "name": "msgbyte/tianji",
+    "version": "v1.29.2",
+    "date": "2025-10-20T16:07:20Z"
+  },
+  {
+    "name": "chrisvel/tududi",
+    "version": "v0.84.1",
+    "date": "2025-10-20T15:32:24Z"
+  },
+  {
+    "name": "rclone/rclone",
+    "version": "v1.71.2",
+    "date": "2025-10-20T15:25:52Z"
+  },
+  {
+    "name": "Graylog2/graylog2-server",
+    "version": "7.0.0-rc.1",
+    "date": "2025-10-20T11:53:31Z"
+  },
+  {
+    "name": "Kareadita/Kavita",
+    "version": "v0.8.8",
+    "date": "2025-10-20T11:26:24Z"
+  },
  {
    "name": "wizarrrr/wizarr",
    "version": "v2025.10.4",
    "date": "2025-10-20T10:45:54Z"
  },
-  {
-    "name": "apache/cassandra",
-    "version": "cassandra-4.0.19",
-    "date": "2025-10-20T09:08:49Z"
-  },
  {
    "name": "jupyter/notebook",
    "version": "@jupyter-notebook/ui-components@7.5.0-beta.1",
    "date": "2025-10-20T07:01:38Z"
  },
-  {
-    "name": "Jackett/Jackett",
-    "version": "v0.24.159",
-    "date": "2025-10-20T05:53:23Z"
-  },
  {
    "name": "inventree/InvenTree",
    "version": "1.0.7",
@@ -49,16 +184,6 @@
    "version": "v1.0.0-beta27",
    "date": "2025-10-20T00:38:13Z"
  },
-  {
-    "name": "jeedom/core",
-    "version": "4.4.20",
-    "date": "2025-10-20T00:27:05Z"
-  },
-  {
-    "name": "steveiliop56/tinyauth",
-    "version": "v4.0.1",
-    "date": "2025-10-15T16:53:55Z"
-  },
  {
    "name": "seriousm4x/UpSnap",
    "version": "5.2.3",
@@ -99,11 +224,6 @@
    "version": "v2.14.5.4836",
    "date": "2025-10-08T15:30:50Z"
  },
-  {
-    "name": "henrygd/beszel",
-    "version": "v0.14.0",
-    "date": "2025-10-18T23:54:15Z"
-  },
  {
    "name": "BerriAI/litellm",
    "version": "v1.78.5.rc.1",
@@ -124,11 +244,6 @@
    "version": "v2025-10-18",
    "date": "2025-10-18T20:35:54Z"
  },
-  {
-    "name": "chrisvel/tududi",
-    "version": "v0.84",
-    "date": "2025-10-18T19:39:04Z"
-  },
  {
    "name": "moghtech/komodo",
    "version": "v1.19.5",
@@ -154,21 +269,6 @@
    "version": "v0.9.0",
    "date": "2025-10-18T17:03:56Z"
  },
-  {
-    "name": "booklore-app/booklore",
-    "version": "v1.8.0",
-    "date": "2025-10-18T16:22:25Z"
-  },
-  {
-    "name": "chrisbenincasa/tunarr",
-    "version": "v0.23.0-alpha.14",
-    "date": "2025-10-18T15:43:53Z"
-  },
-  {
-    "name": "msgbyte/tianji",
-    "version": "v1.29.1",
-    "date": "2025-10-18T13:14:21Z"
-  },
  {
    "name": "TasmoAdmin/TasmoAdmin",
    "version": "v4.3.2",
@@ -199,11 +299,6 @@
    "version": "v25.4",
    "date": "2025-10-09T10:27:01Z"
  },
-  {
-    "name": "TwiN/gatus",
-    "version": "v5.27.0",
-    "date": "2025-10-18T02:44:26Z"
-  },
  {
    "name": "9001/copyparty",
    "version": "v1.19.17",
@@ -219,26 +314,11 @@
    "version": "2025.10.3",
    "date": "2025-10-17T21:15:07Z"
  },
-  {
-    "name": "coder/code-server",
-    "version": "v4.105.0",
-    "date": "2025-10-17T19:55:55Z"
-  },
-  {
-    "name": "MediaBrowser/Emby.Releases",
-    "version": "4.9.1.80",
-    "date": "2025-09-30T20:25:16Z"
-  },
  {
    "name": "forgejo/forgejo",
    "version": "v13.0.1",
    "date": "2025-10-17T18:54:16Z"
  },
-  {
-    "name": "keycloak/keycloak",
-    "version": "26.4.1",
-    "date": "2025-10-16T07:21:53Z"
-  },
  {
    "name": "grokability/snipe-it",
    "version": "v8.3.4",
@@ -254,6 +334,11 @@
    "version": "v2.40.1",
    "date": "2025-10-17T13:42:04Z"
  },
+  {
+    "name": "neo4j/neo4j",
+    "version": "5.26.14",
+    "date": "2025-10-17T12:38:22Z"
+  },
  {
    "name": "mattermost/mattermost",
    "version": "server/public/v0.1.21",
@@ -369,11 +454,6 @@
    "version": "v2.13.1",
    "date": "2025-10-15T13:29:37Z"
  },
-  {
-    "name": "meilisearch/meilisearch",
-    "version": "prototype-docker-alpine-3-22-v8",
-    "date": "2025-10-15T13:20:20Z"
-  },
  {
    "name": "TandoorRecipes/recipes",
    "version": "2.3.3",
@@ -384,11 +464,6 @@
    "version": "jenkins-2.528.1",
    "date": "2025-10-15T12:51:20Z"
  },
-  {
-    "name": "Graylog2/graylog2-server",
-    "version": "7.0.0-beta.5",
-    "date": "2025-10-15T11:43:16Z"
-  },
  {
    "name": "cockpit-project/cockpit",
    "version": "349",
@@ -399,11 +474,6 @@
    "version": "v0.14.1",
    "date": "2024-08-29T22:32:51Z"
  },
-  {
-    "name": "openobserve/openobserve",
-    "version": "v0.15.2",
-    "date": "2025-10-15T07:42:29Z"
-  },
  {
    "name": "wavelog/wavelog",
    "version": "2.1.2",
@@ -419,21 +489,11 @@
    "version": "2025.10.0",
    "date": "2025-10-14T19:07:37Z"
  },
-  {
-    "name": "evcc-io/evcc",
-    "version": "0.209.2",
-    "date": "2025-10-14T18:55:44Z"
-  },
  {
    "name": "crafty-controller/crafty-4",
    "version": "v4.5.5",
    "date": "2025-10-14T18:48:36Z"
  },
-  {
-    "name": "tailscale/tailscale",
-    "version": "v1.88.4",
-    "date": "2025-10-14T17:57:52Z"
-  },
  {
    "name": "plankanban/planka",
    "version": "planka-1.1.0",
@@ -449,11 +509,6 @@
    "version": "v1.140.0",
    "date": "2025-10-14T15:57:12Z"
  },
-  {
-    "name": "n8n-io/n8n",
-    "version": "n8n@1.115.3",
-    "date": "2025-10-14T14:40:17Z"
-  },
  {
    "name": "rogerfar/rdt-client",
    "version": "v2.0.119",
@@ -584,11 +639,6 @@
    "version": "11.0.1",
    "date": "2025-10-09T12:34:15Z"
  },
-  {
-    "name": "documenso/documenso",
-    "version": "v1.12.10",
-    "date": "2025-10-09T04:32:35Z"
-  },
  {
    "name": "rabbitmq/rabbitmq-server",
    "version": "v4.1.4",
@@ -639,11 +689,6 @@
    "version": "v0.15.1",
    "date": "2025-10-07T20:30:56Z"
  },
-  {
-    "name": "VictoriaMetrics/VictoriaMetrics",
-    "version": "pmm-6401-v1.127.0",
-    "date": "2025-10-07T14:31:32Z"
-  },
  {
    "name": "thecfu/scraparr",
    "version": "v2.2.5",
@@ -714,11 +759,6 @@
    "version": "8.2.2",
    "date": "2025-10-03T06:22:38Z"
  },
-  {
-    "name": "kyantech/Palmr",
-    "version": "v3.2.3-beta",
-    "date": "2025-10-02T13:48:14Z"
-  },
  {
    "name": "actualbudget/actual",
    "version": "v25.10.0",
@@ -739,11 +779,6 @@
    "version": "v5.41.4",
    "date": "2025-09-30T22:26:11Z"
  },
-  {
-    "name": "zabbix/zabbix",
-    "version": "7.4.3",
-    "date": "2025-09-30T21:49:53Z"
-  },
  {
    "name": "mongodb/mongo",
    "version": "r8.2.1",
@@ -764,21 +799,11 @@
    "version": "v1.7.4",
    "date": "2025-09-30T13:34:30Z"
  },
-  {
-    "name": "neo4j/neo4j",
-    "version": "4.4.46",
-    "date": "2025-09-30T13:21:24Z"
-  },
  {
    "name": "thomiceli/opengist",
    "version": "v1.11.1",
    "date": "2025-09-30T00:24:16Z"
  },
-  {
-    "name": "goauthentik/authentik",
-    "version": "version/2025.8.4",
-    "date": "2025-09-30T00:03:11Z"
-  },
  {
    "name": "influxdata/telegraf",
    "version": "v1.36.2",
@@ -849,11 +874,6 @@
    "version": "1.2.39",
    "date": "2025-09-25T15:57:02Z"
  },
-  {
-    "name": "rclone/rclone",
-    "version": "v1.71.1",
-    "date": "2025-09-24T16:32:16Z"
-  },
  {
    "name": "alexta69/metube",
    "version": "2025.09.24",
@@ -869,11 +889,6 @@
    "version": "v2.0.10",
    "date": "2025-09-24T08:33:37Z"
  },
-  {
-    "name": "grafana/grafana",
-    "version": "v12.2.0",
-    "date": "2025-09-23T23:47:02Z"
-  },
  {
    "name": "postgres/postgres",
    "version": "REL_18_0",
@@ -1014,11 +1029,6 @@
    "version": "0.6",
    "date": "2025-09-05T06:05:04Z"
  },
-  {
-    "name": "louislam/uptime-kuma",
-    "version": "2.0.0-beta.2-temp",
-    "date": "2025-03-28T08:45:58Z"
-  },
  {
    "name": "healthchecks/healthchecks",
    "version": "v3.11.2",
@@ -1224,11 +1234,6 @@
    "version": "250707-d28b3101e",
    "date": "2025-07-07T15:15:21Z"
  },
-  {
-    "name": "Kareadita/Kavita",
-    "version": "v0.8.7",
-    "date": "2025-07-05T20:08:58Z"
-  },
  {
    "name": "qbittorrent/qBittorrent",
    "version": "release-5.1.2",
@@ -1479,11 +1484,6 @@
    "version": "v0.7.3",
    "date": "2024-12-15T10:18:06Z"
  },
-  {
-    "name": "pymedusa/Medusa",
-    "version": "v1.0.22",
-    "date": "2024-12-13T12:22:19Z"
-  },
  {
    "name": "phpipam/phpipam",
    "version": "v1.7.3",
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -36,12 +36,16 @@
    "@xterm/addon-fit": "^0.10.0",
    "@xterm/addon-web-links": "^0.11.0",
    "@xterm/xterm": "^5.5.0",
+    "axios": "^1.7.9",
    "bcryptjs": "^3.0.2",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
+    "cron-validator": "^1.2.0",
+    "dotenv": "^17.2.3",
    "jsonwebtoken": "^9.0.2",
    "lucide-react": "^0.546.0",
    "next": "^15.5.6",
+    "node-cron": "^3.0.3",
    "node-pty": "^1.0.0",
    "react": "^19.0.0",
    "react-dom": "^19.0.0",
@@ -51,36 +55,37 @@
    "remark-gfm": "^4.0.1",
    "server-only": "^0.0.1",
    "strip-ansi": "^7.1.2",
-    "superjson": "^2.2.1",
+    "superjson": "^2.2.3",
    "tailwind-merge": "^3.3.1",
    "ws": "^8.18.3",
    "zod": "^4.1.12"
  },
  "devDependencies": {
    "@eslint/eslintrc": "^3.3.1",
-    "@tailwindcss/postcss": "^4.0.15",
+    "@tailwindcss/postcss": "^4.1.15",
    "@testing-library/jest-dom": "^6.9.1",
    "@testing-library/react": "^16.3.0",
    "@testing-library/user-event": "^14.6.1",
    "@types/bcryptjs": "^3.0.0",
    "@types/better-sqlite3": "^7.6.8",
    "@types/jsonwebtoken": "^9.0.10",
-    "@types/node": "^24.8.1",
+    "@types/node": "^24.9.1",
+    "@types/node-cron": "^3.0.11",
    "@types/react": "^19.0.0",
    "@types/react-dom": "^19.2.2",
    "@vitejs/plugin-react": "^5.0.2",
    "@vitest/coverage-v8": "^3.2.4",
    "@vitest/ui": "^3.2.4",
    "eslint": "^9.38.0",
-    "eslint-config-next": "^15.5.6",
-    "jsdom": "^27.0.0",
+    "eslint-config-next": "^16.0.0",
+    "jsdom": "^27.0.1",
    "postcss": "^8.5.3",
    "prettier": "^3.5.3",
    "prettier-plugin-tailwindcss": "^0.7.1",
-    "prisma": "^6.17.1",
-    "tailwindcss": "^4.1.14",
+    "prisma": "^6.18.0",
+    "tailwindcss": "^4.1.16",
    "typescript": "^5.8.2",
-    "typescript-eslint": "^8.46.1",
+    "typescript-eslint": "^8.46.2",
    "vitest": "^3.2.4"
  },
  "ct3aMetadata": {
--- a/scripts/core/build.func
+++ b/scripts/core/build.func
@@ -439,17 +439,14 @@ advanced_settings() {
      exit_script
    fi
  done
-
  if CT_ID=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set Container ID" 8 58 "$NEXTID" --title "CONTAINER ID" 3>&1 1>&2 2>&3); then
    if [ -z "$CT_ID" ]; then
      CT_ID="$NEXTID"
-      echo -e "${CONTAINERID}${BOLD}${DGN}Container ID: ${BGN}$CT_ID${CL}"
-    else
-      echo -e "${CONTAINERID}${BOLD}${DGN}Container ID: ${BGN}$CT_ID${CL}"
    fi
  else
    exit_script
  fi
+  echo -e "${CONTAINERID}${BOLD}${DGN}Container ID: ${BGN}$CT_ID${CL}"

  while true; do
    if CT_NAME=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set Hostname" 8 58 "$NSAPP" --title "HOSTNAME" 3>&1 1>&2 2>&3); then
--- a/scripts/core/tools.func
+++ b/scripts/core/tools.func
--- a/scripts/json/bunkerweb.json
+++ b/scripts/json/bunkerweb.json
@@ -12,7 +12,7 @@
  "documentation": "https://docs.bunkerweb.io/latest/",
  "website": "https://www.bunkerweb.io/",
  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/bunkerweb.webp",
-  "config_path": "/opt/bunkerweb/variables.env",
+  "config_path": "/etc/bunkerweb/variables.env",
  "description": "BunkerWeb is a security-focused web server that enhances web application protection. It guards against common web vulnerabilities like SQL injection, XSS, and CSRF. It features simple setup and configuration using a YAML file, customizable security rules, and provides detailed logs for traffic monitoring and threat detection.",
  "install_methods": [
    {
--- a/scripts/json/execute.json
+++ b/scripts/json/execute.json
@@ -0,0 +1,48 @@
+{
+  "name": "PVE LXC Execute Command",
+  "slug": "lxc-execute",
+  "categories": [
+    1
+  ],
+  "date_created": "2025-09-18",
+  "type": "pve",
+  "updateable": false,
+  "privileged": false,
+  "interface_port": null,
+  "documentation": null,
+  "website": null,
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/proxmox.webp",
+  "config_path": "",
+  "description": "This script allows administrators to execute a custom command inside one or multiple LXC containers on a Proxmox VE node. Containers can be selectively excluded via an interactive checklist. If a container is stopped, the script will automatically start it, run the command, and then shut it down again. Only Debian and Ubuntu based containers are supported.",
+  "install_methods": [
+    {
+      "type": "default",
+      "script": "tools/pve/execute.sh",
+      "resources": {
+        "cpu": null,
+        "ram": null,
+        "hdd": null,
+        "os": null,
+        "version": null
+      }
+    }
+  ],
+  "default_credentials": {
+    "username": null,
+    "password": null
+  },
+  "notes": [
+    {
+      "text": "Execute within the Proxmox shell.",
+      "type": "info"
+    },
+    {
+      "text": "Non-Debian/Ubuntu containers will be skipped automatically.",
+      "type": "info"
+    },
+    {
+      "text": "Stopped containers will be started temporarily to run the command, then shut down again.",
+      "type": "warning"
+    }
+  ]
+}
--- a/scripts/json/glpi.json
+++ b/scripts/json/glpi.json
@@ -23,7 +23,7 @@
        "ram": 2048,
        "hdd": 10,
        "os": "debian",
-        "version": "12"
+        "version": "13"
      }
    }
  ],
--- a/scripts/json/guardian.json
+++ b/scripts/json/guardian.json
@@ -12,7 +12,7 @@
  "documentation": "https://github.com/HydroshieldMKII/Guardian/blob/main/README.md",
  "config_path": "/opt/guardian/.env",
  "website": "https://github.com/HydroshieldMKII/Guardian",
-  "logo": null,
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/guardian-plex.webp",
  "description": "Guardian is a lightweight companion app for Plex that lets you monitor, approve or block devices in real time. It helps you enforce per-user or global policies, stop unwanted sessions automatically and grant temporary access - all through a simple web interface.",
  "install_methods": [
    {
--- a/scripts/json/jellyfin.json
+++ b/scripts/json/jellyfin.json
@@ -21,7 +21,7 @@
      "resources": {
        "cpu": 2,
        "ram": 2048,
-        "hdd": 8,
+        "hdd": 16,
        "os": "ubuntu",
        "version": "24.04"
      }
--- a/scripts/json/jotty.json
+++ b/scripts/json/jotty.json
@@ -0,0 +1,40 @@
+{
+  "name": "jotty",
+  "slug": "jotty",
+  "categories": [
+    12
+  ],
+  "date_created": "2025-10-21",
+  "type": "ct",
+  "updateable": true,
+  "privileged": false,
+  "interface_port": 3000,
+  "documentation": "https://github.com/fccview/jotty/blob/main/README.md",
+  "website": "https://github.com/fccview/jotty",
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/jotty.webp",
+  "config_path": "/opt/jotty/.env",
+  "description": "A simple, self-hosted app for your checklists and notes. Tired of bloated, cloud-based to-do apps? jotty is a lightweight alternative for managing your personal checklists and notes. It's built with Next.js 14, is easy to deploy, and keeps all your data on your own server.",
+  "install_methods": [
+    {
+      "type": "default",
+      "script": "ct/jotty.sh",
+      "resources": {
+        "cpu": 2,
+        "ram": 3072,
+        "hdd": 6,
+        "os": "debian",
+        "version": "13"
+      }
+    }
+  ],
+  "default_credentials": {
+    "username": null,
+    "password": null
+  },
+  "notes": [
+    {
+      "text": "jotty was previously named rwMarkable",
+      "type": "info"
+    }
+  ]
+}
--- a/scripts/json/kavita.json
+++ b/scripts/json/kavita.json
@@ -23,7 +23,7 @@
        "ram": 2048,
        "hdd": 8,
        "os": "debian",
-        "version": "12"
+        "version": "13"
      }
    }
  ],
--- a/scripts/json/metadata.json
+++ b/scripts/json/metadata.json
@@ -1,186 +1,186 @@
 {
-	"categories": [
-		{
-			"name": "Proxmox & Virtualization",
-			"id": 1,
-			"sort_order": 1.0,
-			"description": "Tools and scripts to manage Proxmox VE and virtualization platforms effectively.",
-			"icon": "server"
-		},
-		{
-			"name": "Operating Systems",
-			"id": 2,
-			"sort_order": 2.0,
-			"description": "Scripts for deploying and managing various operating systems.",
-			"icon": "monitor"
-		},
-		{
-			"name": "Containers & Docker",
-			"id": 3,
-			"sort_order": 3.0,
-			"description": "Solutions for containerization using Docker and related technologies.",
-			"icon": "box"
-		},
-		{
-			"name": "Network & Firewall",
-			"id": 4,
-			"sort_order": 4.0,
-			"description": "Enhance network security and configure firewalls with ease.",
-			"icon": "shield"
-		},
-		{
-			"name": "Adblock & DNS",
-			"id": 5,
-			"sort_order": 5.0,
-			"description": "Optimize your network with DNS and ad-blocking solutions.",
-			"icon": "ban"
-		},
-		{
-			"name": "Authentication & Security",
-			"id": 6,
-			"sort_order": 6.0,
-			"description": "Secure your infrastructure with authentication and security tools.",
-			"icon": "lock"
-		},
-		{
-			"name": "Backup & Recovery",
-			"id": 7,
-			"sort_order": 7.0,
-			"description": "Reliable backup and recovery scripts to protect your data.",
-			"icon": "archive"
-		},
-		{
-			"name": "Databases",
-			"id": 8,
-			"sort_order": 8.0,
-			"description": "Deploy and manage robust database systems with ease.",
-			"icon": "database"
-		},
-		{
-			"name": "Monitoring & Analytics",
-			"id": 9,
-			"sort_order": 9.0,
-			"description": "Monitor system performance and analyze data seamlessly.",
-			"icon": "bar-chart"
-		},
-		{
-			"name": "Dashboards & Frontends",
-			"id": 10,
-			"sort_order": 10.0,
-			"description": "Create interactive dashboards and user-friendly frontends.",
-			"icon": "layout"
-		},
-		{
-			"name": "Files & Downloads",
-			"id": 11,
-			"sort_order": 11.0,
-			"description": "Manage file sharing and downloading solutions efficiently.",
-			"icon": "download"
-		},
-		{
-			"name": "Documents & Notes",
-			"id": 12,
-			"sort_order": 12.0,
-			"description": "Organize and manage documents and note-taking tools.",
-			"icon": "file-text"
-		},
-		{
-			"name": "Media & Streaming",
-			"id": 13,
-			"sort_order": 13.0,
-			"description": "Stream and manage media effortlessly across devices.",
-			"icon": "play"
-		},
-		{
-			"name": "*Arr Suite",
-			"id": 14,
-			"sort_order": 14.0,
-			"description": "Automated media management with the popular *Arr suite tools.",
-			"icon": "tv"
-		},
-		{
-			"name": "NVR & Cameras",
-			"id": 15,
-			"sort_order": 15.0,
-			"description": "Manage network video recorders and camera setups.",
-			"icon": "camera"
-		},
-		{
-			"name": "IoT & Smart Home",
-			"id": 16,
-			"sort_order": 16.0,
-			"description": "Control and automate IoT devices and smart home systems.",
-			"icon": "home"
-		},
-		{
-			"name": "ZigBee, Z-Wave & Matter",
-			"id": 17,
-			"sort_order": 17.0,
-			"description": "Solutions for ZigBee, Z-Wave, and Matter-based device management.",
-			"icon": "radio"
-		},
-		{
-			"name": "MQTT & Messaging",
-			"id": 18,
-			"sort_order": 18.0,
-			"description": "Set up reliable messaging and MQTT-based communication systems.",
-			"icon": "message-circle"
-		},
-		{
-			"name": "Automation & Scheduling",
-			"id": 19,
-			"sort_order": 19.0,
-			"description": "Automate tasks and manage scheduling with powerful tools.",
-			"icon": "clock"
-		},
-		{
-			"name": "AI / Coding & Dev-Tools",
-			"id": 20,
-			"sort_order": 20.0,
-			"description": "Leverage AI and developer tools for smarter coding workflows.",
-			"icon": "code"
-		},
-		{
-			"name": "Webservers & Proxies",
-			"id": 21,
-			"sort_order": 21.0,
-			"description": "Deploy and configure web servers and proxy solutions.",
-			"icon": "globe"
-		},
-		{
-			"name": "Bots & ChatOps",
-			"id": 22,
-			"sort_order": 22.0,
-			"description": "Enhance collaboration with bots and ChatOps integrations.",
-			"icon": "bot"
-		},
-		{
-			"name": "Finance & Budgeting",
-			"id": 23,
-			"sort_order": 23.0,
-			"description": "Track expenses and manage budgets efficiently.",
-			"icon": "dollar-sign"
-		},
-		{
-			"name": "Gaming & Leisure",
-			"id": 24,
-			"sort_order": 24.0,
-			"description": "Scripts for gaming servers and leisure-related tools.",
-			"icon": "gamepad-2"
-		},
-		{
-			"name": "Business & ERP",
-			"id": 25,
-			"sort_order": 25.0,
-			"description": "Streamline business operations with ERP and management tools.",
-			"icon": "building"
-		},
-		{
-			"name": "Miscellaneous",
-			"id": 0,
-			"sort_order": 99.0,
-			"description": "General scripts and tools that don't fit into other categories.",
-			"icon": "more-horizontal"
-		}
-	]
-}
+  "categories": [
+    {
+      "name": "Proxmox & Virtualization",
+      "id": 1,
+      "sort_order": 1.0,
+      "description": "Tools and scripts to manage Proxmox VE and virtualization platforms effectively.",
+      "icon": "server"
+    },
+    {
+      "name": "Operating Systems",
+      "id": 2,
+      "sort_order": 2.0,
+      "description": "Scripts for deploying and managing various operating systems.",
+      "icon": "monitor"
+    },
+    {
+      "name": "Containers & Docker",
+      "id": 3,
+      "sort_order": 3.0,
+      "description": "Solutions for containerization using Docker and related technologies.",
+      "icon": "box"
+    },
+    {
+      "name": "Network & Firewall",
+      "id": 4,
+      "sort_order": 4.0,
+      "description": "Enhance network security and configure firewalls with ease.",
+      "icon": "shield"
+    },
+    {
+      "name": "Adblock & DNS",
+      "id": 5,
+      "sort_order": 5.0,
+      "description": "Optimize your network with DNS and ad-blocking solutions.",
+      "icon": "ban"
+    },
+    {
+      "name": "Authentication & Security",
+      "id": 6,
+      "sort_order": 6.0,
+      "description": "Secure your infrastructure with authentication and security tools.",
+      "icon": "lock"
+    },
+    {
+      "name": "Backup & Recovery",
+      "id": 7,
+      "sort_order": 7.0,
+      "description": "Reliable backup and recovery scripts to protect your data.",
+      "icon": "archive"
+    },
+    {
+      "name": "Databases",
+      "id": 8,
+      "sort_order": 8.0,
+      "description": "Deploy and manage robust database systems with ease.",
+      "icon": "database"
+    },
+    {
+      "name": "Monitoring & Analytics",
+      "id": 9,
+      "sort_order": 9.0,
+      "description": "Monitor system performance and analyze data seamlessly.",
+      "icon": "bar-chart"
+    },
+    {
+      "name": "Dashboards & Frontends",
+      "id": 10,
+      "sort_order": 10.0,
+      "description": "Create interactive dashboards and user-friendly frontends.",
+      "icon": "layout"
+    },
+    {
+      "name": "Files & Downloads",
+      "id": 11,
+      "sort_order": 11.0,
+      "description": "Manage file sharing and downloading solutions efficiently.",
+      "icon": "download"
+    },
+    {
+      "name": "Documents & Notes",
+      "id": 12,
+      "sort_order": 12.0,
+      "description": "Organize and manage documents and note-taking tools.",
+      "icon": "file-text"
+    },
+    {
+      "name": "Media & Streaming",
+      "id": 13,
+      "sort_order": 13.0,
+      "description": "Stream and manage media effortlessly across devices.",
+      "icon": "play"
+    },
+    {
+      "name": "*Arr Suite",
+      "id": 14,
+      "sort_order": 14.0,
+      "description": "Automated media management with the popular *Arr suite tools.",
+      "icon": "tv"
+    },
+    {
+      "name": "NVR & Cameras",
+      "id": 15,
+      "sort_order": 15.0,
+      "description": "Manage network video recorders and camera setups.",
+      "icon": "camera"
+    },
+    {
+      "name": "IoT & Smart Home",
+      "id": 16,
+      "sort_order": 16.0,
+      "description": "Control and automate IoT devices and smart home systems.",
+      "icon": "home"
+    },
+    {
+      "name": "ZigBee, Z-Wave & Matter",
+      "id": 17,
+      "sort_order": 17.0,
+      "description": "Solutions for ZigBee, Z-Wave, and Matter-based device management.",
+      "icon": "radio"
+    },
+    {
+      "name": "MQTT & Messaging",
+      "id": 18,
+      "sort_order": 18.0,
+      "description": "Set up reliable messaging and MQTT-based communication systems.",
+      "icon": "message-circle"
+    },
+    {
+      "name": "Automation & Scheduling",
+      "id": 19,
+      "sort_order": 19.0,
+      "description": "Automate tasks and manage scheduling with powerful tools.",
+      "icon": "clock"
+    },
+    {
+      "name": "AI / Coding & Dev-Tools",
+      "id": 20,
+      "sort_order": 20.0,
+      "description": "Leverage AI and developer tools for smarter coding workflows.",
+      "icon": "code"
+    },
+    {
+      "name": "Webservers & Proxies",
+      "id": 21,
+      "sort_order": 21.0,
+      "description": "Deploy and configure web servers and proxy solutions.",
+      "icon": "globe"
+    },
+    {
+      "name": "Bots & ChatOps",
+      "id": 22,
+      "sort_order": 22.0,
+      "description": "Enhance collaboration with bots and ChatOps integrations.",
+      "icon": "bot"
+    },
+    {
+      "name": "Finance & Budgeting",
+      "id": 23,
+      "sort_order": 23.0,
+      "description": "Track expenses and manage budgets efficiently.",
+      "icon": "dollar-sign"
+    },
+    {
+      "name": "Gaming & Leisure",
+      "id": 24,
+      "sort_order": 24.0,
+      "description": "Scripts for gaming servers and leisure-related tools.",
+      "icon": "gamepad-2"
+    },
+    {
+      "name": "Business & ERP",
+      "id": 25,
+      "sort_order": 25.0,
+      "description": "Streamline business operations with ERP and management tools.",
+      "icon": "building"
+    },
+    {
+      "name": "Miscellaneous",
+      "id": 0,
+      "sort_order": 99.0,
+      "description": "General scripts and tools that don't fit into other categories.",
+      "icon": "more-horizontal"
+    }
+  ]
+}
--- a/scripts/json/mysql.json
+++ b/scripts/json/mysql.json
@@ -23,7 +23,7 @@
        "ram": 1024,
        "hdd": 4,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    }
  ],
--- a/scripts/json/nextcloudpi.json
+++ b/scripts/json/nextcloudpi.json
@@ -23,7 +23,7 @@
        "ram": 2048,
        "hdd": 8,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    },
    {
--- a/scripts/json/odoo.json
+++ b/scripts/json/odoo.json
@@ -23,7 +23,7 @@
        "ram": 2048,
        "hdd": 6,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    }
  ],
--- a/scripts/json/omv.json
+++ b/scripts/json/omv.json
@@ -23,7 +23,7 @@
        "ram": 1024,
        "hdd": 4,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    }
  ],
--- a/scripts/json/open-archiver.json
+++ b/scripts/json/open-archiver.json
@@ -0,0 +1,40 @@
+{
+  "name": "Open-Archiver",
+  "slug": "open-archiver",
+  "categories": [
+    7
+  ],
+  "date_created": "2025-10-18",
+  "type": "ct",
+  "updateable": true,
+  "privileged": false,
+  "interface_port": 3000,
+  "documentation": "https://docs.openarchiver.com/",
+  "config_path": "/opt/openarchiver/.env",
+  "website": "https://openarchiver.com/",
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons/webp/open-archiver.webp",
+  "description": "Open Archiver is a secure, self-hosted email archiving solution, and it's completely open source. Get an email archiver that enables full-text search across email and attachments. Create a permanent, searchable, and compliant mail archive from Google Workspace, Microsoft 35, and any IMAP server.",
+  "install_methods": [
+    {
+      "type": "default",
+      "script": "ct/open-archiver.sh",
+      "resources": {
+        "cpu": 2,
+        "ram": 3072,
+        "hdd": 8,
+        "os": "debian",
+        "version": "13"
+      }
+    }
+  ],
+  "default_credentials": {
+    "username": null,
+    "password": null
+  },
+  "notes": [
+    {
+      "text": "Data directory is: `/opt/openarchiver-data`. If you have a lot of email, you might consider mounting external storage to this directory.",
+      "type": "info"
+    }
+  ]
+}
--- a/scripts/json/openwebui.json
+++ b/scripts/json/openwebui.json
@@ -23,7 +23,7 @@
        "ram": 8192,
        "hdd": 25,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    }
  ],
--- a/scripts/json/paperless-ai.json
+++ b/scripts/json/paperless-ai.json
@@ -19,8 +19,8 @@
      "type": "default",
      "script": "ct/paperless-ai.sh",
      "resources": {
-        "cpu": 2,
-        "ram": 2048,
+        "cpu": 4,
+        "ram": 4096,
        "hdd": 20,
        "os": "debian",
        "version": "13"
--- a/scripts/json/tautulli.json
+++ b/scripts/json/tautulli.json
@@ -23,7 +23,7 @@
        "ram": 1024,
        "hdd": 4,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    }
  ],
--- a/scripts/json/technitiumdns.json
+++ b/scripts/json/technitiumdns.json
@@ -23,7 +23,7 @@
        "ram": 512,
        "hdd": 2,
        "os": "debian",
-        "version": "13"
+        "version": "12"
      }
    }
  ],
--- a/scripts/json/undefined.json
+++ b/scripts/json/undefined.json
--- a/scripts/json/versions.json
+++ b/scripts/json/versions.json
--- a/scripts/json/zot-registry.json
+++ b/scripts/json/zot-registry.json
@@ -23,7 +23,7 @@
        "ram": 2048,
        "hdd": 5,
        "os": "Debian",
-        "version": "12"
+        "version": "13"
      }
    }
  ],
--- a/server.js
+++ b/server.js
@@ -8,6 +8,11 @@ import stripAnsi from 'strip-ansi';
 import { spawn as ptySpawn } from 'node-pty';
 import { getSSHExecutionService } from './src/server/ssh-execution-service.js';
 import { getDatabase } from './src/server/database-prisma.js';
+import { initializeAutoSync, setupGracefulShutdown } from './src/server/lib/autoSyncInit.js';
+import dotenv from 'dotenv';
+
+// Load environment variables from .env file
+dotenv.config();
 // Fallback minimal global error handlers for Node runtime (avoid TS import)
 function registerGlobalErrorHandlers() {
  if (registerGlobalErrorHandlers._registered) return;
@@ -976,5 +981,11 @@ app.prepare().then(() => {
    .listen(port, hostname, () => {
      console.log(`> Ready on http://${hostname}:${port}`);
      console.log(`> WebSocket server running on ws://${hostname}:${port}/ws/script-execution`);
+      
+      // Initialize auto-sync service
+      initializeAutoSync();
+      
+      // Setup graceful shutdown handlers
+      setupGracefulShutdown();
    });
 });
--- a/src/app/_components/DownloadedScriptsTab.tsx
+++ b/src/app/_components/DownloadedScriptsTab.tsx
@@ -356,7 +356,7 @@ export function DownloadedScriptsTab({ onInstallScript }: DownloadedScriptsTabPr
    }
  }, [selectedCategory]);

-  const handleCardClick = (scriptCard: { slug: string }) => {
+  const handleCardClick = (scriptCard: ScriptCardType) => {
    // All scripts are GitHub scripts, open modal
    setSelectedSlug(scriptCard.slug);
    setIsModalOpen(true);
--- a/src/app/_components/GeneralSettingsModal.tsx
+++ b/src/app/_components/GeneralSettingsModal.tsx
@@ -7,6 +7,7 @@ import { Toggle } from './ui/toggle';
 import { ContextualHelpIcon } from './ContextualHelpIcon';
 import { useTheme } from './ThemeProvider';
 import { useRegisterModal } from './modal/ModalStackProvider';
+import { api } from '~/trpc/react';

 interface GeneralSettingsModalProps {
  isOpen: boolean;
@@ -16,7 +17,7 @@ interface GeneralSettingsModalProps {
 export function GeneralSettingsModal({ isOpen, onClose }: GeneralSettingsModalProps) {
  useRegisterModal(isOpen, { id: 'general-settings-modal', allowEscape: true, onClose });
  const { theme, setTheme } = useTheme();
-  const [activeTab, setActiveTab] = useState<'general' | 'github' | 'auth'>('general');
+  const [activeTab, setActiveTab] = useState<'general' | 'github' | 'auth' | 'auto-sync'>('general');
  const [githubToken, setGithubToken] = useState('');
  const [saveFilter, setSaveFilter] = useState(false);
  const [savedFilters, setSavedFilters] = useState<any>(null);
@@ -34,6 +35,21 @@ export function GeneralSettingsModal({ isOpen, onClose }: GeneralSettingsModalPr
  const [authSetupCompleted, setAuthSetupCompleted] = useState(false);
  const [authLoading, setAuthLoading] = useState(false);

+  // Auto-sync state
+  const [autoSyncEnabled, setAutoSyncEnabled] = useState(false);
+  const [syncIntervalType, setSyncIntervalType] = useState<'predefined' | 'custom'>('predefined');
+  const [syncIntervalPredefined, setSyncIntervalPredefined] = useState('1hour');
+  const [syncIntervalCron, setSyncIntervalCron] = useState('');
+  const [autoDownloadNew, setAutoDownloadNew] = useState(false);
+  const [autoUpdateExisting, setAutoUpdateExisting] = useState(false);
+  const [notificationEnabled, setNotificationEnabled] = useState(false);
+  const [appriseUrls, setAppriseUrls] = useState<string[]>([]);
+  const [appriseUrlsText, setAppriseUrlsText] = useState('');
+  const [lastAutoSync, setLastAutoSync] = useState('');
+  const [lastAutoSyncError, setLastAutoSyncError] = useState<string | null>(null);
+  const [lastAutoSyncErrorTime, setLastAutoSyncErrorTime] = useState<string | null>(null);
+  const [cronValidationError, setCronValidationError] = useState('');
+
  // Load existing settings when modal opens
  useEffect(() => {
    if (isOpen) {
@@ -42,6 +58,7 @@ export function GeneralSettingsModal({ isOpen, onClose }: GeneralSettingsModalPr
      void loadSavedFilters();
      void loadAuthCredentials();
      void loadColorCodingSetting();
+      void loadAutoSyncSettings();
    }
  }, [isOpen]);

@@ -278,6 +295,140 @@ export function GeneralSettingsModal({ isOpen, onClose }: GeneralSettingsModalPr
    }
  };

+  // Auto-sync functions
+  const loadAutoSyncSettings = async () => {
+    try {
+      const response = await fetch('/api/settings/auto-sync');
+      if (response.ok) {
+        const data = await response.json() as { settings: any };
+        const settings = data.settings;
+        if (settings) {
+          setAutoSyncEnabled(settings.autoSyncEnabled ?? false);
+          setSyncIntervalType(settings.syncIntervalType ?? 'predefined');
+          setSyncIntervalPredefined(settings.syncIntervalPredefined ?? '1hour');
+          setSyncIntervalCron(settings.syncIntervalCron ?? '');
+          setAutoDownloadNew(settings.autoDownloadNew ?? false);
+          setAutoUpdateExisting(settings.autoUpdateExisting ?? false);
+          setNotificationEnabled(settings.notificationEnabled ?? false);
+          setAppriseUrls(settings.appriseUrls ?? []);
+          setAppriseUrlsText((settings.appriseUrls ?? []).join('\n'));
+          setLastAutoSync(settings.lastAutoSync ?? '');
+          setLastAutoSyncError(settings.lastAutoSyncError ?? null);
+          setLastAutoSyncErrorTime(settings.lastAutoSyncErrorTime ?? null);
+        }
+      }
+    } catch (error) {
+      console.error('Error loading auto-sync settings:', error);
+    }
+  };
+
+  const saveAutoSyncSettings = async () => {
+    setIsSaving(true);
+    setMessage(null);
+    
+    try {
+      const response = await fetch('/api/settings/auto-sync', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          autoSyncEnabled,
+          syncIntervalType,
+          syncIntervalPredefined,
+          syncIntervalCron,
+          autoDownloadNew,
+          autoUpdateExisting,
+          notificationEnabled,
+          appriseUrls: appriseUrls
+        })
+      });
+      
+      if (response.ok) {
+        setMessage({ type: 'success', text: 'Auto-sync settings saved successfully!' });
+        setTimeout(() => setMessage(null), 3000);
+      } else {
+        const errorData = await response.json();
+        setMessage({ type: 'error', text: errorData.error ?? 'Failed to save auto-sync settings' });
+      }
+    } catch (error) {
+      console.error('Error saving auto-sync settings:', error);
+      setMessage({ type: 'error', text: 'Failed to save auto-sync settings' });
+    } finally {
+      setIsSaving(false);
+    }
+  };
+
+  const handleAppriseUrlsChange = (text: string) => {
+    setAppriseUrlsText(text);
+    const urls = text.split('\n').filter(url => url.trim() !== '');
+    setAppriseUrls(urls);
+  };
+
+  const validateCronExpression = (cron: string) => {
+    if (!cron.trim()) {
+      setCronValidationError('');
+      return true;
+    }
+    
+    // Basic cron validation - you might want to use a library like cron-validator
+    const cronRegex = /^(\*|([0-5]?\d)) (\*|([01]?\d|2[0-3])) (\*|([012]?\d|3[01])) (\*|([0]?\d|1[0-2])) (\*|([0-6]))$/;
+    const isValid = cronRegex.test(cron);
+    
+    if (!isValid) {
+      setCronValidationError('Invalid cron expression format');
+      return false;
+    }
+    
+    setCronValidationError('');
+    return true;
+  };
+
+  const handleCronChange = (cron: string) => {
+    setSyncIntervalCron(cron);
+    validateCronExpression(cron);
+  };
+
+  const testNotification = async () => {
+    try {
+      const response = await fetch('/api/settings/auto-sync', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ testNotification: true })
+      });
+      
+      if (response.ok) {
+        setMessage({ type: 'success', text: 'Test notification sent successfully!' });
+      } else {
+        const errorData = await response.json();
+        setMessage({ type: 'error', text: errorData.error ?? 'Failed to send test notification' });
+      }
+    } catch (error) {
+      console.error('Error sending test notification:', error);
+      setMessage({ type: 'error', text: 'Failed to send test notification' });
+    }
+  };
+
+  const triggerManualSync = async () => {
+    try {
+      const response = await fetch('/api/settings/auto-sync', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ triggerManualSync: true })
+      });
+      
+      if (response.ok) {
+        setMessage({ type: 'success', text: 'Manual sync triggered successfully!' });
+        // Reload settings to get updated last sync time
+        await loadAutoSyncSettings();
+      } else {
+        const errorData = await response.json();
+        setMessage({ type: 'error', text: errorData.error ?? 'Failed to trigger manual sync' });
+      }
+    } catch (error) {
+      console.error('Error triggering manual sync:', error);
+      setMessage({ type: 'error', text: 'Failed to trigger manual sync' });
+    }
+  };
+
  if (!isOpen) return null;

  return (
@@ -340,6 +491,18 @@ export function GeneralSettingsModal({ isOpen, onClose }: GeneralSettingsModalPr
            >
              Authentication
            </Button>
+            <Button
+              onClick={() => setActiveTab('auto-sync')}
+              variant="ghost"
+              size="null"
+              className={`py-3 sm:py-4 px-1 border-b-2 font-medium text-sm w-full sm:w-auto ${
+                activeTab === 'auto-sync'
+                  ? 'border-primary text-primary'
+                  : 'border-transparent text-muted-foreground hover:text-foreground hover:border-border'
+              }`}
+            >
+              Auto-Sync
+            </Button>
          </nav>
        </div>

@@ -623,6 +786,302 @@ export function GeneralSettingsModal({ isOpen, onClose }: GeneralSettingsModalPr
              </div>
            </div>
          )}
+
+          {activeTab === 'auto-sync' && (
+            <div className="space-y-4 sm:space-y-6">
+              <div>
+                <h3 className="text-base sm:text-lg font-medium text-foreground mb-3 sm:mb-4">Auto-Sync Settings</h3>
+                <p className="text-sm sm:text-base text-muted-foreground mb-4">
+                  Configure automatic synchronization of scripts with configurable intervals and notifications.
+                </p>
+                
+                {/* Enable Auto-Sync */}
+                <div className="p-4 border border-border rounded-lg mb-4">
+                  <div className="flex items-center justify-between">
+                    <div>
+                      <h4 className="font-medium text-foreground mb-1">Enable Auto-Sync</h4>
+                      <p className="text-sm text-muted-foreground">Automatically sync JSON files from GitHub at specified intervals</p>
+                    </div>
+                    <Toggle
+                      checked={autoSyncEnabled}
+                      onCheckedChange={async (checked) => {
+                        setAutoSyncEnabled(checked);
+                        
+                        // Auto-save when toggle changes
+                        try {
+                          // If syncIntervalType is custom but no cron expression, fallback to predefined
+                          const effectiveSyncIntervalType = (syncIntervalType === 'custom' && !syncIntervalCron) 
+                            ? 'predefined' 
+                            : syncIntervalType;
+                          
+                          const response = await fetch('/api/settings/auto-sync', {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({
+                              autoSyncEnabled: checked,
+                              syncIntervalType: effectiveSyncIntervalType,
+                              syncIntervalPredefined: effectiveSyncIntervalType === 'predefined' ? syncIntervalPredefined : undefined,
+                              syncIntervalCron: effectiveSyncIntervalType === 'custom' ? syncIntervalCron : undefined,
+                              autoDownloadNew,
+                              autoUpdateExisting,
+                              notificationEnabled,
+                              appriseUrls: appriseUrls
+                            })
+                          });
+                          
+                          if (response.ok) {
+                            // Update local state to reflect the effective sync interval type
+                            if (effectiveSyncIntervalType !== syncIntervalType) {
+                              setSyncIntervalType(effectiveSyncIntervalType);
+                            }
+                          }
+                        } catch (error) {
+                          console.error('Error saving auto-sync toggle:', error);
+                        }
+                      }}
+                      disabled={isSaving}
+                    />
+                  </div>
+                </div>
+
+                {/* Sync Interval */}
+                {autoSyncEnabled && (
+                  <div className="p-4 border border-border rounded-lg mb-4">
+                    <h4 className="font-medium text-foreground mb-3">Sync Interval</h4>
+                    
+                    <div className="space-y-3">
+                      <div className="flex space-x-4">
+                        <label className="flex items-center">
+                          <input
+                            type="radio"
+                            name="syncIntervalType"
+                            value="predefined"
+                            checked={syncIntervalType === 'predefined'}
+                            onChange={(e) => setSyncIntervalType(e.target.value as 'predefined' | 'custom')}
+                            className="mr-2"
+                          />
+                          Predefined
+                        </label>
+                        <label className="flex items-center">
+                          <input
+                            type="radio"
+                            name="syncIntervalType"
+                            value="custom"
+                            checked={syncIntervalType === 'custom'}
+                            onChange={(e) => setSyncIntervalType(e.target.value as 'predefined' | 'custom')}
+                            className="mr-2"
+                          />
+                          Custom Cron
+                        </label>
+                      </div>
+
+                      {syncIntervalType === 'predefined' && (
+                        <div>
+                          <select
+                            value={syncIntervalPredefined}
+                            onChange={(e) => setSyncIntervalPredefined(e.target.value)}
+                            className="w-full p-2 border border-border rounded-md bg-background"
+                          >
+                            <option value="15min">Every 15 minutes</option>
+                            <option value="30min">Every 30 minutes</option>
+                            <option value="1hour">Every hour</option>
+                            <option value="6hours">Every 6 hours</option>
+                            <option value="12hours">Every 12 hours</option>
+                            <option value="24hours">Every 24 hours</option>
+                          </select>
+                        </div>
+                      )}
+
+                      {syncIntervalType === 'custom' && (
+                        <div>
+                          <Input
+                            placeholder="0 */6 * * * (every 6 hours)"
+                            value={syncIntervalCron}
+                            onChange={(e) => handleCronChange(e.target.value)}
+                            className="w-full"
+                            autoFocus
+                            onFocus={() => setCronValidationError('')}
+                          />
+                          {cronValidationError && (
+                            <p className="text-sm text-red-500 mt-1">{cronValidationError}</p>
+                          )}
+                          <p className="text-xs text-muted-foreground mt-1">
+                            Format: minute hour day month weekday. See{' '}
+                            <a href="https://crontab.guru" target="_blank" rel="noopener noreferrer" className="text-primary hover:underline">
+                              crontab.guru
+                            </a>{' '}
+                            for examples
+                          </p>
+                          <div className="mt-2 p-2 bg-muted rounded text-xs">
+                            <p className="font-medium mb-1">Common examples:</p>
+                            <ul className="space-y-1 text-muted-foreground">
+                              <li>• <code>* * * * *</code> - Every minute</li>
+                              <li>• <code>0 * * * *</code> - Every hour</li>
+                              <li>• <code>0 */6 * * *</code> - Every 6 hours</li>
+                              <li>• <code>0 0 * * *</code> - Every day at midnight</li>
+                              <li>• <code>0 0 * * 0</code> - Every Sunday at midnight</li>
+                            </ul>
+                          </div>
+                        </div>
+                      )}
+                    </div>
+                  </div>
+                )}
+
+                {/* Auto-Download Options */}
+                {autoSyncEnabled && (
+                  <div className="p-4 border border-border rounded-lg mb-4">
+                    <h4 className="font-medium text-foreground mb-3">Auto-Download Options</h4>
+                    
+                    <div className="space-y-3">
+                      <div className="flex items-center justify-between">
+                        <div>
+                          <h5 className="font-medium text-foreground">Auto-download new scripts</h5>
+                          <p className="text-sm text-muted-foreground">Automatically download scripts that haven't been downloaded yet</p>
+                        </div>
+                        <Toggle
+                          checked={autoDownloadNew}
+                          onCheckedChange={setAutoDownloadNew}
+                          disabled={isSaving}
+                        />
+                      </div>
+
+                      <div className="flex items-center justify-between">
+                        <div>
+                          <h5 className="font-medium text-foreground">Auto-update existing scripts</h5>
+                          <p className="text-sm text-muted-foreground">Automatically update scripts that have newer versions available</p>
+                        </div>
+                        <Toggle
+                          checked={autoUpdateExisting}
+                          onCheckedChange={setAutoUpdateExisting}
+                          disabled={isSaving}
+                        />
+                      </div>
+                    </div>
+                  </div>
+                )}
+
+                {/* Notifications */}
+                {autoSyncEnabled && (
+                  <div className="p-4 border border-border rounded-lg mb-4">
+                    <div className="flex items-center justify-between mb-3">
+                      <div>
+                        <h4 className="font-medium text-foreground">Enable Notifications</h4>
+                        <p className="text-sm text-muted-foreground">Send notifications when sync completes</p>
+                        <p className="text-xs text-muted-foreground mt-1">
+                          If you want any other notification service, please open an issue on the GitHub repository.
+                        </p>
+                      </div>
+                      <Toggle
+                        checked={notificationEnabled}
+                        onCheckedChange={setNotificationEnabled}
+                        disabled={isSaving}
+                      />
+                    </div>
+
+                    {notificationEnabled && (
+                      <div className="space-y-3">
+                        <div>
+                          <label htmlFor="apprise-urls" className="block text-sm font-medium text-foreground mb-1">
+                            Apprise URLs
+                          </label>
+                          <textarea
+                            id="apprise-urls"
+                            placeholder="http://YOUR_APPRISE_SERVER/notify/apprise&#10;"
+                            value={appriseUrlsText}
+                            onChange={(e) => handleAppriseUrlsChange(e.target.value)}
+                            className="w-full p-2 border border-border rounded-md bg-background h-24 resize-none"
+                            rows={3}
+                          />
+                          <p className="text-xs text-muted-foreground mt-1">
+                            One URL per line. Supports Discord, Telegram, Email, Slack, and more via{' '}
+                            <a href="https://github.com/caronc/apprise" target="_blank" rel="noopener noreferrer" className="text-primary hover:underline">
+                              Apprise
+                            </a>
+                          </p>
+                        </div>
+
+                        <div className="flex gap-2">
+                          <Button
+                            onClick={testNotification}
+                            variant="outline"
+                            size="sm"
+                            disabled={appriseUrls.length === 0}
+                          >
+                            Test Notification
+                          </Button>
+                        </div>
+                      </div>
+                    )}
+                  </div>
+                )}
+
+                {/* Status and Actions */}
+                {autoSyncEnabled && (
+                  <div className="p-4 border border-border rounded-lg mb-4">
+                    <h4 className="font-medium text-foreground mb-3">Status & Actions</h4>
+                    
+                    <div className="space-y-3">
+                      {lastAutoSync && (
+                        <div>
+                          <p className="text-sm text-muted-foreground">
+                            Last sync: {new Date(lastAutoSync).toLocaleString()}
+                          </p>
+                        </div>
+                      )}
+
+                      {lastAutoSyncError && (
+                        <div className="p-3 bg-error/10 text-error-foreground border border-error/20 rounded-md">
+                          <div className="flex items-start gap-2">
+                            <svg className="w-4 h-4 mt-0.5 flex-shrink-0" fill="currentColor" viewBox="0 0 20 20">
+                              <path fillRule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clipRule="evenodd" />
+                            </svg>
+                            <div>
+                              <p className="text-sm font-medium">Last sync error:</p>
+                              <p className="text-sm mt-1">{lastAutoSyncError}</p>
+                              {lastAutoSyncErrorTime && (
+                                <p className="text-xs mt-1 opacity-75">
+                                  {new Date(lastAutoSyncErrorTime).toLocaleString()}
+                                </p>
+                              )}
+                            </div>
+                          </div>
+                        </div>
+                      )}
+
+                      <div className="flex gap-2">
+                        <Button
+                          onClick={triggerManualSync}
+                          variant="outline"
+                          size="sm"
+                        >
+                          Trigger Sync Now
+                        </Button>
+                        <Button
+                          onClick={saveAutoSyncSettings}
+                          disabled={isSaving || (syncIntervalType === 'custom' && !!cronValidationError)}
+                          size="sm"
+                        >
+                          {isSaving ? 'Saving...' : 'Save Settings'}
+                        </Button>
+                      </div>
+                    </div>
+                  </div>
+                )}
+
+                {/* Message Display */}
+                {message && (
+                  <div className={`p-3 rounded-md text-sm ${
+                    message.type === 'success' 
+                      ? 'bg-success/10 text-success-foreground border border-success/20' 
+                      : 'bg-error/10 text-error-foreground border border-error/20'
+                  }`}>
+                    {message.text}
+                  </div>
+                )}
+              </div>
+            </div>
+          )}
        </div>
      </div>
    </div>
--- a/src/app/_components/HelpModal.tsx
+++ b/src/app/_components/HelpModal.tsx
@@ -2,7 +2,7 @@

 import { useState } from 'react';
 import { Button } from './ui/button';
-import { HelpCircle, Server, Settings, RefreshCw, Package, HardDrive, FolderOpen, Search, Download } from 'lucide-react';
+import { HelpCircle, Server, Settings, RefreshCw, Clock, Package, HardDrive, FolderOpen, Search, Download } from 'lucide-react';
 import { useRegisterModal } from './modal/ModalStackProvider';

 interface HelpModalProps {
@@ -11,7 +11,7 @@ interface HelpModalProps {
  initialSection?: string;
 }

-type HelpSection = 'server-settings' | 'general-settings' | 'sync-button' | 'available-scripts' | 'downloaded-scripts' | 'installed-scripts' | 'lxc-settings' | 'update-system';
+type HelpSection = 'server-settings' | 'general-settings' | 'sync-button' | 'auto-sync' | 'available-scripts' | 'downloaded-scripts' | 'installed-scripts' | 'lxc-settings' | 'update-system';

 export function HelpModal({ isOpen, onClose, initialSection = 'server-settings' }: HelpModalProps) {
  useRegisterModal(isOpen, { id: 'help-modal', allowEscape: true, onClose });
@@ -23,6 +23,7 @@ export function HelpModal({ isOpen, onClose, initialSection = 'server-settings'
    { id: 'server-settings' as HelpSection, label: 'Server Settings', icon: Server },
    { id: 'general-settings' as HelpSection, label: 'General Settings', icon: Settings },
    { id: 'sync-button' as HelpSection, label: 'Sync Button', icon: RefreshCw },
+    { id: 'auto-sync' as HelpSection, label: 'Auto-Sync', icon: Clock },
    { id: 'available-scripts' as HelpSection, label: 'Available Scripts', icon: Package },
    { id: 'downloaded-scripts' as HelpSection, label: 'Downloaded Scripts', icon: HardDrive },
    { id: 'installed-scripts' as HelpSection, label: 'Installed Scripts', icon: FolderOpen },
@@ -185,6 +186,101 @@ export function HelpModal({ isOpen, onClose, initialSection = 'server-settings'
          </div>
        );

+      case 'auto-sync':
+        return (
+          <div className="space-y-6">
+            <div>
+              <h3 className="text-xl font-semibold text-foreground mb-4">Auto-Sync</h3>
+              <p className="text-muted-foreground mb-6">
+                Configure automatic synchronization of scripts with configurable intervals and notifications.
+              </p>
+            </div>
+
+            <div className="space-y-4">
+              <div className="p-4 border border-border rounded-lg">
+                <h4 className="font-medium text-foreground mb-2">What Is Auto-Sync?</h4>
+                <p className="text-sm text-muted-foreground mb-2">
+                  Auto-sync automatically synchronizes script metadata from the ProxmoxVE GitHub repository at specified intervals, 
+                  and optionally downloads/updates scripts and sends notifications.
+                </p>
+                <ul className="text-sm text-muted-foreground space-y-1">
+                  <li>• <strong>Automatic JSON Sync:</strong> Downloads latest script metadata periodically</li>
+                  <li>• <strong>Auto-Download:</strong> Automatically download new scripts when available</li>
+                  <li>• <strong>Auto-Update:</strong> Automatically update existing scripts to newer versions</li>
+                  <li>• <strong>Notifications:</strong> Send notifications when sync completes</li>
+                </ul>
+              </div>
+
+              <div className="p-4 border border-border rounded-lg">
+                <h4 className="font-medium text-foreground mb-2">Sync Intervals</h4>
+                <ul className="text-sm text-muted-foreground space-y-2">
+                  <li>• <strong>Predefined:</strong> Choose from common intervals (15min, 30min, 1hour, 6hours, 12hours, 24hours)</li>
+                  <li>• <strong>Custom Cron:</strong> Use cron expressions for advanced scheduling</li>
+                  <li>• <strong>Examples:</strong>
+                    <ul className="ml-4 mt-1 space-y-1">
+                      <li>• <code>0 */6 * * *</code> - Every 6 hours</li>
+                      <li>• <code>0 0 * * *</code> - Daily at midnight</li>
+                      <li>• <code>0 9 * * 1</code> - Every Monday at 9 AM</li>
+                    </ul>
+                  </li>
+                </ul>
+              </div>
+
+              <div className="p-4 border border-border rounded-lg">
+                <h4 className="font-medium text-foreground mb-2">Auto-Download Options</h4>
+                <ul className="text-sm text-muted-foreground space-y-2">
+                  <li>• <strong>Auto-download new scripts:</strong> Automatically download scripts that haven't been downloaded yet</li>
+                  <li>• <strong>Auto-update existing scripts:</strong> Automatically update scripts that have newer versions available</li>
+                  <li>• <strong>Selective Control:</strong> Enable/disable each option independently</li>
+                </ul>
+              </div>
+
+              <div className="p-4 border border-border rounded-lg">
+                <h4 className="font-medium text-foreground mb-2">Notifications (Apprise)</h4>
+                <p className="text-sm text-muted-foreground mb-2">
+                  Send notifications when sync completes using Apprise, which supports 80+ notification services.
+                  If you want any other notification service, please open an issue on the GitHub repository.
+                </p>
+                <ul className="text-sm text-muted-foreground space-y-2">
+                  <li>• <strong>Apprise Server:</strong> <code>http://YOUR_APPRISE_SERVER/notify/apprise</code></li>
+                </ul>
+                <p className="text-xs text-muted-foreground mt-2">
+                  See the <a href="https://github.com/caronc/apprise" target="_blank" rel="noopener noreferrer" className="text-primary hover:underline">Apprise documentation</a> for more supported services.
+                </p>
+              </div>
+
+              <div className="p-4 border border-border rounded-lg">
+                <h4 className="font-medium text-foreground mb-2">Setup Guide</h4>
+                <ol className="text-sm text-muted-foreground space-y-2 list-decimal list-inside">
+                  <li>Enable auto-sync in the General Settings → Auto-Sync tab</li>
+                  <li>Choose your sync interval (predefined or custom cron)</li>
+                  <li>Configure auto-download options if desired</li>
+                  <li>Set up notifications by adding Apprise URLs</li>
+                  <li>Test your notification setup using the "Test Notification" button</li>
+                  <li>Save your settings to activate auto-sync</li>
+                </ol>
+              </div>
+
+              <div className="p-4 border border-border rounded-lg">
+                <h4 className="font-medium text-foreground mb-2">Cron Expression Help</h4>
+                <p className="text-sm text-muted-foreground mb-2">
+                  Cron expressions have 5 fields: minute hour day month weekday
+                </p>
+                <ul className="text-sm text-muted-foreground space-y-1">
+                  <li>• <strong>Minute:</strong> 0-59 or *</li>
+                  <li>• <strong>Hour:</strong> 0-23 or *</li>
+                  <li>• <strong>Day:</strong> 1-31 or *</li>
+                  <li>• <strong>Month:</strong> 1-12 or *</li>
+                  <li>• <strong>Weekday:</strong> 0-6 (Sunday=0) or *</li>
+                </ul>
+                <p className="text-xs text-muted-foreground mt-2">
+                  Use <a href="https://crontab.guru" target="_blank" rel="noopener noreferrer" className="text-primary hover:underline">crontab.guru</a> to test and learn cron expressions.
+                </p>
+              </div>
+            </div>
+          </div>
+        );
+
      case 'available-scripts':
        return (
          <div className="space-y-6">
--- a/src/app/_components/ScriptsGrid.tsx
+++ b/src/app/_components/ScriptsGrid.tsx
@@ -574,7 +574,7 @@ export function ScriptsGrid({ onInstallScript }: ScriptsGridProps) {
  }, []);


-  const handleCardClick = (scriptCard: { slug: string }) => {
+  const handleCardClick = (scriptCard: ScriptCardType) => {
    // All scripts are GitHub scripts, open modal
    setSelectedSlug(scriptCard.slug);
    setIsModalOpen(true);
--- a/src/app/api/settings/auto-sync/route.ts
+++ b/src/app/api/settings/auto-sync/route.ts
@@ -0,0 +1,396 @@
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+import fs from 'fs';
+import path from 'path';
+import { isValidCron } from 'cron-validator';
+
+export async function POST(request: NextRequest) {
+  try {
+    const settings = await request.json();
+
+    if (!settings || typeof settings !== 'object') {
+      return NextResponse.json(
+        { error: 'Settings object is required' },
+        { status: 400 }
+      );
+    }
+
+    // Handle test notification request
+    if (settings.testNotification) {
+      return await handleTestNotification();
+    }
+    
+    // Handle manual sync trigger
+    if (settings.triggerManualSync) {
+      return await handleManualSync();
+    }
+
+    // Validate required fields for settings save
+    const requiredFields = [
+      'autoSyncEnabled',
+      'syncIntervalType',
+      'autoDownloadNew',
+      'autoUpdateExisting',
+      'notificationEnabled'
+    ];
+    
+    for (const field of requiredFields) {
+      if (!(field in settings)) {
+        return NextResponse.json(
+          { error: `Missing required field: ${field}` },
+          { status: 400 }
+        );
+      }
+    }
+
+    // Validate sync interval type
+    if (!['predefined', 'custom'].includes(settings.syncIntervalType)) {
+      return NextResponse.json(
+        { error: 'syncIntervalType must be "predefined" or "custom"' },
+        { status: 400 }
+      );
+    }
+
+    // Validate predefined interval
+    if (settings.syncIntervalType === 'predefined') {
+      const validIntervals = ['15min', '30min', '1hour', '6hours', '12hours', '24hours'];
+      if (!validIntervals.includes(settings.syncIntervalPredefined)) {
+        return NextResponse.json(
+          { error: 'Invalid predefined interval' },
+          { status: 400 }
+        );
+      }
+    }
+
+    // Validate custom cron expression
+    if (settings.syncIntervalType === 'custom') {
+      if (!settings.syncIntervalCron || typeof settings.syncIntervalCron !== 'string' || settings.syncIntervalCron.trim() === '') {
+        // Fallback to predefined if custom is selected but no cron expression
+        settings.syncIntervalType = 'predefined';
+        settings.syncIntervalPredefined = settings.syncIntervalPredefined || '1hour';
+        settings.syncIntervalCron = '';
+      } else if (!isValidCron(settings.syncIntervalCron, { seconds: false })) {
+        return NextResponse.json(
+          { error: 'Invalid cron expression' },
+          { status: 400 }
+        );
+      }
+    }
+
+    // Validate Apprise URLs if notifications are enabled
+    if (settings.notificationEnabled && settings.appriseUrls) {
+      try {
+        // Handle both array and JSON string formats
+        let urls;
+        if (Array.isArray(settings.appriseUrls)) {
+          urls = settings.appriseUrls;
+        } else if (typeof settings.appriseUrls === 'string') {
+          urls = JSON.parse(settings.appriseUrls);
+        } else {
+          return NextResponse.json(
+            { error: 'Apprise URLs must be an array or JSON string' },
+            { status: 400 }
+          );
+        }
+        
+        if (!Array.isArray(urls)) {
+          return NextResponse.json(
+            { error: 'Apprise URLs must be an array' },
+            { status: 400 }
+          );
+        }
+        
+        // Basic URL validation
+        for (const url of urls) {
+          if (typeof url !== 'string' || url.trim() === '') {
+            return NextResponse.json(
+              { error: 'All Apprise URLs must be non-empty strings' },
+              { status: 400 }
+            );
+          }
+        }
+      } catch (parseError) {
+        return NextResponse.json(
+          { error: 'Invalid JSON format for Apprise URLs' },
+          { status: 400 }
+        );
+      }
+    }
+
+    // Path to the .env file
+    const envPath = path.join(process.cwd(), '.env');
+    
+    // Read existing .env file
+    let envContent = '';
+    if (fs.existsSync(envPath)) {
+      envContent = fs.readFileSync(envPath, 'utf8');
+    }
+
+    // Auto-sync settings to add/update
+    const autoSyncSettings = {
+      'AUTO_SYNC_ENABLED': settings.autoSyncEnabled ? 'true' : 'false',
+      'SYNC_INTERVAL_TYPE': settings.syncIntervalType,
+      'SYNC_INTERVAL_PREDEFINED': settings.syncIntervalPredefined || '',
+      'SYNC_INTERVAL_CRON': settings.syncIntervalCron || '',
+      'AUTO_DOWNLOAD_NEW': settings.autoDownloadNew ? 'true' : 'false',
+      'AUTO_UPDATE_EXISTING': settings.autoUpdateExisting ? 'true' : 'false',
+      'NOTIFICATION_ENABLED': settings.notificationEnabled ? 'true' : 'false',
+      'APPRISE_URLS': Array.isArray(settings.appriseUrls) ? JSON.stringify(settings.appriseUrls) : (settings.appriseUrls || '[]'),
+      'LAST_AUTO_SYNC': settings.lastAutoSync || '',
+      'LAST_AUTO_SYNC_ERROR': settings.lastAutoSyncError || '',
+      'LAST_AUTO_SYNC_ERROR_TIME': settings.lastAutoSyncErrorTime || ''
+    };
+
+    // Update or add each setting
+    for (const [key, value] of Object.entries(autoSyncSettings)) {
+      const regex = new RegExp(`^${key}=.*$`, 'm');
+      const settingLine = `${key}="${value}"`;
+      
+      if (regex.test(envContent)) {
+        // Replace existing setting
+        envContent = envContent.replace(regex, settingLine);
+      } else {
+        // Add new setting
+        envContent += (envContent.endsWith('\n') ? '' : '\n') + `${settingLine}\n`;
+      }
+    }
+
+    // Write back to .env file
+    fs.writeFileSync(envPath, envContent);
+
+    // Reschedule auto-sync service with new settings
+    try {
+      const { getAutoSyncService, setAutoSyncService } = await import('../../../../server/lib/autoSyncInit.js');
+      let autoSyncService = getAutoSyncService();
+      
+      // If no global instance exists, create one
+      if (!autoSyncService) {
+        const { AutoSyncService } = await import('../../../../server/services/autoSyncService.js');
+        autoSyncService = new AutoSyncService();
+        setAutoSyncService(autoSyncService);
+      }
+      
+      // Update the global service instance with new settings
+      autoSyncService.saveSettings(settings);
+      
+      if (settings.autoSyncEnabled) {
+        autoSyncService.scheduleAutoSync();
+      } else {
+        autoSyncService.stopAutoSync();
+        // Ensure the service is completely stopped and won't restart
+        autoSyncService.isRunning = false;
+        // Also stop the global service instance if it exists
+        const { stopAutoSync: stopGlobalAutoSync } = await import('../../../../server/lib/autoSyncInit.js');
+        stopGlobalAutoSync();
+      }
+    } catch (error) {
+      console.error('Error rescheduling auto-sync service:', error);
+      // Don't fail the request if rescheduling fails
+    }
+
+    return NextResponse.json({ 
+      success: true, 
+      message: 'Auto-sync settings saved successfully' 
+    });
+  } catch (error) {
+    console.error('Error saving auto-sync settings:', error);
+    return NextResponse.json(
+      { error: 'Failed to save auto-sync settings' },
+      { status: 500 }
+    );
+  }
+}
+
+export async function GET() {
+  try {
+    // Path to the .env file
+    const envPath = path.join(process.cwd(), '.env');
+    
+    if (!fs.existsSync(envPath)) {
+      return NextResponse.json({ 
+        settings: {
+          autoSyncEnabled: false,
+          syncIntervalType: 'predefined',
+          syncIntervalPredefined: '1hour',
+          syncIntervalCron: '',
+          autoDownloadNew: false,
+          autoUpdateExisting: false,
+          notificationEnabled: false,
+          appriseUrls: [],
+          lastAutoSync: '',
+          lastAutoSyncError: null,
+          lastAutoSyncErrorTime: null
+        }
+      });
+    }
+
+    // Read .env file and extract auto-sync settings
+    const envContent = fs.readFileSync(envPath, 'utf8');
+    
+    const settings = {
+      autoSyncEnabled: getEnvValue(envContent, 'AUTO_SYNC_ENABLED') === 'true',
+      syncIntervalType: getEnvValue(envContent, 'SYNC_INTERVAL_TYPE') || 'predefined',
+      syncIntervalPredefined: getEnvValue(envContent, 'SYNC_INTERVAL_PREDEFINED') || '1hour',
+      syncIntervalCron: getEnvValue(envContent, 'SYNC_INTERVAL_CRON') || '',
+      autoDownloadNew: getEnvValue(envContent, 'AUTO_DOWNLOAD_NEW') === 'true',
+      autoUpdateExisting: getEnvValue(envContent, 'AUTO_UPDATE_EXISTING') === 'true',
+      notificationEnabled: getEnvValue(envContent, 'NOTIFICATION_ENABLED') === 'true',
+      appriseUrls: (() => {
+        try {
+          const urlsValue = getEnvValue(envContent, 'APPRISE_URLS') || '[]';
+          return JSON.parse(urlsValue);
+        } catch {
+          return [];
+        }
+      })(),
+      lastAutoSync: getEnvValue(envContent, 'LAST_AUTO_SYNC') || '',
+      lastAutoSyncError: getEnvValue(envContent, 'LAST_AUTO_SYNC_ERROR') || null,
+      lastAutoSyncErrorTime: getEnvValue(envContent, 'LAST_AUTO_SYNC_ERROR_TIME') || null
+    };
+    
+    return NextResponse.json({ settings });
+  } catch (error) {
+    console.error('Error reading auto-sync settings:', error);
+    return NextResponse.json(
+      { error: 'Failed to read auto-sync settings' },
+      { status: 500 }
+    );
+  }
+}
+
+// Helper function to handle test notification
+async function handleTestNotification() {
+  try {
+    // Load current settings
+    const envPath = path.join(process.cwd(), '.env');
+    
+    if (!fs.existsSync(envPath)) {
+      return NextResponse.json(
+        { error: 'No auto-sync settings found' },
+        { status: 404 }
+      );
+    }
+
+    const envContent = fs.readFileSync(envPath, 'utf8');
+    const notificationEnabled = getEnvValue(envContent, 'NOTIFICATION_ENABLED') === 'true';
+    const appriseUrls = (() => {
+      try {
+        const urlsValue = getEnvValue(envContent, 'APPRISE_URLS') || '[]';
+        return JSON.parse(urlsValue);
+      } catch {
+        return [];
+      }
+    })();
+
+    if (!notificationEnabled) {
+      return NextResponse.json(
+        { error: 'Notifications are not enabled' },
+        { status: 400 }
+      );
+    }
+
+    if (!appriseUrls || appriseUrls.length === 0) {
+      return NextResponse.json(
+        { error: 'No Apprise URLs configured' },
+        { status: 400 }
+      );
+    }
+
+    // Send test notification using the auto-sync service
+    const { AutoSyncService } = await import('../../../../server/services/autoSyncService.js');
+    const autoSyncService = new AutoSyncService();
+    const result = await autoSyncService.testNotification();
+
+    if (result.success) {
+      return NextResponse.json({
+        success: true,
+        message: 'Test notification sent successfully'
+      });
+    } else {
+      return NextResponse.json(
+        { error: result.message },
+        { status: 500 }
+      );
+    }
+  } catch (error) {
+    console.error('Error sending test notification:', error);
+    return NextResponse.json(
+      { error: 'Failed to send test notification' },
+      { status: 500 }
+    );
+  }
+}
+
+// Helper function to handle manual sync trigger
+async function handleManualSync() {
+  try {
+    // Load current settings
+    const envPath = path.join(process.cwd(), '.env');
+    
+    if (!fs.existsSync(envPath)) {
+      return NextResponse.json(
+        { error: 'No auto-sync settings found' },
+        { status: 404 }
+      );
+    }
+
+    const envContent = fs.readFileSync(envPath, 'utf8');
+    const autoSyncEnabled = getEnvValue(envContent, 'AUTO_SYNC_ENABLED') === 'true';
+
+    if (!autoSyncEnabled) {
+      return NextResponse.json(
+        { error: 'Auto-sync is not enabled' },
+        { status: 400 }
+      );
+    }
+
+    // Trigger manual sync using the auto-sync service
+    const { AutoSyncService } = await import('../../../../server/services/autoSyncService.js');
+    const autoSyncService = new AutoSyncService();
+    const result = await autoSyncService.executeAutoSync() as any;
+
+    if (result && result.success) {
+      return NextResponse.json({
+        success: true,
+        message: 'Manual sync completed successfully',
+        result
+      });
+    } else {
+      return NextResponse.json(
+        { error: result.message },
+        { status: 500 }
+      );
+    }
+  } catch (error) {
+    console.error('Error triggering manual sync:', error);
+    return NextResponse.json(
+      { error: 'Failed to trigger manual sync' },
+      { status: 500 }
+    );
+  }
+}
+
+// Helper function to extract value from .env content
+function getEnvValue(envContent: string, key: string): string {
+  // Try to match the pattern with quotes around the value (handles nested quotes)
+  const regex = new RegExp(`^${key}="(.+)"$`, 'm');
+  let match = regex.exec(envContent);
+  
+  if (match && match[1]) {
+    let value = match[1];
+    // Remove extra quotes that might be around JSON values
+    if (value.startsWith('"') && value.endsWith('"')) {
+      value = value.slice(1, -1);
+    }
+    return value;
+  }
+  
+  // Try to match without quotes (fallback)
+  const regexNoQuotes = new RegExp(`^${key}=([^\\s]*)$`, 'm');
+  match = regexNoQuotes.exec(envContent);
+  if (match && match[1]) {
+    return match[1];
+  }
+  
+  return '';
+}
--- a/src/server/api/routers/scripts.ts
+++ b/src/server/api/routers/scripts.ts
@@ -4,6 +4,7 @@ import { scriptManager } from "~/server/lib/scripts";
 import { githubJsonService } from "~/server/services/githubJsonService";
 import { localScriptsService } from "~/server/services/localScripts";
 import { scriptDownloaderService } from "~/server/services/scriptDownloader";
+import { AutoSyncService } from "~/server/services/autoSyncService";
 import type { ScriptCard } from "~/types/script";

 export const scriptsRouter = createTRPCRouter({
@@ -114,6 +115,18 @@ export const scriptsRouter = createTRPCRouter({
    .input(z.object({ slug: z.string() }))
    .query(async ({ input }) => {
      try {
+        console.log('getScriptBySlug called with slug:', input.slug);
+        console.log('githubJsonService methods:', Object.getOwnPropertyNames(Object.getPrototypeOf(githubJsonService)));
+        console.log('githubJsonService.getScriptBySlug type:', typeof githubJsonService.getScriptBySlug);
+        
+        if (typeof githubJsonService.getScriptBySlug !== 'function') {
+          return {
+            success: false,
+            error: 'getScriptBySlug method is not available on githubJsonService',
+            script: null
+          };
+        }
+        
        const script = await githubJsonService.getScriptBySlug(input.slug);
        if (!script) {
          return {
@@ -124,6 +137,7 @@ export const scriptsRouter = createTRPCRouter({
        }
        return { success: true, script };
      } catch (error) {
+        console.error('Error in getScriptBySlug:', error);
        return {
          success: false,
          error: error instanceof Error ? error.message : 'Failed to fetch script',
@@ -457,5 +471,121 @@ export const scriptsRouter = createTRPCRouter({
          message: 'Failed to check Proxmox VE status'
        };
      }
+    }),
+
+  // Auto-sync settings and operations
+  getAutoSyncSettings: publicProcedure
+    .query(async () => {
+      try {
+        const autoSyncService = new AutoSyncService();
+        const settings = autoSyncService.loadSettings();
+        return { success: true, settings };
+      } catch (error) {
+        console.error('Error getting auto-sync settings:', error);
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : 'Failed to get auto-sync settings',
+          settings: null
+        };
+      }
+    }),
+
+  saveAutoSyncSettings: publicProcedure
+    .input(z.object({
+      autoSyncEnabled: z.boolean(),
+      syncIntervalType: z.enum(['predefined', 'custom']),
+      syncIntervalPredefined: z.string().optional(),
+      syncIntervalCron: z.string().optional(),
+      autoDownloadNew: z.boolean(),
+      autoUpdateExisting: z.boolean(),
+      notificationEnabled: z.boolean(),
+      appriseUrls: z.array(z.string()).optional()
+    }))
+    .mutation(async ({ input }) => {
+      try {
+        // Use the global auto-sync service instance
+        const { getAutoSyncService, setAutoSyncService } = await import('~/server/lib/autoSyncInit');
+        let autoSyncService = getAutoSyncService();
+        
+        // If no global instance exists, create one
+        if (!autoSyncService) {
+          const { AutoSyncService } = await import('~/server/services/autoSyncService');
+          autoSyncService = new AutoSyncService();
+          setAutoSyncService(autoSyncService);
+        }
+        
+        // Save settings to both .env file and service instance
+        autoSyncService.saveSettings(input);
+        
+        // Reschedule auto-sync if enabled
+        if (input.autoSyncEnabled) {
+          autoSyncService.scheduleAutoSync();
+          console.log('Auto-sync rescheduled with new settings');
+        } else {
+          autoSyncService.stopAutoSync();
+          // Ensure the service is completely stopped and won't restart
+          autoSyncService.isRunning = false;
+          console.log('Auto-sync stopped');
+        }
+        
+        return { success: true, message: 'Auto-sync settings saved successfully' };
+      } catch (error) {
+        console.error('Error saving auto-sync settings:', error);
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : 'Failed to save auto-sync settings'
+        };
+      }
+    }),
+
+  testNotification: publicProcedure
+    .mutation(async () => {
+      try {
+        const autoSyncService = new AutoSyncService();
+        const result = await autoSyncService.testNotification();
+        return result;
+      } catch (error) {
+        console.error('Error testing notification:', error);
+        return {
+          success: false,
+          message: error instanceof Error ? error.message : 'Failed to test notification'
+        };
+      }
+    }),
+
+  triggerManualAutoSync: publicProcedure
+    .mutation(async () => {
+      try {
+        const autoSyncService = new AutoSyncService();
+        const result = await autoSyncService.executeAutoSync();
+        return {
+          success: true,
+          message: 'Manual auto-sync completed successfully',
+          result
+        };
+      } catch (error) {
+        console.error('Error in manual auto-sync:', error);
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : 'Failed to execute manual auto-sync',
+          result: null
+        };
+      }
+    }),
+
+  getAutoSyncStatus: publicProcedure
+    .query(async () => {
+      try {
+        const autoSyncService = new AutoSyncService();
+        const status = autoSyncService.getStatus();
+        return { success: true, status };
+      } catch (error) {
+        console.error('Error getting auto-sync status:', error);
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : 'Failed to get auto-sync status',
+          status: null
+        };
+      }
    })
 });
--- a/src/server/lib/autoSyncInit.js
+++ b/src/server/lib/autoSyncInit.js
@@ -0,0 +1,84 @@
+import { AutoSyncService } from '../services/autoSyncService.js';
+
+let autoSyncService = null;
+let isInitialized = false;
+
+/**
+ * Initialize auto-sync service and schedule cron job if enabled
+ */
+export function initializeAutoSync() {
+  if (isInitialized) {
+    console.log('Auto-sync service already initialized, skipping...');
+    return;
+  }
+  
+  try {
+    console.log('Initializing auto-sync service...');
+    autoSyncService = new AutoSyncService();
+    isInitialized = true;
+    console.log('AutoSyncService instance created');
+    
+    // Load settings and schedule if enabled
+    const settings = autoSyncService.loadSettings();
+    console.log('Settings loaded:', settings);
+    
+    if (settings.autoSyncEnabled) {
+      console.log('Auto-sync is enabled, scheduling cron job...');
+      autoSyncService.scheduleAutoSync();
+      console.log('Cron job scheduled');
+    } else {
+      console.log('Auto-sync is disabled');
+    }
+    
+    console.log('Auto-sync service initialized successfully');
+  } catch (error) {
+    console.error('Failed to initialize auto-sync service:', error);
+    console.error('Error stack:', error.stack);
+  }
+}
+
+/**
+ * Stop auto-sync service and clean up cron jobs
+ */
+export function stopAutoSync() {
+  try {
+    if (autoSyncService) {
+      console.log('Stopping auto-sync service...');
+      autoSyncService.stopAutoSync();
+      autoSyncService = null;
+      isInitialized = false;
+      console.log('Auto-sync service stopped');
+    }
+  } catch (error) {
+    console.error('Error stopping auto-sync service:', error);
+  }
+}
+
+/**
+ * Get the auto-sync service instance
+ */
+export function getAutoSyncService() {
+  return autoSyncService;
+}
+
+/**
+ * Set the auto-sync service instance (for external management)
+ */
+export function setAutoSyncService(service) {
+  autoSyncService = service;
+}
+
+/**
+ * Graceful shutdown handler
+ */
+export function setupGracefulShutdown() {
+  const shutdown = (signal) => {
+    console.log(`Received ${signal}, shutting down gracefully...`);
+    stopAutoSync();
+    process.exit(0);
+  };
+
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGUSR2', () => shutdown('SIGUSR2')); // For nodemon
+}
--- a/src/server/lib/autoSyncInit.ts
+++ b/src/server/lib/autoSyncInit.ts
@@ -0,0 +1,72 @@
+import { AutoSyncService } from '~/server/services/autoSyncService';
+
+let autoSyncService: AutoSyncService | null = null;
+
+/**
+ * Initialize auto-sync service and schedule cron job if enabled
+ */
+export function initializeAutoSync(): void {
+  try {
+    console.log('Initializing auto-sync service...');
+    autoSyncService = new AutoSyncService();
+    
+    // Load settings and schedule if enabled
+    const settings = autoSyncService.loadSettings();
+    
+    if (settings.autoSyncEnabled) {
+      console.log('Auto-sync is enabled, scheduling cron job...');
+      autoSyncService.scheduleAutoSync();
+    } else {
+      console.log('Auto-sync is disabled');
+    }
+    
+    console.log('Auto-sync service initialized successfully');
+  } catch (error) {
+    console.error('Failed to initialize auto-sync service:', error);
+  }
+}
+
+/**
+ * Stop auto-sync service and clean up cron jobs
+ */
+export function stopAutoSync(): void {
+  try {
+    if (autoSyncService) {
+      console.log('Stopping auto-sync service...');
+      autoSyncService.stopAutoSync();
+      autoSyncService = null;
+      console.log('Auto-sync service stopped');
+    }
+  } catch (error) {
+    console.error('Error stopping auto-sync service:', error);
+  }
+}
+
+/**
+ * Get the auto-sync service instance
+ */
+export function getAutoSyncService(): AutoSyncService | null {
+  return autoSyncService;
+}
+
+/**
+ * Set the auto-sync service instance (for external management)
+ */
+export function setAutoSyncService(service: AutoSyncService | null): void {
+  autoSyncService = service;
+}
+
+/**
+ * Graceful shutdown handler
+ */
+export function setupGracefulShutdown(): void {
+  const shutdown = (signal: string) => {
+    console.log(`Received ${signal}, shutting down gracefully...`);
+    stopAutoSync();
+    process.exit(0);
+  };
+
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGUSR2', () => shutdown('SIGUSR2')); // For nodemon
+}
--- a/src/server/lib/scripts.ts
+++ b/src/server/lib/scripts.ts
@@ -25,6 +25,25 @@ export class ScriptManager {
    // Initialize lazily to avoid accessing env vars during module load
  }

+  /**
+   * Safely handle file modification time, providing fallback for invalid dates
+   * @param mtime - The file modification time from fs.stat
+   * @returns Date - Valid date or current date as fallback
+   */
+  private safeMtime(mtime: Date): Date {
+    try {
+      // Check if the date is valid
+      if (!mtime || isNaN(mtime.getTime())) {
+        console.warn('Invalid mtime detected, using current time as fallback');
+        return new Date();
+      }
+      return mtime;
+    } catch (error) {
+      console.warn('Error processing mtime:', error);
+      return new Date();
+    }
+  }
+
  private initializeConfig() {
    if (this.scriptsDir === null) {
      // Handle both absolute and relative paths for testing
@@ -63,7 +82,7 @@ export class ScriptManager {
              path: filePath,
              extension,
              size: stats.size,
-              lastModified: stats.mtime,
+              lastModified: this.safeMtime(stats.mtime),
              executable
            });
          }
@@ -125,7 +144,7 @@ export class ScriptManager {
              path: filePath,
              extension,
              size: stats.size,
-              lastModified: stats.mtime,
+              lastModified: this.safeMtime(stats.mtime),
              executable,
              logo,
              slug
@@ -212,7 +231,7 @@ export class ScriptManager {
              path: filePath,
              extension,
              size: stats.size,
-              lastModified: stats.mtime,
+              lastModified: this.safeMtime(stats.mtime),
              executable,
              logo,
              slug
--- a/src/server/services/appriseService.js
+++ b/src/server/services/appriseService.js
@@ -0,0 +1,123 @@
+import axios from 'axios';
+
+export class AppriseService {
+  constructor() {
+    this.baseUrl = 'http://localhost:8080'; // Default Apprise API URL
+  }
+
+  /**
+   * Send notification via Apprise
+   * @param {string} title - Notification title
+   * @param {string} body - Notification body
+   * @param {string[]} urls - Array of Apprise URLs
+   */
+  async sendNotification(title, body, urls) {
+    if (!urls || urls.length === 0) {
+      throw new Error('No Apprise URLs provided');
+    }
+
+    try {
+      // Format the notification as form data (Apprise API expects form data)
+      const formData = new URLSearchParams();
+      formData.append('body', body || '');
+      formData.append('title', title || 'PVE Scripts Local');
+      formData.append('tags', 'all');
+
+      // Send to each URL
+      const results = [];
+      for (const url of urls) {
+        try {
+          const response = await axios.post(url, formData, {
+            headers: {
+              'Content-Type': 'application/x-www-form-urlencoded'
+            },
+            timeout: 10000 // 10 second timeout
+          });
+          
+          results.push({
+            url,
+            success: true,
+            status: response.status
+          });
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          console.error(`Failed to send notification to ${url}:`, errorMessage);
+          results.push({
+            url,
+            success: false,
+            error: errorMessage
+          });
+        }
+      }
+
+      // Check if any notifications succeeded
+      const successCount = results.filter(r => r.success).length;
+      if (successCount === 0) {
+        throw new Error('All notification attempts failed');
+      }
+
+      return {
+        success: true,
+        message: `Notification sent to ${successCount}/${urls.length} services`,
+        results
+      };
+
+    } catch (error) {
+      console.error('Apprise notification failed:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Test notification to a single URL
+   * @param {string} url - Apprise URL to test
+   */
+  async testUrl(url) {
+    try {
+      await this.sendNotification('Test', 'This is a test notification', [url]);
+      return { success: true, message: 'Test notification sent successfully' };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return { success: false, message: errorMessage };
+    }
+  }
+
+  /**
+   * Validate Apprise URL format
+   * @param {string} url - URL to validate
+   */
+  validateUrl(url) {
+    if (!url || typeof url !== 'string') {
+      return { valid: false, error: 'URL is required' };
+    }
+
+    // Basic URL validation
+    try {
+      new URL(url);
+    } catch {
+      return { valid: false, error: 'Invalid URL format' };
+    }
+
+    // Check for common Apprise URL patterns
+    const apprisePatterns = [
+      /^discord:\/\//,
+      /^tgram:\/\//,
+      /^mailto:\/\//,
+      /^slack:\/\//,
+      /^https?:\/\//
+    ];
+
+    const isValidAppriseUrl = apprisePatterns.some(pattern => pattern.test(url));
+    
+    if (!isValidAppriseUrl) {
+      return { 
+        valid: false, 
+        error: 'URL does not match known Apprise service patterns' 
+      };
+    }
+
+    return { valid: true };
+  }
+}
+
+export const appriseService = new AppriseService();
--- a/src/server/services/autoSyncService.js
+++ b/src/server/services/autoSyncService.js
@@ -0,0 +1,758 @@
+import cron from 'node-cron';
+import { githubJsonService } from './githubJsonService.js';
+import { scriptDownloaderService } from './scriptDownloader.js';
+import { appriseService } from './appriseService.js';
+import { readFile, writeFile, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import cronValidator from 'cron-validator';
+
+// Global lock to prevent multiple autosync instances from running simultaneously
+let globalAutoSyncLock = false;
+
+export class AutoSyncService {
+  constructor() {
+    this.cronJob = null;
+    this.isRunning = false;
+  }
+
+  /**
+   * Safely convert a date to ISO string, handling invalid dates
+   * @param {Date} date - The date to convert
+   * @returns {string} - ISO string or fallback timestamp
+   */
+  safeToISOString(date) {
+    try {
+      // Check if the date is valid
+      if (!date || isNaN(date.getTime())) {
+        console.warn('Invalid date provided to safeToISOString, using current time as fallback');
+        return new Date().toISOString();
+      }
+      return date.toISOString();
+    } catch (error) {
+      console.warn('Error converting date to ISO string:', error instanceof Error ? error.message : String(error));
+      return new Date().toISOString();
+    }
+  }
+
+  /**
+   * Load auto-sync settings from .env file
+   */
+  loadSettings() {
+    try {
+      const envPath = join(process.cwd(), '.env');
+      const envContent = readFileSync(envPath, 'utf8');
+      
+      /** @type {{
+       *   autoSyncEnabled: boolean;
+       *   syncIntervalType: string;
+       *   syncIntervalPredefined?: string;
+       *   syncIntervalCron?: string;
+       *   autoDownloadNew: boolean;
+       *   autoUpdateExisting: boolean;
+       *   notificationEnabled: boolean;
+       *   appriseUrls?: string[];
+       *   lastAutoSync?: string;
+       *   lastAutoSyncError?: string;
+       *   lastAutoSyncErrorTime?: string;
+       * }} */
+      const settings = {
+        autoSyncEnabled: false,
+        syncIntervalType: 'predefined',
+        syncIntervalPredefined: '1hour',
+        syncIntervalCron: '',
+        autoDownloadNew: false,
+        autoUpdateExisting: false,
+        notificationEnabled: false,
+        appriseUrls: [],
+        lastAutoSync: '',
+        lastAutoSyncError: '',
+        lastAutoSyncErrorTime: ''
+      };
+      const lines = envContent.split('\n');
+      
+      for (const line of lines) {
+        const [key, ...valueParts] = line.split('=');
+        if (key && valueParts.length > 0) {
+          let value = valueParts.join('=').trim();
+          // Remove surrounding quotes if present
+          if (value.startsWith('"') && value.endsWith('"')) {
+            value = value.slice(1, -1);
+          }
+          
+          switch (key.trim()) {
+            case 'AUTO_SYNC_ENABLED':
+              settings.autoSyncEnabled = value === 'true';
+              break;
+            case 'SYNC_INTERVAL_TYPE':
+              settings.syncIntervalType = value;
+              break;
+            case 'SYNC_INTERVAL_PREDEFINED':
+              settings.syncIntervalPredefined = value;
+              break;
+            case 'SYNC_INTERVAL_CRON':
+              settings.syncIntervalCron = value;
+              break;
+            case 'AUTO_DOWNLOAD_NEW':
+              settings.autoDownloadNew = value === 'true';
+              break;
+            case 'AUTO_UPDATE_EXISTING':
+              settings.autoUpdateExisting = value === 'true';
+              break;
+            case 'NOTIFICATION_ENABLED':
+              settings.notificationEnabled = value === 'true';
+              break;
+            case 'APPRISE_URLS':
+              try {
+                settings.appriseUrls = JSON.parse(value || '[]');
+              } catch {
+                settings.appriseUrls = [];
+              }
+              break;
+            case 'LAST_AUTO_SYNC':
+              settings.lastAutoSync = value;
+              break;
+            case 'LAST_AUTO_SYNC_ERROR':
+              settings.lastAutoSyncError = value;
+              break;
+            case 'LAST_AUTO_SYNC_ERROR_TIME':
+              settings.lastAutoSyncErrorTime = value;
+              break;
+          }
+        }
+      }
+      
+      return settings;
+    } catch (error) {
+      console.error('Error loading auto-sync settings:', error);
+      return {
+        autoSyncEnabled: false,
+        syncIntervalType: 'predefined',
+        syncIntervalPredefined: '1hour',
+        syncIntervalCron: '',
+        autoDownloadNew: false,
+        autoUpdateExisting: false,
+        notificationEnabled: false,
+        appriseUrls: [],
+        lastAutoSync: '',
+        lastAutoSyncError: '',
+        lastAutoSyncErrorTime: ''
+      };
+    }
+  }
+
+  /**
+   * Save auto-sync settings to .env file
+   * @param {Object} settings - Settings object
+   * @param {boolean} settings.autoSyncEnabled
+   * @param {string} settings.syncIntervalType
+   * @param {string} [settings.syncIntervalPredefined]
+   * @param {string} [settings.syncIntervalCron]
+   * @param {boolean} settings.autoDownloadNew
+   * @param {boolean} settings.autoUpdateExisting
+   * @param {boolean} settings.notificationEnabled
+   * @param {Array<string>} [settings.appriseUrls]
+   * @param {string} [settings.lastAutoSync]
+   * @param {string} [settings.lastAutoSyncError]
+   * @param {string} [settings.lastAutoSyncErrorTime]
+   */
+  saveSettings(settings) {
+    try {
+      const envPath = join(process.cwd(), '.env');
+      let envContent = '';
+      
+      try {
+        envContent = readFileSync(envPath, 'utf8');
+      } catch {
+        // .env file doesn't exist, create it
+      }
+      
+      const lines = envContent.split('\n');
+      const newLines = [];
+      const settingsMap = {
+        'AUTO_SYNC_ENABLED': settings.autoSyncEnabled.toString(),
+        'SYNC_INTERVAL_TYPE': settings.syncIntervalType,
+        'SYNC_INTERVAL_PREDEFINED': settings.syncIntervalPredefined || '',
+        'SYNC_INTERVAL_CRON': settings.syncIntervalCron || '',
+        'AUTO_DOWNLOAD_NEW': settings.autoDownloadNew.toString(),
+        'AUTO_UPDATE_EXISTING': settings.autoUpdateExisting.toString(),
+        'NOTIFICATION_ENABLED': settings.notificationEnabled.toString(),
+        'APPRISE_URLS': JSON.stringify(settings.appriseUrls || []),
+        'LAST_AUTO_SYNC': settings.lastAutoSync || '',
+        'LAST_AUTO_SYNC_ERROR': settings.lastAutoSyncError || '',
+        'LAST_AUTO_SYNC_ERROR_TIME': settings.lastAutoSyncErrorTime || ''
+      };
+      
+      const existingKeys = new Set();
+      
+      for (const line of lines) {
+        const trimmedLine = line.trim();
+        
+        // Skip empty lines and comments
+        if (!trimmedLine || trimmedLine.startsWith('#')) {
+          newLines.push(line);
+          continue;
+        }
+        
+        const equalIndex = trimmedLine.indexOf('=');
+        if (equalIndex === -1) {
+          // Line doesn't contain '=', keep as is
+          newLines.push(line);
+          continue;
+        }
+        
+        const key = trimmedLine.substring(0, equalIndex).trim();
+        if (key && key in settingsMap) {
+          // Replace existing setting
+          // @ts-ignore - Dynamic property access is safe here
+          newLines.push(`${key}=${settingsMap[key]}`);
+          existingKeys.add(key);
+        } else {
+          // Keep other settings as is
+          newLines.push(line);
+        }
+      }
+      
+      // Add any missing settings
+      for (const [key, value] of Object.entries(settingsMap)) {
+        if (!existingKeys.has(key)) {
+          newLines.push(`${key}=${value}`);
+        }
+      }
+      
+      writeFileSync(envPath, newLines.join('\n'));
+      console.log('Auto-sync settings saved successfully');
+    } catch (error) {
+      console.error('Error saving auto-sync settings:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Schedule auto-sync cron job
+   */
+  scheduleAutoSync() {
+    this.stopAutoSync(); // Stop any existing job
+    
+    const settings = this.loadSettings();
+    if (!settings.autoSyncEnabled) {
+      console.log('Auto-sync is disabled, not scheduling cron job');
+      this.isRunning = false; // Ensure we're completely stopped
+      return;
+    }
+    
+    // Check if there's already a global autosync running
+    if (globalAutoSyncLock) {
+      console.log('Auto-sync is already running globally, not scheduling new cron job');
+      return;
+    }
+    
+    let cronExpression;
+    
+    if (settings.syncIntervalType === 'custom') {
+      cronExpression = settings.syncIntervalCron;
+    } else {
+      // Convert predefined intervals to cron expressions
+      const intervalMap = {
+        '15min': '*/15 * * * *',
+        '30min': '*/30 * * * *',
+        '1hour': '0 * * * *',
+        '6hours': '0 */6 * * *',
+        '12hours': '0 */12 * * *',
+        '24hours': '0 0 * * *'
+      };
+      // @ts-ignore - Dynamic key access is safe here
+      cronExpression = intervalMap[settings.syncIntervalPredefined] || '0 * * * *';
+    }
+    
+    // Validate cron expression (5-field format for node-cron)
+    if (!cronValidator.isValidCron(cronExpression, { seconds: false })) {
+      console.error('Invalid cron expression:', cronExpression);
+      return;
+    }
+    
+    console.log(`Scheduling auto-sync with cron expression: ${cronExpression}`);
+    
+    this.cronJob = cron.schedule(cronExpression, async () => {
+      // Check global lock first
+      if (globalAutoSyncLock) {
+        console.log('Auto-sync already running globally, skipping cron execution...');
+        return;
+      }
+      
+      if (this.isRunning) {
+        console.log('Auto-sync already running locally, skipping...');
+        return;
+      }
+      
+      // Double-check that autosync is still enabled before executing
+      const currentSettings = this.loadSettings();
+      if (!currentSettings.autoSyncEnabled) {
+        console.log('Auto-sync has been disabled, stopping and destroying cron job');
+        this.stopAutoSync();
+        return;
+      }
+      
+      // Additional check: if cronJob is null, it means it was stopped
+      if (!this.cronJob) {
+        console.log('Cron job was stopped, skipping execution');
+        return;
+      }
+      
+      console.log('Starting scheduled auto-sync...');
+      await this.executeAutoSync();
+    }, {
+      scheduled: true,
+      timezone: 'UTC'
+    });
+    
+    console.log('Auto-sync cron job scheduled successfully');
+  }
+
+  /**
+   * Stop auto-sync cron job
+   */
+  stopAutoSync() {
+    if (this.cronJob) {
+      this.cronJob.stop();
+      this.cronJob.destroy();
+      this.cronJob = null;
+      this.isRunning = false;
+      console.log('Auto-sync cron job stopped and destroyed');
+    } else {
+      console.log('No active cron job to stop');
+      this.isRunning = false; // Ensure isRunning is false even if no cron job
+    }
+  }
+
+  /**
+   * Execute auto-sync process
+   */
+  async executeAutoSync() {
+    // Check global lock first
+    if (globalAutoSyncLock) {
+      console.log('Auto-sync already running globally, skipping...');
+      return { success: false, message: 'Auto-sync already running globally' };
+    }
+    
+    if (this.isRunning) {
+      console.log('Auto-sync already running locally, skipping...');
+      return { success: false, message: 'Auto-sync already running locally' };
+    }
+    
+    // Set global lock
+    globalAutoSyncLock = true;
+    this.isRunning = true;
+    const startTime = new Date();
+    
+    try {
+      console.log('Starting auto-sync execution...');
+      
+      // Step 1: Sync JSON files
+      console.log('Syncing JSON files...');
+      const syncResult = await githubJsonService.syncJsonFiles();
+      
+      if (!syncResult.success) {
+        throw new Error(`JSON sync failed: ${syncResult.message}`);
+      }
+      
+      const results = {
+        jsonSync: syncResult,
+        newScripts: /** @type {any[]} */ ([]),
+        updatedScripts: /** @type {any[]} */ ([]),
+        errors: /** @type {string[]} */ ([])
+      };
+      
+      // Step 2: Auto-download/update scripts if enabled
+      const settings = this.loadSettings();
+      
+      if (settings.autoDownloadNew || settings.autoUpdateExisting) {
+        console.log('Processing synced JSON files for script downloads...');
+        
+        // Only process scripts for files that were actually synced
+        if (syncResult.syncedFiles && syncResult.syncedFiles.length > 0) {
+          console.log(`Processing ${syncResult.syncedFiles.length} synced JSON files for script downloads...`);
+          
+          // Get scripts only for the synced files
+          const localScriptsService = await import('./localScripts.js');
+          const syncedScripts = [];
+          
+          for (const filename of syncResult.syncedFiles) {
+            try {
+              // Extract slug from filename (remove .json extension)
+              const slug = filename.replace('.json', '');
+              const script = await localScriptsService.localScriptsService.getScriptBySlug(slug);
+              if (script) {
+                syncedScripts.push(script);
+              }
+            } catch (error) {
+              console.warn(`Error loading script from ${filename}:`, error);
+            }
+          }
+          
+          console.log(`Found ${syncedScripts.length} scripts from synced JSON files`);
+          
+          // Filter to only truly NEW scripts (not previously downloaded)
+          const newScripts = [];
+          const existingScripts = [];
+          
+          for (const script of syncedScripts) {
+            try {
+              // Validate script object
+              if (!script || !script.slug) {
+                console.warn('Invalid script object found, skipping:', script);
+                continue;
+              }
+              
+              const isDownloaded = await scriptDownloaderService.isScriptDownloaded(script);
+              if (!isDownloaded) {
+                newScripts.push(script);
+              } else {
+                existingScripts.push(script);
+              }
+            } catch (error) {
+              console.warn(`Error checking script ${script?.slug || 'unknown'}:`, error);
+              // Treat as new script if we can't check
+              if (script && script.slug) {
+                newScripts.push(script);
+              }
+            }
+          }
+          
+          console.log(`Found ${newScripts.length} new scripts and ${existingScripts.length} existing scripts from synced files`);
+          
+          // Download new scripts
+          if (settings.autoDownloadNew && newScripts.length > 0) {
+            console.log(`Auto-downloading ${newScripts.length} new scripts...`);
+            const downloaded = [];
+            const errors = [];
+            
+            for (const script of newScripts) {
+              try {
+                const result = await scriptDownloaderService.loadScript(script);
+                if (result.success) {
+                  downloaded.push(script); // Store full script object for category grouping
+                  console.log(`Downloaded script: ${script.name || script.slug}`);
+                } else {
+                  errors.push(`${script.name || script.slug}: ${result.message}`);
+                }
+              } catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                errors.push(`${script.name || script.slug}: ${errorMsg}`);
+                console.error(`Failed to download script ${script.slug}:`, error);
+              }
+            }
+            
+            results.newScripts = downloaded;
+            results.errors.push(...errors);
+          }
+          
+          // Update existing scripts
+          if (settings.autoUpdateExisting && existingScripts.length > 0) {
+            console.log(`Auto-updating ${existingScripts.length} existing scripts...`);
+            const updated = [];
+            const errors = [];
+            
+            for (const script of existingScripts) {
+              try {
+                // Always update existing scripts when auto-update is enabled
+                const result = await scriptDownloaderService.loadScript(script);
+                if (result.success) {
+                  updated.push(script); // Store full script object for category grouping
+                  console.log(`Updated script: ${script.name || script.slug}`);
+                } else {
+                  errors.push(`${script.name || script.slug}: ${result.message}`);
+                }
+              } catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                errors.push(`${script.name || script.slug}: ${errorMsg}`);
+                console.error(`Failed to update script ${script.slug}:`, error);
+              }
+            }
+            
+            results.updatedScripts = updated;
+            results.errors.push(...errors);
+          }
+        } else {
+          console.log('No JSON files were synced, skipping script download/update');
+        }
+      } else {
+        console.log('Auto-download/update disabled, skipping script processing');
+      }
+      
+      // Step 3: Send notifications if enabled
+      if (settings.notificationEnabled && settings.appriseUrls && settings.appriseUrls.length > 0) {
+        console.log('Sending success notifications...');
+        await this.sendSyncNotification(results);
+        console.log('Success notifications sent');
+      }
+      
+      // Step 4: Update last sync time and clear any previous errors
+      const lastSyncTime = this.safeToISOString(new Date());
+      const updatedSettings = { 
+        ...settings, 
+        lastAutoSync: lastSyncTime,
+        lastAutoSyncError: '' // Clear any previous errors on successful sync
+      };
+      this.saveSettings(updatedSettings);
+      
+      const duration = new Date().getTime() - startTime.getTime();
+      console.log(`Auto-sync completed successfully in ${duration}ms`);
+      
+      return {
+        success: true,
+        message: 'Auto-sync completed successfully',
+        results,
+        duration
+      };
+      
+    } catch (error) {
+      console.error('Auto-sync execution failed:', error);
+      
+      // Check if it's a rate limit error
+      const isRateLimitError = error instanceof Error && error.name === 'RateLimitError';
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      
+      // Send error notification if enabled
+      const settings = this.loadSettings();
+      if (settings.notificationEnabled && settings.appriseUrls && settings.appriseUrls.length > 0) {
+        try {
+          const notificationTitle = isRateLimitError ? 'Auto-Sync Rate Limited' : 'Auto-Sync Failed';
+          const notificationMessage = isRateLimitError 
+            ? `GitHub API rate limit exceeded. Please set a GITHUB_TOKEN in your .env file for higher rate limits. Error: ${errorMessage}`
+            : `Auto-sync failed with error: ${errorMessage}`;
+            
+          await appriseService.sendNotification(
+            notificationTitle,
+            notificationMessage,
+            settings.appriseUrls || []
+          );
+        } catch (notifError) {
+          console.error('Failed to send error notification:', notifError);
+        }
+      }
+      
+      // Store the error in settings for UI display
+      const errorSettings = this.loadSettings();
+      const errorToStore = isRateLimitError 
+        ? `GitHub API rate limit exceeded. Please set a GITHUB_TOKEN in your .env file for higher rate limits.`
+        : errorMessage;
+      
+      const updatedErrorSettings = { 
+        ...errorSettings, 
+        lastAutoSyncError: errorToStore,
+        lastAutoSyncErrorTime: this.safeToISOString(new Date())
+      };
+      this.saveSettings(updatedErrorSettings);
+      
+      return {
+        success: false,
+        message: errorToStore,
+        error: errorMessage,
+        isRateLimitError
+      };
+    } finally {
+      this.isRunning = false;
+      globalAutoSyncLock = false; // Release global lock
+    }
+  }
+
+  /**
+   * Load categories from metadata.json
+   */
+  loadCategories() {
+    try {
+      const metadataPath = join(process.cwd(), 'scripts', 'json', 'metadata.json');
+      const metadataContent = readFileSync(metadataPath, 'utf8');
+      const metadata = JSON.parse(metadataContent);
+      return metadata.categories || [];
+    } catch (error) {
+      console.error('Error loading categories:', error);
+      return [];
+    }
+  }
+
+  /**
+   * Group scripts by category
+   * @param {Array<any>} scripts - Array of script objects
+   * @param {Array<any>} categories - Array of category objects
+   */
+  groupScriptsByCategory(scripts, categories) {
+    const categoryMap = new Map();
+    categories.forEach(cat => categoryMap.set(cat.id, cat.name));
+    
+    const grouped = new Map();
+    
+    scripts.forEach(script => {
+      // Validate script object
+      if (!script || !script.name) {
+        console.warn('Invalid script object in groupScriptsByCategory, skipping:', script);
+        return;
+      }
+      
+      const scriptCategories = script.categories || [0]; // Default to Miscellaneous (id: 0)
+      scriptCategories.forEach((/** @type {number} */ catId) => {
+        const categoryName = categoryMap.get(catId) || 'Miscellaneous';
+        if (!grouped.has(categoryName)) {
+          grouped.set(categoryName, []);
+        }
+        grouped.get(categoryName).push(script.name);
+      });
+    });
+    
+    return grouped;
+  }
+
+  /**
+   * Send notification about sync results
+   * @param {Object} results - Sync results object
+   */
+  async sendSyncNotification(results) {
+    const settings = this.loadSettings();
+    
+    if (!settings.notificationEnabled || !settings.appriseUrls?.length) {
+      return;
+    }
+    
+    const title = 'ProxmoxVE-Local - Auto-Sync Completed';
+    let body = `Auto-sync completed successfully.\n\n`;
+    
+    // Add JSON sync info
+    // @ts-ignore - Dynamic property access
+    if (results.jsonSync) {
+      // @ts-ignore - Dynamic property access
+      const syncedCount = results.jsonSync.count || 0;
+      // @ts-ignore - Dynamic property access
+      const syncedFiles = results.jsonSync.syncedFiles || [];
+      
+      // Calculate up-to-date count (total files - synced files)
+      // We can't easily get total file count from the sync result, so just show synced count
+      if (syncedCount > 0) {
+        body += `JSON Files: ${syncedCount} synced\n`;
+      } else {
+        body += `JSON Files: All up-to-date\n`;
+      }
+      
+      // @ts-ignore - Dynamic property access
+      if (results.jsonSync.errors?.length > 0) {
+        // @ts-ignore - Dynamic property access
+        body += `JSON Errors: ${results.jsonSync.errors.length}\n`;
+      }
+      body += '\n';
+    }
+    
+    // Load categories for grouping
+    const categories = this.loadCategories();
+    
+    // @ts-ignore - Dynamic property access
+    if (results.newScripts?.length > 0) {
+      // @ts-ignore - Dynamic property access
+      body += `New scripts downloaded: ${results.newScripts.length}\n`;
+      
+      // Group new scripts by category
+      // @ts-ignore - Dynamic property access
+      const newScriptsGrouped = this.groupScriptsByCategory(results.newScripts, categories);
+      
+      // Sort categories by name for consistent ordering
+      const sortedCategories = Array.from(newScriptsGrouped.keys()).sort();
+      
+      sortedCategories.forEach(categoryName => {
+        const scripts = newScriptsGrouped.get(categoryName);
+        body += `\n**${categoryName}:**\n`;
+        scripts.forEach((/** @type {string} */ scriptName) => {
+          body += `• ${scriptName}\n`;
+        });
+      });
+      body += '\n';
+    }
+    
+    // @ts-ignore - Dynamic property access
+    if (results.updatedScripts?.length > 0) {
+      // @ts-ignore - Dynamic property access
+      body += `Scripts updated: ${results.updatedScripts.length}\n`;
+      
+      // Group updated scripts by category
+      // @ts-ignore - Dynamic property access
+      const updatedScriptsGrouped = this.groupScriptsByCategory(results.updatedScripts, categories);
+      
+      // Sort categories by name for consistent ordering
+      const sortedCategories = Array.from(updatedScriptsGrouped.keys()).sort();
+      
+      sortedCategories.forEach(categoryName => {
+        const scripts = updatedScriptsGrouped.get(categoryName);
+        body += `\n**${categoryName}:**\n`;
+        scripts.forEach((/** @type {string} */ scriptName) => {
+          body += `• ${scriptName}\n`;
+        });
+      });
+      body += '\n';
+    }
+    
+    // @ts-ignore - Dynamic property access
+    if (results.errors?.length > 0) {
+      // @ts-ignore - Dynamic property access
+      body += `Script errors encountered: ${results.errors.length}\n`;
+      // @ts-ignore - Dynamic property access
+      body += `• ${results.errors.slice(0, 5).join('\n• ')}\n`;
+      // @ts-ignore - Dynamic property access
+      if (results.errors.length > 5) {
+        // @ts-ignore - Dynamic property access
+        body += `• ... and ${results.errors.length - 5} more errors\n`;
+      }
+    }
+    
+    // @ts-ignore - Dynamic property access
+    if (results.newScripts?.length === 0 && results.updatedScripts?.length === 0 && results.errors?.length === 0) {
+      body += 'No script changes detected.';
+    }
+    
+    try {
+      await appriseService.sendNotification(title, body, settings.appriseUrls);
+      console.log('Sync notification sent successfully');
+    } catch (error) {
+      console.error('Failed to send sync notification:', error);
+    }
+  }
+
+  /**
+   * Test notification
+   */
+  async testNotification() {
+    const settings = this.loadSettings();
+    
+    if (!settings.notificationEnabled || !settings.appriseUrls?.length) {
+      return {
+        success: false,
+        message: 'Notifications not enabled or no Apprise URLs configured'
+      };
+    }
+    
+    try {
+      await appriseService.sendNotification(
+        'ProxmoxVE-Local - Test Notification',
+        'This is a test notification from PVE Scripts Local auto-sync feature.',
+        settings.appriseUrls
+      );
+      
+      return {
+        success: true,
+        message: 'Test notification sent successfully'
+      };
+    } catch (error) {
+      return {
+        success: false,
+        message: `Failed to send test notification: ${error instanceof Error ? error.message : String(error)}`
+      };
+    }
+  }
+
+  /**
+   * Get auto-sync status
+   */
+  getStatus() {
+    return {
+      isRunning: this.isRunning,
+      hasCronJob: !!this.cronJob,
+      lastSync: this.loadSettings().lastAutoSync
+    };
+  }
+}
--- a/src/server/services/github.ts
+++ b/src/server/services/github.ts
@@ -29,14 +29,24 @@ export class GitHubService {
  }

  private async fetchFromGitHub<T>(endpoint: string): Promise<T> {
-    const response = await fetch(`${this.baseUrl}${endpoint}`, {
-      headers: {
-        'Accept': 'application/vnd.github.v3+json',
-        'User-Agent': 'PVEScripts-Local/1.0',
-      },
-    });
+    const headers: HeadersInit = {
+      'Accept': 'application/vnd.github.v3+json',
+      'User-Agent': 'PVEScripts-Local/1.0',
+    };
+    
+    // Add GitHub token authentication if available
+    if (env.GITHUB_TOKEN) {
+      headers.Authorization = `token ${env.GITHUB_TOKEN}`;
+    }
+    
+    const response = await fetch(`${this.baseUrl}${endpoint}`, { headers });

    if (!response.ok) {
+      if (response.status === 403) {
+        const error = new Error(`GitHub API rate limit exceeded. Consider setting GITHUB_TOKEN for higher limits. Status: ${response.status} ${response.statusText}`);
+        error.name = 'RateLimitError';
+        throw error;
+      }
      throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
    }

--- a/src/server/services/githubJsonService.js
+++ b/src/server/services/githubJsonService.js
@@ -0,0 +1,6 @@
+// JavaScript wrapper for githubJsonService.ts
+// This allows the JavaScript autoSyncService.js to import the TypeScript service
+
+import { githubJsonService } from './githubJsonService.ts';
+
+export { githubJsonService };
--- a/src/server/services/githubJsonService.ts
+++ b/src/server/services/githubJsonService.ts
@@ -1,7 +1,7 @@
-import { writeFile, mkdir } from 'fs/promises';
+import { writeFile, mkdir, readdir } from 'fs/promises';
 import { join } from 'path';
-import { env } from '~/env.js';
-import type { Script, ScriptCard, GitHubFile } from '~/types/script';
+import { env } from '../../env.js';
+import type { Script, ScriptCard, GitHubFile } from '../../types/script';

 export class GitHubJsonService {
  private baseUrl: string | null = null;
@@ -41,14 +41,25 @@ export class GitHubJsonService {

  private async fetchFromGitHub<T>(endpoint: string): Promise<T> {
    this.initializeConfig();
-    const response = await fetch(`${this.baseUrl!}${endpoint}`, {
-      headers: {
-        'Accept': 'application/vnd.github.v3+json',
-        'User-Agent': 'PVEScripts-Local/1.0',
-      },
-    });
+    
+    const headers: HeadersInit = {
+      'Accept': 'application/vnd.github.v3+json',
+      'User-Agent': 'PVEScripts-Local/1.0',
+    };
+    
+    // Add GitHub token authentication if available
+    if (env.GITHUB_TOKEN) {
+      headers.Authorization = `token ${env.GITHUB_TOKEN}`;
+    }
+    
+    const response = await fetch(`${this.baseUrl!}${endpoint}`, { headers });

    if (!response.ok) {
+      if (response.status === 403) {
+        const error = new Error(`GitHub API rate limit exceeded. Consider setting GITHUB_TOKEN for higher limits. Status: ${response.status} ${response.statusText}`);
+        error.name = 'RateLimitError';
+        throw error;
+      }
      throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
    }

@@ -59,8 +70,22 @@ export class GitHubJsonService {
    this.initializeConfig();
    const rawUrl = `https://raw.githubusercontent.com/${this.extractRepoPath()}/${this.branch!}/${filePath}`;
    
-    const response = await fetch(rawUrl);
+    const headers: HeadersInit = {
+      'User-Agent': 'PVEScripts-Local/1.0',
+    };
+    
+    // Add GitHub token authentication if available (for raw files, use token in URL or header)
+    if (env.GITHUB_TOKEN) {
+      headers.Authorization = `token ${env.GITHUB_TOKEN}`;
+    }
+    
+    const response = await fetch(rawUrl, { headers });
    if (!response.ok) {
+      if (response.status === 403) {
+        const error = new Error(`GitHub rate limit exceeded while downloading ${filePath}. Consider setting GITHUB_TOKEN for higher limits. Status: ${response.status} ${response.statusText}`);
+        error.name = 'RateLimitError';
+        throw error;
+      }
      throw new Error(`Failed to download ${filePath}: ${response.status} ${response.statusText}`);
    }

@@ -185,48 +210,90 @@ export class GitHubJsonService {
    }
  }

-  async syncJsonFiles(): Promise<{ success: boolean; message: string; count: number }> {
+  async syncJsonFiles(): Promise<{ success: boolean; message: string; count: number; syncedFiles: string[] }> {
    try {
-      // Get all scripts from GitHub (1 API call + raw downloads)
-      const scripts = await this.getAllScripts();
+      console.log('Starting fast incremental JSON sync...');
      
-      // Save scripts to local directory
-      await this.saveScriptsLocally(scripts);
+      // Get file list from GitHub
+      console.log('Fetching file list from GitHub...');
+      const githubFiles = await this.getJsonFiles();
+      console.log(`Found ${githubFiles.length} JSON files in repository`);
+      
+      // Get local files
+      const localFiles = await this.getLocalJsonFiles();
+      console.log(`Found ${localFiles.length} files in local directory`);
+      console.log(`Found ${localFiles.filter(f => f.endsWith('.json')).length} local JSON files`);
+      
+      // Compare and find files that need syncing
+      const filesToSync = this.findFilesToSync(githubFiles, localFiles);
+      console.log(`Found ${filesToSync.length} files that need syncing`);
+      
+      if (filesToSync.length === 0) {
+        return {
+          success: true,
+          message: 'All JSON files are up to date',
+          count: 0,
+          syncedFiles: []
+        };
+      }
+      
+      // Download and save only the files that need syncing
+      const syncedFiles = await this.syncSpecificFiles(filesToSync);
      
      return {
        success: true,
-        message: `Successfully synced ${scripts.length} scripts from GitHub using 1 API call + raw downloads`,
-        count: scripts.length
+        message: `Successfully synced ${syncedFiles.length} JSON files from GitHub`,
+        count: syncedFiles.length,
+        syncedFiles
      };
    } catch (error) {
-      console.error('Error syncing JSON files:', error);
+      console.error('JSON sync failed:', error);
      return {
        success: false,
        message: `Failed to sync JSON files: ${error instanceof Error ? error.message : 'Unknown error'}`,
-        count: 0
+        count: 0,
+        syncedFiles: []
      };
    }
  }

-  private async saveScriptsLocally(scripts: Script[]): Promise<void> {
+  private async getLocalJsonFiles(): Promise<string[]> {
    this.initializeConfig();
    try {
-      // Ensure the directory exists
-      await mkdir(this.localJsonDirectory!, { recursive: true });
-
-      // Save each script as a JSON file
-      for (const script of scripts) {
-        const filename = `${script.slug}.json`;
-        const filePath = join(this.localJsonDirectory!, filename);
-        const content = JSON.stringify(script, null, 2);
-        await writeFile(filePath, content, 'utf-8');
-      }
-
-    } catch (error) {
-      console.error('Error saving scripts locally:', error);
-      throw new Error('Failed to save scripts locally');
+      const files = await readdir(this.localJsonDirectory!);
+      return files.filter(f => f.endsWith('.json'));
+    } catch {
+      return [];
    }
  }
+
+  private findFilesToSync(githubFiles: GitHubFile[], localFiles: string[]): GitHubFile[] {
+    const localFileSet = new Set(localFiles);
+    // Return only files that don't exist locally
+    return githubFiles.filter(ghFile => !localFileSet.has(ghFile.name));
+  }
+
+  private async syncSpecificFiles(filesToSync: GitHubFile[]): Promise<string[]> {
+    this.initializeConfig();
+    const syncedFiles: string[] = [];
+    
+    await mkdir(this.localJsonDirectory!, { recursive: true });
+    
+    for (const file of filesToSync) {
+      try {
+        const script = await this.downloadJsonFile(file.path);
+        const filename = `${script.slug}.json`;
+        const filePath = join(this.localJsonDirectory!, filename);
+        await writeFile(filePath, JSON.stringify(script, null, 2), 'utf-8');
+        syncedFiles.push(filename);
+      } catch (error) {
+        console.error(`Failed to sync ${file.name}:`, error);
+      }
+    }
+    
+    return syncedFiles;
+  }
+
 }

 // Singleton instance
--- a/src/server/services/localScripts.js
+++ b/src/server/services/localScripts.js
@@ -0,0 +1,6 @@
+// JavaScript wrapper for localScripts.ts
+// This allows the JavaScript autoSyncService.js to import the TypeScript service
+
+import { localScriptsService } from './localScripts.ts';
+
+export { localScriptsService };
--- a/src/server/services/scriptDownloader.js
+++ b/src/server/services/scriptDownloader.js
@@ -0,0 +1,297 @@
+// Real JavaScript implementation for script downloading
+import { join } from 'path';
+import { writeFile, mkdir, access } from 'fs/promises';
+
+export class ScriptDownloaderService {
+  constructor() {
+    this.scriptsDirectory = null;
+    this.repoUrl = null;
+  }
+
+  initializeConfig() {
+    if (this.scriptsDirectory === null) {
+      this.scriptsDirectory = join(process.cwd(), 'scripts');
+      // Get REPO_URL from environment or use default
+      this.repoUrl = process.env.REPO_URL || 'https://github.com/community-scripts/ProxmoxVE';
+    }
+  }
+
+  async ensureDirectoryExists(dirPath) {
+    try {
+      await mkdir(dirPath, { recursive: true });
+    } catch (error) {
+      if (error.code !== 'EEXIST') {
+        throw error;
+      }
+    }
+  }
+
+  async downloadFileFromGitHub(filePath) {
+    this.initializeConfig();
+    if (!this.repoUrl) {
+      throw new Error('REPO_URL environment variable is not set');
+    }
+
+    // Extract repo path from URL
+    const match = /github\.com\/([^\/]+)\/([^\/]+)/.exec(this.repoUrl);
+    if (!match) {
+      throw new Error('Invalid GitHub repository URL');
+    }
+    const [, owner, repo] = match;
+    
+    const url = `https://raw.githubusercontent.com/${owner}/${repo}/main/${filePath}`;
+    
+    console.log(`Downloading from GitHub: ${url}`);
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to download ${filePath}: ${response.status} ${response.statusText}`);
+    }
+
+    return response.text();
+  }
+
+  modifyScriptContent(content) {
+    // Replace the build.func source line
+    const oldPattern = /source <\(curl -fsSL https:\/\/raw\.githubusercontent\.com\/community-scripts\/ProxmoxVE\/main\/misc\/build\.func\)/g;
+    const newPattern = 'SCRIPT_DIR="$(dirname "$0")" \nsource "$SCRIPT_DIR/../core/build.func"';
+    
+    return content.replace(oldPattern, newPattern);
+  }
+
+  async loadScript(script) {
+    this.initializeConfig();
+    try {
+      const files = [];
+      
+      // Ensure directories exist
+      await this.ensureDirectoryExists(join(this.scriptsDirectory, 'ct'));
+      await this.ensureDirectoryExists(join(this.scriptsDirectory, 'install'));
+      await this.ensureDirectoryExists(join(this.scriptsDirectory, 'tools'));
+      await this.ensureDirectoryExists(join(this.scriptsDirectory, 'vm'));
+
+      if (script.install_methods?.length) {
+        for (const method of script.install_methods) {
+          if (method.script) {
+            const scriptPath = method.script;
+            const fileName = scriptPath.split('/').pop();
+            
+            if (fileName) {
+              // Download from GitHub
+              console.log(`Downloading script file: ${scriptPath}`);
+              const content = await this.downloadFileFromGitHub(scriptPath);
+              
+              // Determine target directory based on script path
+              let targetDir;
+              let finalTargetDir;
+              let filePath;
+              
+              if (scriptPath.startsWith('ct/')) {
+                targetDir = 'ct';
+                finalTargetDir = targetDir;
+                // Modify the content for CT scripts
+                const modifiedContent = this.modifyScriptContent(content);
+                filePath = join(this.scriptsDirectory, targetDir, fileName);
+                await writeFile(filePath, modifiedContent, 'utf-8');
+              } else if (scriptPath.startsWith('tools/')) {
+                targetDir = 'tools';
+                // Preserve subdirectory structure for tools scripts
+                const subPath = scriptPath.replace('tools/', '');
+                const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+                finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+                // Ensure the subdirectory exists
+                await this.ensureDirectoryExists(join(this.scriptsDirectory, finalTargetDir));
+                filePath = join(this.scriptsDirectory, finalTargetDir, fileName);
+                await writeFile(filePath, content, 'utf-8');
+              } else if (scriptPath.startsWith('vm/')) {
+                targetDir = 'vm';
+                // Preserve subdirectory structure for VM scripts
+                const subPath = scriptPath.replace('vm/', '');
+                const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+                finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+                // Ensure the subdirectory exists
+                await this.ensureDirectoryExists(join(this.scriptsDirectory, finalTargetDir));
+                filePath = join(this.scriptsDirectory, finalTargetDir, fileName);
+                await writeFile(filePath, content, 'utf-8');
+              } else if (scriptPath.startsWith('vw/')) {
+                targetDir = 'vw';
+                // Preserve subdirectory structure for VW scripts
+                const subPath = scriptPath.replace('vw/', '');
+                const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+                finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+                // Ensure the subdirectory exists
+                await this.ensureDirectoryExists(join(this.scriptsDirectory, finalTargetDir));
+                filePath = join(this.scriptsDirectory, finalTargetDir, fileName);
+                await writeFile(filePath, content, 'utf-8');
+              } else {
+                // Handle other script types (fallback to ct directory)
+                targetDir = 'ct';
+                finalTargetDir = targetDir;
+                const modifiedContent = this.modifyScriptContent(content);
+                filePath = join(this.scriptsDirectory, targetDir, fileName);
+                await writeFile(filePath, modifiedContent, 'utf-8');
+              }
+              
+              files.push(`${finalTargetDir}/${fileName}`);
+              console.log(`Successfully downloaded: ${finalTargetDir}/${fileName}`);
+            }
+          }
+        }
+      }
+
+      // Only download install script for CT scripts
+      const hasCtScript = script.install_methods?.some(method => method.script?.startsWith('ct/'));
+      if (hasCtScript) {
+        const installScriptName = `${script.slug}-install.sh`;
+        try {
+          console.log(`Downloading install script: install/${installScriptName}`);
+          const installContent = await this.downloadFileFromGitHub(`install/${installScriptName}`);
+          const localInstallPath = join(this.scriptsDirectory, 'install', installScriptName);
+          await writeFile(localInstallPath, installContent, 'utf-8');
+          files.push(`install/${installScriptName}`);
+          console.log(`Successfully downloaded: install/${installScriptName}`);
+        } catch (error) {
+          // Install script might not exist, that's okay
+          console.log(`Install script not found: install/${installScriptName}`);
+        }
+      }
+
+      return {
+        success: true,
+        message: `Successfully loaded ${files.length} script(s) for ${script.name}`,
+        files
+      };
+    } catch (error) {
+      console.error('Error loading script:', error);
+      return {
+        success: false,
+        message: error instanceof Error ? error.message : 'Failed to load script',
+        files: []
+      };
+    }
+  }
+
+  async isScriptDownloaded(script) {
+    if (!script.install_methods?.length) return false;
+
+    // Check if ALL script files are downloaded
+    for (const method of script.install_methods) {
+      if (method.script) {
+        const scriptPath = method.script;
+        const fileName = scriptPath.split('/').pop();
+        
+        if (fileName) {
+          // Determine target directory based on script path
+          let targetDir;
+          let finalTargetDir;
+          let filePath;
+          
+          if (scriptPath.startsWith('ct/')) {
+            targetDir = 'ct';
+            finalTargetDir = targetDir;
+            filePath = join(this.scriptsDirectory, targetDir, fileName);
+          } else if (scriptPath.startsWith('tools/')) {
+            targetDir = 'tools';
+            const subPath = scriptPath.replace('tools/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory, finalTargetDir, fileName);
+          } else if (scriptPath.startsWith('vm/')) {
+            targetDir = 'vm';
+            const subPath = scriptPath.replace('vm/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory, finalTargetDir, fileName);
+          } else if (scriptPath.startsWith('vw/')) {
+            targetDir = 'vw';
+            const subPath = scriptPath.replace('vw/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory, finalTargetDir, fileName);
+          } else {
+            targetDir = 'ct';
+            finalTargetDir = targetDir;
+            filePath = join(this.scriptsDirectory, targetDir, fileName);
+          }
+          
+          try {
+            await import('fs/promises').then(fs => fs.readFile(filePath, 'utf8'));
+            // File exists, continue checking other methods
+          } catch {
+            // File doesn't exist, script is not fully downloaded
+            return false;
+          }
+        }
+      }
+    }
+
+    // All files exist, script is downloaded
+    return true;
+  }
+
+  async checkScriptExists(script) {
+    this.initializeConfig();
+    const files = [];
+    let ctExists = false;
+    let installExists = false;
+
+    try {
+      // Check scripts based on their install methods
+      if (script.install_methods?.length) {
+        for (const method of script.install_methods) {
+          if (method.script) {
+            const scriptPath = method.script;
+            const fileName = scriptPath.split('/').pop();
+            
+            if (fileName) {
+              let targetDir;
+              if (scriptPath.startsWith('ct/')) {
+                targetDir = 'ct';
+              } else if (scriptPath.startsWith('tools/')) {
+                targetDir = 'tools';
+              } else if (scriptPath.startsWith('vm/')) {
+                targetDir = 'vm';
+              } else {
+                targetDir = 'ct'; // Default fallback
+              }
+              
+              const filePath = join(this.scriptsDirectory, targetDir, fileName);
+              
+              try {
+                await access(filePath);
+                files.push(`${targetDir}/${fileName}`);
+                
+                if (scriptPath.startsWith('ct/')) {
+                  ctExists = true;
+                }
+              } catch {
+                // File doesn't exist
+              }
+            }
+          }
+        }
+      }
+
+      // Check for install script for CT scripts
+      const hasCtScript = script.install_methods?.some(method => method.script?.startsWith('ct/'));
+      if (hasCtScript) {
+        const installScriptName = `${script.slug}-install.sh`;
+        const installPath = join(this.scriptsDirectory, 'install', installScriptName);
+        
+        try {
+          await access(installPath);
+          files.push(`install/${installScriptName}`);
+          installExists = true;
+        } catch {
+          // Install script doesn't exist
+        }
+      }
+
+      return { ctExists, installExists, files };
+    } catch (error) {
+      console.error('Error checking script existence:', error);
+      return { ctExists: false, installExists: false, files: [] };
+    }
+  }
+}
+
+export const scriptDownloaderService = new ScriptDownloaderService();
--- a/src/server/services/scriptDownloader.ts
+++ b/src/server/services/scriptDownloader.ts
@@ -167,6 +167,203 @@ export class ScriptDownloaderService {
    }
  }

+  /**
+   * Auto-download new scripts that haven't been downloaded yet
+   */
+  async autoDownloadNewScripts(allScripts: Script[]): Promise<{ downloaded: string[]; errors: string[] }> {
+    this.initializeConfig();
+    const downloaded: string[] = [];
+    const errors: string[] = [];
+
+    for (const script of allScripts) {
+      try {
+        // Check if script is already downloaded
+        const isDownloaded = await this.isScriptDownloaded(script);
+        
+        if (!isDownloaded) {
+          const result = await this.loadScript(script);
+          if (result.success) {
+            downloaded.push(script.name || script.slug);
+            console.log(`Auto-downloaded new script: ${script.name || script.slug}`);
+          } else {
+            errors.push(`${script.name || script.slug}: ${result.message}`);
+          }
+        }
+      } catch (error) {
+        const errorMsg = `${script.name || script.slug}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+        errors.push(errorMsg);
+        console.error(`Failed to auto-download script ${script.slug}:`, error);
+      }
+    }
+
+    return { downloaded, errors };
+  }
+
+  /**
+   * Auto-update existing scripts to newer versions
+   */
+  async autoUpdateExistingScripts(allScripts: Script[]): Promise<{ updated: string[]; errors: string[] }> {
+    this.initializeConfig();
+    const updated: string[] = [];
+    const errors: string[] = [];
+
+    for (const script of allScripts) {
+      try {
+        // Check if script is downloaded
+        const isDownloaded = await this.isScriptDownloaded(script);
+        
+        if (isDownloaded) {
+          // Check if update is needed by comparing content
+          const needsUpdate = await this.scriptNeedsUpdate(script);
+          
+          if (needsUpdate) {
+            const result = await this.loadScript(script);
+            if (result.success) {
+              updated.push(script.name || script.slug);
+              console.log(`Auto-updated script: ${script.name || script.slug}`);
+            } else {
+              errors.push(`${script.name || script.slug}: ${result.message}`);
+            }
+          }
+        }
+      } catch (error) {
+        const errorMsg = `${script.name || script.slug}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+        errors.push(errorMsg);
+        console.error(`Failed to auto-update script ${script.slug}:`, error);
+      }
+    }
+
+    return { updated, errors };
+  }
+
+  /**
+   * Check if a script is already downloaded
+   */
+  async isScriptDownloaded(script: Script): Promise<boolean> {
+    if (!script.install_methods?.length) return false;
+
+    // Check if ALL script files are downloaded
+    for (const method of script.install_methods) {
+      if (method.script) {
+        const scriptPath = method.script;
+        const fileName = scriptPath.split('/').pop();
+        
+        if (fileName) {
+          // Determine target directory based on script path
+          let targetDir: string;
+          let finalTargetDir: string;
+          let filePath: string;
+          
+          if (scriptPath.startsWith('ct/')) {
+            targetDir = 'ct';
+            finalTargetDir = targetDir;
+            filePath = join(this.scriptsDirectory!, targetDir, fileName);
+          } else if (scriptPath.startsWith('tools/')) {
+            targetDir = 'tools';
+            const subPath = scriptPath.replace('tools/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory!, finalTargetDir, fileName);
+          } else if (scriptPath.startsWith('vm/')) {
+            targetDir = 'vm';
+            const subPath = scriptPath.replace('vm/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory!, finalTargetDir, fileName);
+          } else if (scriptPath.startsWith('vw/')) {
+            targetDir = 'vw';
+            const subPath = scriptPath.replace('vw/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory!, finalTargetDir, fileName);
+          } else {
+            targetDir = 'ct';
+            finalTargetDir = targetDir;
+            filePath = join(this.scriptsDirectory!, targetDir, fileName);
+          }
+          
+          try {
+            await readFile(filePath, 'utf8');
+            // File exists, continue checking other methods
+          } catch {
+            // File doesn't exist, script is not fully downloaded
+            return false;
+          }
+        }
+      }
+    }
+
+    // All files exist, script is downloaded
+    return true;
+  }
+
+  /**
+   * Check if a script needs updating by comparing local and remote content
+   */
+  private async scriptNeedsUpdate(script: Script): Promise<boolean> {
+    if (!script.install_methods?.length) return false;
+
+    for (const method of script.install_methods) {
+      if (method.script) {
+        const scriptPath = method.script;
+        const fileName = scriptPath.split('/').pop();
+        
+        if (fileName) {
+          // Determine target directory based on script path
+          let targetDir: string;
+          let finalTargetDir: string;
+          let filePath: string;
+          
+          if (scriptPath.startsWith('ct/')) {
+            targetDir = 'ct';
+            finalTargetDir = targetDir;
+            filePath = join(this.scriptsDirectory!, targetDir, fileName);
+          } else if (scriptPath.startsWith('tools/')) {
+            targetDir = 'tools';
+            const subPath = scriptPath.replace('tools/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory!, finalTargetDir, fileName);
+          } else if (scriptPath.startsWith('vm/')) {
+            targetDir = 'vm';
+            const subPath = scriptPath.replace('vm/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory!, finalTargetDir, fileName);
+          } else if (scriptPath.startsWith('vw/')) {
+            targetDir = 'vw';
+            const subPath = scriptPath.replace('vw/', '');
+            const subDir = subPath.includes('/') ? subPath.substring(0, subPath.lastIndexOf('/')) : '';
+            finalTargetDir = subDir ? join(targetDir, subDir) : targetDir;
+            filePath = join(this.scriptsDirectory!, finalTargetDir, fileName);
+          } else {
+            targetDir = 'ct';
+            finalTargetDir = targetDir;
+            filePath = join(this.scriptsDirectory!, targetDir, fileName);
+          }
+          
+          try {
+            // Read local content
+            const localContent = await readFile(filePath, 'utf8');
+            
+            // Download remote content
+            const remoteContent = await this.downloadFileFromGitHub(scriptPath);
+            
+            // Compare content (simple string comparison for now)
+            // In a more sophisticated implementation, you might want to compare
+            // file modification times or use content hashing
+            return localContent !== remoteContent;
+          } catch {
+            // If we can't read local or download remote, assume update needed
+            return true;
+          }
+        }
+      }
+    }
+
+    return false;
+  }
+
  async checkScriptExists(script: Script): Promise<{ ctExists: boolean; installExists: boolean; files: string[] }> {
    this.initializeConfig();
    const files: string[] = [];
--- a/update.sh
+++ b/update.sh
@@ -1,5 +1,6 @@
 #!/bin/bash

+#21.10.2025 - @michelroegl-brunner
 # Enhanced update script for ProxmoxVE-Local
 # Fetches latest release from GitHub and backs up data directory

@@ -298,6 +299,7 @@ clear_original_directory() {
    # List of files/directories to preserve (already backed up)
    local preserve_patterns=(
        "data"
+        "data/*"
        ".env"
        "*.log"
        "update.log"
@@ -354,7 +356,7 @@ restore_backup_files() {
            if [ -f ".env" ]; then
                rm -f ".env"
            fi
-            if mv "$BACKUP_DIR/.env" ".env"; then
+            if cp "$BACKUP_DIR/.env" ".env"; then
                log_success ".env file restored from backup"
            else
                log_error "Failed to restore .env file"
@@ -369,7 +371,7 @@ restore_backup_files() {
            if [ -d "data" ]; then
                rm -rf "data"
            fi
-            if mv "$BACKUP_DIR/data" "data"; then
+            if cp -r "$BACKUP_DIR/data" "data"; then
                log_success "Data directory restored from backup"
            else
                log_error "Failed to restore data directory"
@@ -396,7 +398,7 @@ restore_backup_files() {
                    rm -rf "$target_dir"
                fi
                
-                if mv "$BACKUP_DIR/$backup_name" "$target_dir"; then
+                if cp -r "$BACKUP_DIR/$backup_name" "$target_dir"; then
                    log_success "$target_dir directory restored from backup"
                else
                    log_error "Failed to restore $target_dir directory"
@@ -412,6 +414,30 @@ restore_backup_files() {
    fi
 }

+# Verify database was restored correctly
+verify_database_restored() {
+    log "Verifying database was restored correctly..."
+    
+    # Check for both possible database filenames
+    local db_file=""
+    if [ -f "data/database.sqlite" ]; then
+        db_file="data/database.sqlite"
+    elif [ -f "data/settings.db" ]; then
+        db_file="data/settings.db"
+    else
+        log_error "Database file not found after restore! (checked database.sqlite and settings.db)"
+        return 1
+    fi
+    
+    local db_size=$(stat -f%z "$db_file" 2>/dev/null || stat -c%s "$db_file" 2>/dev/null)
+    if [ "$db_size" -eq 0 ]; then
+        log_warning "Database file is empty - will be recreated by Prisma migrations"
+        return 0  # Don't fail the update, let Prisma recreate the database
+    fi
+    
+    log_success "Database verified (file: $db_file, size: $db_size bytes)"
+}
+
 # Ensure DATABASE_URL is set in .env file for Prisma
 ensure_database_url() {
    log "Ensuring DATABASE_URL is set in .env file..."
@@ -437,7 +463,7 @@ ensure_database_url() {
    log "Adding DATABASE_URL to .env file..."
    echo "" >> .env
    echo "# Database" >> .env
-    echo "DATABASE_URL=\"file:./data/database.sqlite\"" >> .env
+    echo "DATABASE_URL=\"file:./data/settings.db\"" >> .env
    
    log_success "DATABASE_URL added to .env file"
 }
@@ -465,15 +491,15 @@ stop_application() {
    if [ -f "package.json" ] && [ -f "server.js" ]; then
        app_dir="$(pwd)"
    else
-        # Try to find the application directory
-        app_dir=$(find /root -name "package.json" -path "*/ProxmoxVE-Local*" -exec dirname {} \; 2>/dev/null | head -1)
-        if [ -n "$app_dir" ] && [ -d "$app_dir" ]; then
+        # Change to production application directory
+        app_dir="/opt/ProxmoxVE-Local"
+        if [ -d "$app_dir" ] && [ -f "$app_dir/server.js" ]; then
            cd "$app_dir" || {
                log_error "Failed to change to application directory: $app_dir"
                return 1
            }
        else
-            log_error "Could not find application directory"
+            log_error "Production application directory not found: $app_dir"
            return 1
        fi
    fi
@@ -555,7 +581,7 @@ update_files() {
        local should_exclude=false
        
        for pattern in "${exclude_patterns[@]}"; do
-            if [[ "$rel_path" == $pattern ]]; then
+            if [[ "$rel_path" == $pattern ]] || [[ "$rel_path" == $pattern/* ]]; then
                should_exclude=true
                break
            fi
@@ -595,6 +621,7 @@ update_files() {
    log_success "Application files updated successfully ($files_copied files)"
 }

+
 # Install dependencies and build
 install_and_build() {
    log "Installing dependencies..."
@@ -650,6 +677,15 @@ install_and_build() {
    fi
    log_success "Prisma client generated successfully"
    
+    # Check if Prisma migrations exist and are compatible
+    if [ -d "prisma/migrations" ]; then
+        log "Existing migration history detected"
+        local migration_count=$(find prisma/migrations -type d -mindepth 1 | wc -l)
+        log "Found $migration_count existing migrations"
+    else
+        log_warning "No existing migration history found - this may be a fresh install"
+    fi
+    
    # Run Prisma migrations
    log "Running Prisma migrations..."
    if ! npx prisma migrate deploy > "$npm_log" 2>&1; then
@@ -706,11 +742,16 @@ start_application() {
            fi
        else
            log_error "Failed to enable/start service, falling back to npm start"
-            start_with_npm
+            if ! start_with_npm; then
+                log_error "Failed to start application with npm"
+                return 1
+            fi
        fi
    else
        log "Service was not running before update or no service exists, starting with npm..."
-        start_with_npm
+        if ! start_with_npm; then
+            return 1
+        fi
    fi
 }

@@ -834,23 +875,15 @@ main() {
    if [ -f "package.json" ] && [ -f "server.js" ]; then
        app_dir="$(pwd)"
    else
-        # Try multiple common locations:
-        for search_path in /opt /root /home /usr/local; do
-            if [ -d "$search_path" ]; then
-                app_dir=$(find "$search_path" -name "package.json" -path "*/ProxmoxVE-Local*" -exec dirname {} \; 2>/dev/null | head -1)
-                if [ -n "$app_dir" ] && [ -d "$app_dir" ]; then
-                    break
-                fi
-            fi
-        done
-        
-        if [ -n "$app_dir" ] && [ -d "$app_dir" ]; then
+        # Use production application directory
+        app_dir="/opt/ProxmoxVE-Local"
+        if [ -d "$app_dir" ] && [ -f "$app_dir/server.js" ]; then
            cd "$app_dir" || {
                log_error "Failed to change to application directory: $app_dir"
                exit 1
            }
        else
-            log_error "Could not find application directory"
+            log_error "Production application directory not found: $app_dir"
            exit 1
        fi
    fi
@@ -894,6 +927,12 @@ main() {
    # Restore .env and data directory before building
    restore_backup_files
    
+    # Verify database was restored correctly
+    if ! verify_database_restored; then
+        log_error "Database verification failed, rolling back..."
+        rollback
+    fi
+    
    # Ensure DATABASE_URL is set for Prisma
    ensure_database_url
    
@@ -903,12 +942,17 @@ main() {
        rollback
    fi
    
-    # Cleanup
+    # Start the application
+    if ! start_application; then
+        log_error "Failed to start application after update"
+        rollback
+    fi
+    
+    # Cleanup only after successful start
    rm -rf "$source_dir"
    rm -rf "/tmp/pve-update-$$"
-    
-    # Start the application
-    start_application
+    rm -rf "$BACKUP_DIR"
+    log "Backup directory cleaned up"
    
    log_success "Update completed successfully!"
 }
@@ -1 +1 @@
 .4.6
 .4.9