feat: add Kan, Puter, Lychee, Fleet scripts (ct/install/json)

2026-04-04 23:21:13 +02:00
parent 3999830b2c
commit d2f6be43e7
12 changed files with 749 additions and 0 deletions
--- a/ct/fleet.sh
+++ b/ct/fleet.sh
@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/misc/build.func)
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/fleetdm/fleet
+
+APP="Fleet"
+var_tags="${var_tags:-monitoring;device-management;security}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-2048}"
+var_disk="${var_disk:-8}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+
+  if [[ ! -f /opt/fleet/fleet ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_release "fleet" "fleetdm/fleet"; then
+    msg_info "Stopping Service"
+    systemctl stop fleet
+    msg_ok "Stopped Service"
+
+    fetch_and_deploy_gh_release "fleet" "fleetdm/fleet" "prebuild" "latest" "/opt/fleet" "fleet_v*_linux.tar.gz"
+    chmod +x /opt/fleet/fleet
+
+    msg_info "Running Database Migrations"
+    set -a && source /opt/fleet/.env && set +a
+    $STD /opt/fleet/fleet prepare db
+    msg_ok "Ran Database Migrations"
+
+    msg_info "Starting Service"
+    systemctl start fleet
+    msg_ok "Started Service"
+    msg_ok "Updated successfully!"
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:8080${CL}"
--- a/ct/kan.sh
+++ b/ct/kan.sh
@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/misc/build.func)
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/kanbn/kan
+
+APP="Kan"
+var_tags="${var_tags:-project-management;kanban}"
+var_cpu="${var_cpu:-4}"
+var_ram="${var_ram:-4096}"
+var_disk="${var_disk:-12}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+
+  if [[ ! -d /opt/kan ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_tag "kan" "kanbn/kan"; then
+    msg_info "Stopping Service"
+    systemctl stop kan
+    msg_ok "Stopped Service"
+
+    msg_info "Backing up Data"
+    cp /opt/kan/.env /opt/kan.env.bak
+    msg_ok "Backed up Data"
+
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_tag "kan" "kanbn/kan"
+
+    msg_info "Restoring Configuration"
+    cp /opt/kan.env.bak /opt/kan/.env
+    rm -f /opt/kan.env.bak
+    msg_ok "Restored Configuration"
+
+    msg_info "Building Application"
+    cd /opt/kan
+    export NEXT_PUBLIC_USE_STANDALONE_OUTPUT=true
+    set -a && source /opt/kan/.env && set +a
+    $STD pnpm install
+    $STD pnpm build --filter=@kan/web
+    unset NEXT_PUBLIC_USE_STANDALONE_OUTPUT
+    msg_ok "Built Application"
+
+    msg_info "Setting up Standalone"
+    mkdir -p /opt/kan/apps/web/.next/standalone/apps/web/.next/static
+    cp -r /opt/kan/apps/web/.next/static/* /opt/kan/apps/web/.next/standalone/apps/web/.next/static/
+    cp -r /opt/kan/apps/web/public /opt/kan/apps/web/.next/standalone/apps/web/public
+    msg_ok "Set up Standalone"
+
+    msg_info "Running Database Migrations"
+    cd /opt/kan/packages/db
+    $STD pnpm exec drizzle-kit migrate
+    msg_ok "Ran Database Migrations"
+
+    msg_info "Starting Service"
+    systemctl start kan
+    msg_ok "Started Service"
+    msg_ok "Updated successfully!"
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3000${CL}"
--- a/ct/lychee.sh
+++ b/ct/lychee.sh
@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/misc/build.func)
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/LycheeOrg/Lychee
+
+APP="Lychee"
+var_tags="${var_tags:-media;photos;gallery}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-2048}"
+var_disk="${var_disk:-8}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+
+  if [[ ! -d /opt/lychee ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_release "lychee" "LycheeOrg/Lychee"; then
+    msg_info "Stopping Services"
+    systemctl stop caddy
+    msg_ok "Stopped Services"
+
+    msg_info "Backing up Data"
+    cp /opt/lychee/.env /opt/lychee.env.bak
+    cp -r /opt/lychee/storage /opt/lychee_storage_backup
+    msg_ok "Backed up Data"
+
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "lychee" "LycheeOrg/Lychee" "prebuild" "latest" "/opt/lychee" "Lychee.zip"
+
+    msg_info "Restoring Data"
+    cp /opt/lychee.env.bak /opt/lychee/.env
+    rm -f /opt/lychee.env.bak
+    cp -r /opt/lychee_storage_backup/. /opt/lychee/storage
+    rm -rf /opt/lychee_storage_backup
+    msg_ok "Restored Data"
+
+    msg_info "Updating Application"
+    cd /opt/lychee
+    $STD php artisan migrate --force
+    $STD php artisan optimize:clear
+    chmod -R 775 /opt/lychee/storage /opt/lychee/bootstrap/cache
+    msg_ok "Updated Application"
+
+    msg_info "Starting Services"
+    systemctl start caddy
+    msg_ok "Started Services"
+    msg_ok "Updated successfully!"
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:80${CL}"
--- a/ct/puter.sh
+++ b/ct/puter.sh
@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/misc/build.func)
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/HeyPuter/puter
+
+APP="Puter"
+var_tags="${var_tags:-cloud;desktop;files}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-2048}"
+var_disk="${var_disk:-8}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-13}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+
+  if [[ ! -d /opt/puter ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit
+  fi
+
+  if check_for_gh_release "puter" "HeyPuter/puter"; then
+    msg_info "Stopping Service"
+    systemctl stop puter
+    msg_ok "Stopped Service"
+
+    CLEAN_INSTALL=1 fetch_and_deploy_gh_release "puter" "HeyPuter/puter" "tarball"
+
+    msg_info "Building Application"
+    cd /opt/puter
+    $STD npm ci
+    cd /opt/puter/src/gui
+    $STD npm run build
+    cd /opt/puter
+    cp -r src/gui/dist dist
+    msg_ok "Built Application"
+
+    msg_info "Starting Service"
+    systemctl start puter
+    msg_ok "Started Service"
+    msg_ok "Updated successfully!"
+  fi
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed Successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:4100${CL}"
--- a/install/fleet-install.sh
+++ b/install/fleet-install.sh
@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/fleetdm/fleet
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+setup_mysql
+
+msg_info "Setting up Database"
+FLEET_DB_PASS=$(openssl rand -base64 18 | tr -dc 'a-zA-Z0-9' | head -c 13)
+$STD mysql -u root <<EOSQL
+CREATE DATABASE fleet;
+CREATE USER 'fleet'@'localhost' IDENTIFIED BY '${FLEET_DB_PASS}';
+GRANT ALL PRIVILEGES ON fleet.* TO 'fleet'@'localhost';
+FLUSH PRIVILEGES;
+EOSQL
+msg_ok "Set up Database"
+
+fetch_and_deploy_gh_release "fleet" "fleetdm/fleet" "prebuild" "latest" "/opt/fleet" "fleet_v*_linux.tar.gz"
+
+msg_info "Configuring Application"
+chmod +x /opt/fleet/fleet
+JWT_KEY=$(openssl rand -base64 32)
+cat <<EOF >/opt/fleet/.env
+FLEET_MYSQL_ADDRESS=127.0.0.1:3306
+FLEET_MYSQL_DATABASE=fleet
+FLEET_MYSQL_USERNAME=fleet
+FLEET_MYSQL_PASSWORD=${FLEET_DB_PASS}
+FLEET_SERVER_ADDRESS=0.0.0.0:8080
+FLEET_SERVER_TLS=false
+FLEET_AUTH_JWT_KEY=${JWT_KEY}
+FLEET_LOGGING_JSON=true
+EOF
+msg_ok "Configured Application"
+
+msg_info "Running Database Migrations"
+set -a && source /opt/fleet/.env && set +a
+$STD /opt/fleet/fleet prepare db
+msg_ok "Ran Database Migrations"
+
+msg_info "Creating Service"
+cat <<EOF >/etc/systemd/system/fleet.service
+[Unit]
+Description=Fleet
+After=network.target mysql.service
+Requires=mysql.service
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/opt/fleet
+EnvironmentFile=/opt/fleet/.env
+ExecStart=/opt/fleet/fleet serve
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl enable -q --now fleet
+msg_ok "Created Service"
+
+motd_ssh
+customize
+cleanup_lxc
--- a/install/kan-install.sh
+++ b/install/kan-install.sh
@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/kanbn/kan
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Installing Dependencies"
+$STD apt install -y \
+  build-essential \
+  git
+msg_ok "Installed Dependencies"
+
+PG_VERSION="16" setup_postgresql
+PG_DB_NAME="kan" PG_DB_USER="kan" setup_postgresql_db
+NODE_VERSION="20" setup_nodejs
+
+msg_info "Installing pnpm"
+$STD npm install -g pnpm
+msg_ok "Installed pnpm"
+
+fetch_and_deploy_gh_tag "kan" "kanbn/kan"
+
+msg_info "Building Application"
+cd /opt/kan
+export NEXT_PUBLIC_USE_STANDALONE_OUTPUT=true
+export NEXT_PUBLIC_BASE_URL="http://${LOCAL_IP}:3000"
+$STD pnpm install
+$STD pnpm build --filter=@kan/web
+unset NEXT_PUBLIC_USE_STANDALONE_OUTPUT NEXT_PUBLIC_BASE_URL
+msg_ok "Built Application"
+
+msg_info "Setting up Standalone"
+mkdir -p /opt/kan/apps/web/.next/standalone/apps/web/.next/static
+cp -r /opt/kan/apps/web/.next/static/* /opt/kan/apps/web/.next/standalone/apps/web/.next/static/
+cp -r /opt/kan/apps/web/public /opt/kan/apps/web/.next/standalone/apps/web/public
+msg_ok "Set up Standalone"
+
+msg_info "Running Database Migrations"
+cd /opt/kan/packages/db
+POSTGRES_URL="postgres://${PG_DB_USER}:${PG_DB_PASS}@localhost:5432/${PG_DB_NAME}" $STD pnpm exec drizzle-kit migrate
+msg_ok "Ran Database Migrations"
+
+msg_info "Configuring Application"
+AUTH_SECRET=$(openssl rand -base64 32)
+cat <<EOF >/opt/kan/.env
+NEXT_PUBLIC_BASE_URL=http://${LOCAL_IP}:3000
+BETTER_AUTH_SECRET=${AUTH_SECRET}
+POSTGRES_URL=postgres://${PG_DB_USER}:${PG_DB_PASS}@localhost:5432/${PG_DB_NAME}
+HOSTNAME=0.0.0.0
+PORT=3000
+NODE_ENV=production
+EOF
+msg_ok "Configured Application"
+
+msg_info "Creating Service"
+cat <<EOF >/etc/systemd/system/kan.service
+[Unit]
+Description=Kan Board
+After=network.target postgresql.service
+Requires=postgresql.service
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/opt/kan/apps/web/.next/standalone
+EnvironmentFile=/opt/kan/.env
+ExecStart=/usr/bin/node apps/web/server.js
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl enable -q --now kan
+msg_ok "Created Service"
+
+motd_ssh
+customize
+cleanup_lxc
--- a/install/lychee-install.sh
+++ b/install/lychee-install.sh
@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/LycheeOrg/Lychee
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Installing Dependencies"
+$STD apt install -y \
+  caddy \
+  libimage-exiftool-perl \
+  jpegoptim
+msg_ok "Installed Dependencies"
+
+PHP_VERSION="8.4" PHP_FPM="YES" PHP_MODULES="bcmath,exif,gd,intl,imagick,redis,zip,pdo_pgsql,pcntl,ldap" setup_php
+
+setup_ffmpeg
+setup_imagemagick
+setup_gs
+
+PG_VERSION="16" setup_postgresql
+PG_DB_NAME="lychee" PG_DB_USER="lychee" setup_postgresql_db
+
+fetch_and_deploy_gh_release "lychee" "LycheeOrg/Lychee" "prebuild" "latest" "/opt/lychee" "Lychee.zip"
+
+msg_info "Configuring Application"
+cd /opt/lychee
+cp .env.example .env
+APP_KEY=$($STD php artisan key:generate --show)
+sed -i "s|^APP_KEY=.*|APP_KEY=${APP_KEY}|" .env
+sed -i "s|^APP_ENV=.*|APP_ENV=production|" .env
+sed -i "s|^APP_DEBUG=.*|APP_DEBUG=false|" .env
+sed -i "s|^APP_URL=.*|APP_URL=http://${LOCAL_IP}|" .env
+sed -i "s|^DB_CONNECTION=.*|DB_CONNECTION=pgsql|" .env
+sed -i "s|^DB_HOST=.*|DB_HOST=127.0.0.1|" .env
+sed -i "s|^DB_PORT=.*|DB_PORT=5432|" .env
+sed -i "s|^DB_DATABASE=.*|DB_DATABASE=${PG_DB_NAME}|" .env
+sed -i "s|^DB_USERNAME=.*|DB_USERNAME=${PG_DB_USER}|" .env
+sed -i "s|^DB_PASSWORD=.*|DB_PASSWORD=${PG_DB_PASS}|" .env
+mkdir -p storage/framework/{cache,sessions,views} storage/logs bootstrap/cache public/dist
+touch public/dist/user.css public/dist/custom.js
+chmod -R 775 storage bootstrap/cache public/dist
+msg_ok "Configured Application"
+
+msg_info "Running Database Migrations"
+cd /opt/lychee
+$STD php artisan migrate --force
+msg_ok "Ran Database Migrations"
+
+msg_info "Configuring Caddy"
+PHP_VER=$(php -r 'echo PHP_MAJOR_VERSION . "." . PHP_MINOR_VERSION;')
+cat <<EOF >/etc/caddy/Caddyfile
+:80 {
+    root * /opt/lychee/public
+    php_fastcgi unix//run/php/php${PHP_VER}-fpm.sock
+    file_server
+    encode gzip
+}
+EOF
+msg_ok "Configured Caddy"
+
+systemctl enable -q --now php${PHP_VER}-fpm caddy
+
+motd_ssh
+customize
+cleanup_lxc
--- a/install/puter-install.sh
+++ b/install/puter-install.sh
@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: MickLesk (CanbiZ)
+# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE
+# Source: https://github.com/HeyPuter/puter
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Installing Dependencies"
+$STD apt install -y \
+  build-essential \
+  git
+msg_ok "Installed Dependencies"
+
+NODE_VERSION="22" setup_nodejs
+
+fetch_and_deploy_gh_release "puter" "HeyPuter/puter" "tarball"
+
+msg_info "Building Application"
+cd /opt/puter
+$STD npm ci
+cd /opt/puter/src/gui
+$STD npm run build
+cd /opt/puter
+cp -r src/gui/dist dist
+msg_ok "Built Application"
+
+msg_info "Creating Directories"
+mkdir -p /etc/puter /var/puter
+msg_ok "Created Directories"
+
+msg_info "Creating Service"
+cat <<EOF >/etc/systemd/system/puter.service
+[Unit]
+Description=Puter
+After=network.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/opt/puter
+Environment=CONFIG_PATH=/etc/puter
+ExecStart=/usr/bin/npm start
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl enable -q --now puter
+msg_ok "Created Service"
+
+motd_ssh
+customize
+cleanup_lxc
--- a/json/fleet.json
+++ b/json/fleet.json
@@ -0,0 +1,44 @@
+{
+    "name": "Fleet",
+    "slug": "fleet",
+    "categories": [
+        9
+    ],
+    "date_created": "2026-04-04",
+    "type": "ct",
+    "updateable": true,
+    "privileged": false,
+    "interface_port": 8080,
+    "documentation": "https://fleetdm.com/docs",
+    "website": "https://fleetdm.com/",
+    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/fleet.webp",
+    "config_path": "/opt/fleet/.env",
+    "description": "Fleet is an open-source device management platform for IT and security teams to manage and monitor servers, laptops, and other devices with osquery.",
+    "install_methods": [
+        {
+            "type": "default",
+            "script": "ct/fleet.sh",
+            "resources": {
+                "cpu": 2,
+                "ram": 2048,
+                "hdd": 8,
+                "os": "Debian",
+                "version": "13"
+            }
+        }
+    ],
+    "default_credentials": {
+        "username": null,
+        "password": null
+    },
+    "notes": [
+        {
+            "text": "Create your admin account on first login via the web interface.",
+            "type": "info"
+        },
+        {
+            "text": "TLS is disabled by default. Configure TLS in /opt/fleet/.env for production use.",
+            "type": "warning"
+        }
+    ]
+}
--- a/json/kan.json
+++ b/json/kan.json
@@ -0,0 +1,44 @@
+{
+    "name": "Kan",
+    "slug": "kan",
+    "categories": [
+        25
+    ],
+    "date_created": "2026-04-04",
+    "type": "ct",
+    "updateable": true,
+    "privileged": false,
+    "interface_port": 3000,
+    "documentation": "https://github.com/kanbn/kan#readme",
+    "website": "https://kan.bn/",
+    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/kan.webp",
+    "config_path": "/opt/kan/.env",
+    "description": "Kan is an open-source Kanban board and project management tool built with Next.js and PostgreSQL.",
+    "install_methods": [
+        {
+            "type": "default",
+            "script": "ct/kan.sh",
+            "resources": {
+                "cpu": 4,
+                "ram": 4096,
+                "hdd": 12,
+                "os": "Debian",
+                "version": "13"
+            }
+        }
+    ],
+    "default_credentials": {
+        "username": null,
+        "password": null
+    },
+    "notes": [
+        {
+            "text": "Building from source requires significant resources and may take several minutes.",
+            "type": "warning"
+        },
+        {
+            "text": "Update NEXT_PUBLIC_BASE_URL in /opt/kan/.env if accessing from a different hostname.",
+            "type": "info"
+        }
+    ]
+}
--- a/json/lychee.json
+++ b/json/lychee.json
@@ -0,0 +1,44 @@
+{
+    "name": "Lychee",
+    "slug": "lychee",
+    "categories": [
+        13
+    ],
+    "date_created": "2026-04-04",
+    "type": "ct",
+    "updateable": true,
+    "privileged": false,
+    "interface_port": 80,
+    "documentation": "https://lycheeorg.dev/docs",
+    "website": "https://lycheeorg.github.io/",
+    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/lychee.webp",
+    "config_path": "/opt/lychee/.env",
+    "description": "Lychee is a free, self-hosted photo management tool that allows you to upload, manage, and share photos with a beautiful web interface.",
+    "install_methods": [
+        {
+            "type": "default",
+            "script": "ct/lychee.sh",
+            "resources": {
+                "cpu": 2,
+                "ram": 2048,
+                "hdd": 8,
+                "os": "Debian",
+                "version": "13"
+            }
+        }
+    ],
+    "default_credentials": {
+        "username": null,
+        "password": null
+    },
+    "notes": [
+        {
+            "text": "Create your admin account on first login via the web interface.",
+            "type": "info"
+        },
+        {
+            "text": "Photo storage uses disk space under /opt/lychee/storage. Plan disk size accordingly.",
+            "type": "info"
+        }
+    ]
+}
--- a/json/puter.json
+++ b/json/puter.json
@@ -0,0 +1,40 @@
+{
+    "name": "Puter",
+    "slug": "puter",
+    "categories": [
+        0
+    ],
+    "date_created": "2026-04-04",
+    "type": "ct",
+    "updateable": true,
+    "privileged": false,
+    "interface_port": 4100,
+    "documentation": "https://docs.puter.com/",
+    "website": "https://puter.com/",
+    "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/puter.webp",
+    "config_path": "/etc/puter",
+    "description": "Puter is an open-source personal cloud and web desktop environment that runs in your browser, providing a full desktop experience with file management, app ecosystem, and cloud storage.",
+    "install_methods": [
+        {
+            "type": "default",
+            "script": "ct/puter.sh",
+            "resources": {
+                "cpu": 2,
+                "ram": 2048,
+                "hdd": 8,
+                "os": "Debian",
+                "version": "13"
+            }
+        }
+    ],
+    "default_credentials": {
+        "username": null,
+        "password": null
+    },
+    "notes": [
+        {
+            "text": "Configuration is stored in /etc/puter and data in /var/puter.",
+            "type": "info"
+        }
+    ]
+}