mirror of
https://github.com/community-scripts/ProxmoxVE.git
synced 2026-03-03 09:25:55 +01:00
* Standardize exit codes and add mappings Replace generic exit 1 usages with specific numeric exit codes and add corresponding explanations to the error lookup. This commit updates multiple misc/* scripts to return distinct codes for validation, Proxmox/LXC, networking, download and curl errors (e.g. 103-123, 64, 107-120, 206, 0 for explicit user cancels). It also updates curl error handling to propagate the original curl exit code and adds new entries in explain_exit_code and the error handler to improve diagnostics. * Set exit code 115 for update_os errors Change exit status from 6 to 115 in misc/alpine-install.func's update_os() error handlers when failing to download tools.func or when the expected functions are missing. This gives a distinct exit code for these specific failure cases. * Add tools/addon exit codes and use them Introduce exit codes 232-238 for Tools & Addon scripts in misc/api.func and misc/error_handler.func. Update addon scripts (tools/addon/adguardhome-sync.sh, tools/addon/copyparty.sh, tools/addon/cronmaster.sh) to return specific codes instead of generic exit 1: 238 for unsupported OS and 233 when the application is not installed/upgrade prerequisites are missing. This makes failures more descriptive and aligns scripts with the central error explanations. * Standardize exit codes in exporter addons Unify exit codes across exporter addon scripts: return 238 for unsupported OS detections and 233 when an update is requested but the exporter is not installed. Applied to nextcloud-exporter.sh, pihole-exporter.sh, prometheus-paperless-ngx-exporter.sh, and qbittorrent-exporter.sh to make failure modes distinguishable for callers/automation. * Use specific exit codes in addon scripts Replace generic exit 1 with distinct exit codes across multiple addon scripts to enable finer-grained error handling in automation. Exit codes introduced: 10 for Docker/Compose missing or user-declined Docker install, 233 for "nothing to update" cases, and 238 for unsupported OS cases. Affected files: tools/addon/arcane.sh, coolify.sh, dockge.sh, dokploy.sh, filebrowser-quantum.sh, filebrowser.sh, immich-public-proxy.sh, jellystat.sh, runtipi.sh. * Use specific exit codes in addon scripts Replace generic exit 1 with specific exit codes across multiple addon scripts to improve error signaling and handling. Files updated: tools/addon/add-netbird-lxc.sh (exit 238 on unsupported distro), tools/addon/add-tailscale-lxc.sh (treat user cancel as exit 0), tools/addon/glances.sh (exit 233 when not installed), tools/addon/komodo.sh (distinct exits for missing compose, legacy DB, backup/download failures, docker checks), tools/addon/netdata.sh (distinct exits for unsupported PVE versions, OS/codename detection, repo lookups), and tools/addon/phpmyadmin.sh (distinct exits for unsupported OS, network/download issues, package install/start failures, and invalid input). These changes make failures easier to identify and automate recovery or reporting. * Use specific exit codes in PVE scripts Replace generic exit 1 with distinct exit codes across tools/pve scripts to provide clearer failure signals for callers. post-pve-install.sh now returns 105 for unsupported Proxmox versions; pve-privilege-converter.sh uses 104 for non-root, 234 when no containers, and 235 for backup/conversion failures; update-apps.sh maps backup failures to 235, missing containers/selections to 234 (and UI cancellations to 0), missing backup storage to 119, and returns the actual container update exit code on failure. These changes improve diagnostics and allow external tooling to react to specific error conditions. * Standardize exit codes and behaviors Adjust exit codes and abort handling across multiple PVE helper scripts to provide clearer outcomes for automation and interactive flows. Changes include: - container-restore-from-backup.sh, core-restore-from-backup.sh: return 235 when no backups found (was 1). - fstrim.sh: treat user cancellation of non-ext4 warning as non-error (exit 0 instead of 1). - kernel-clean.sh: treat no selection or user abort as non-error (exit 0 instead of 1). - lxc-delete.sh: return 234 when no containers are present; treat no selection as non-error (exit 0). - nic-offloading-fix.sh: use specific non-zero codes for root check and tool install failures (exit 104, 237) and 236 when no matching interfaces (was 1). - pbs_microcode.sh, post-pmg-install.sh, post-pbs-install.sh: use distinct exit codes (232 and 105) for detected VM/PVE/unsupported distro conditions instead of generic 1. These modifications make scripts return distinct codes for different failure modes and ensure user-initiated aborts or benign conditions exit with 0 where appropriate. * Use exit 105 for unsupported PVE versions Standardize error handling by replacing generic exit 1 with exit 105 in pve_check() across multiple VM template scripts to indicate unsupported Proxmox VE versions. Also add API exit code 226 message for "Proxmox: VM disk import or post-creation setup failed" in misc/api.func. Affected files include misc/api.func and various vm/*-vm.sh scripts. * Use specific exit codes in VM scripts Replace generic exit 1 with distinct exit codes across vm/*.sh to make failures more actionable for callers. Changes include: use 226 for missing imported-disk references, 237 for pv installation failures, 115 for download/extract/ISO-related failures, 214 for insufficient disk space during FreeBSD decompression, and 119 for missing storage detection. Updated scripts: archlinux-vm.sh, docker-vm.sh, haos-vm.sh, openwrt-vm.sh, opnsense-vm.sh, truenas-vm.sh, umbrel-os-vm.sh.
377 lines
12 KiB
Bash
377 lines
12 KiB
Bash
#!/usr/bin/env bash
|
|
|
|
# Copyright (c) 2021-2026 community-scripts ORG
|
|
# Author: MickLesk (CanbiZ)
|
|
# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
|
|
# Source: https://github.com/CyferShepard/Jellystat
|
|
|
|
if ! command -v curl &>/dev/null; then
|
|
printf "\r\e[2K%b" '\033[93m Setup Source \033[m' >&2
|
|
apt-get update >/dev/null 2>&1
|
|
apt-get install -y curl >/dev/null 2>&1
|
|
fi
|
|
source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
|
|
source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
|
|
source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
|
|
source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
|
|
|
|
# Enable error handling
|
|
set -Eeuo pipefail
|
|
trap 'error_handler' ERR
|
|
|
|
# ==============================================================================
|
|
# CONFIGURATION
|
|
# ==============================================================================
|
|
APP="Jellystat"
|
|
APP_TYPE="addon"
|
|
INSTALL_PATH="/opt/jellystat"
|
|
CONFIG_PATH="/opt/jellystat/.env"
|
|
DEFAULT_PORT=3000
|
|
|
|
# Initialize all core functions (colors, formatting, icons, STD mode)
|
|
load_functions
|
|
init_tool_telemetry "" "addon"
|
|
|
|
# ==============================================================================
|
|
# HEADER
|
|
# ==============================================================================
|
|
function header_info {
|
|
clear
|
|
cat <<"EOF"
|
|
__ ____ __ __
|
|
/ /__ / / /_ _______/ /_____ _/ /_
|
|
__ / / _ \/ / / / / / ___/ __/ __ `/ __/
|
|
/ /_/ / __/ / / /_/ (__ ) /_/ /_/ / /_
|
|
\____/\___/_/_/\__, /____/\__/\__,_/\__/
|
|
/____/
|
|
EOF
|
|
}
|
|
|
|
# ==============================================================================
|
|
# OS DETECTION
|
|
# ==============================================================================
|
|
if [[ -f "/etc/alpine-release" ]]; then
|
|
msg_error "Alpine is not supported for ${APP}. Use Debian/Ubuntu."
|
|
exit 238
|
|
elif [[ -f "/etc/debian_version" ]]; then
|
|
OS="Debian"
|
|
SERVICE_PATH="/etc/systemd/system/jellystat.service"
|
|
else
|
|
echo -e "${CROSS} Unsupported OS detected. Exiting."
|
|
exit 238
|
|
fi
|
|
|
|
# ==============================================================================
|
|
# UNINSTALL
|
|
# ==============================================================================
|
|
function uninstall() {
|
|
msg_info "Uninstalling ${APP}"
|
|
systemctl disable --now jellystat.service &>/dev/null || true
|
|
rm -f "$SERVICE_PATH"
|
|
rm -rf "$INSTALL_PATH"
|
|
rm -f "/usr/local/bin/update_jellystat"
|
|
rm -f "$HOME/.jellystat"
|
|
msg_ok "${APP} has been uninstalled"
|
|
|
|
# Ask about PostgreSQL database removal
|
|
echo ""
|
|
echo -n "${TAB}Also remove PostgreSQL database 'jellystat'? (y/N): "
|
|
read -r db_prompt
|
|
if [[ "${db_prompt,,}" =~ ^(y|yes)$ ]]; then
|
|
if command -v psql &>/dev/null; then
|
|
msg_info "Removing PostgreSQL database and user"
|
|
$STD sudo -u postgres psql -c "DROP DATABASE IF EXISTS jellystat;" &>/dev/null || true
|
|
$STD sudo -u postgres psql -c "DROP USER IF EXISTS jellystat;" &>/dev/null || true
|
|
msg_ok "Removed PostgreSQL database 'jellystat' and user 'jellystat'"
|
|
else
|
|
msg_warn "PostgreSQL not found - database may have been removed already"
|
|
fi
|
|
else
|
|
msg_warn "PostgreSQL database was NOT removed. Remove manually if needed:"
|
|
echo -e "${TAB} sudo -u postgres psql -c \"DROP DATABASE jellystat;\""
|
|
echo -e "${TAB} sudo -u postgres psql -c \"DROP USER jellystat;\""
|
|
fi
|
|
}
|
|
|
|
# ==============================================================================
|
|
# UPDATE
|
|
# ==============================================================================
|
|
function update() {
|
|
if check_for_gh_release "jellystat" "CyferShepard/Jellystat"; then
|
|
msg_info "Stopping service"
|
|
systemctl stop jellystat.service &>/dev/null || true
|
|
msg_ok "Stopped service"
|
|
|
|
msg_info "Backing up configuration"
|
|
cp "$CONFIG_PATH" /tmp/jellystat.env.bak 2>/dev/null || true
|
|
msg_ok "Backed up configuration"
|
|
|
|
CLEAN_INSTALL=1 fetch_and_deploy_gh_release "jellystat" "CyferShepard/Jellystat" "tarball" "latest" "$INSTALL_PATH"
|
|
|
|
msg_info "Restoring configuration"
|
|
cp /tmp/jellystat.env.bak "$CONFIG_PATH" 2>/dev/null || true
|
|
rm -f /tmp/jellystat.env.bak
|
|
msg_ok "Restored configuration"
|
|
|
|
msg_info "Installing dependencies"
|
|
cd "$INSTALL_PATH"
|
|
$STD npm install
|
|
msg_ok "Installed dependencies"
|
|
|
|
msg_info "Building ${APP}"
|
|
$STD npm run build
|
|
msg_ok "Built ${APP}"
|
|
|
|
msg_info "Starting service"
|
|
systemctl start jellystat
|
|
msg_ok "Started service"
|
|
msg_ok "Updated successfully"
|
|
exit
|
|
fi
|
|
}
|
|
|
|
# ==============================================================================
|
|
# INSTALL
|
|
# ==============================================================================
|
|
function install() {
|
|
# Setup Node.js (only installs if not present or different version)
|
|
if command -v node &>/dev/null; then
|
|
msg_ok "Node.js already installed ($(node -v))"
|
|
else
|
|
NODE_VERSION="22" setup_nodejs
|
|
fi
|
|
|
|
# Setup PostgreSQL (only installs if not present)
|
|
if command -v psql &>/dev/null; then
|
|
msg_ok "PostgreSQL already installed"
|
|
else
|
|
PG_VERSION="17" setup_postgresql
|
|
fi
|
|
|
|
# Create database and user (skip if already exists)
|
|
local DB_NAME="jellystat"
|
|
local DB_USER="jellystat"
|
|
local DB_PASS
|
|
|
|
msg_info "Setting up PostgreSQL database"
|
|
|
|
# Check if database already exists
|
|
if sudo -u postgres psql -lqt 2>/dev/null | cut -d \| -f 1 | grep -qw "$DB_NAME"; then
|
|
msg_warn "Database '${DB_NAME}' already exists - skipping creation"
|
|
echo -n "${TAB}Enter existing database password for '${DB_USER}': "
|
|
read -rs DB_PASS
|
|
echo ""
|
|
else
|
|
# Generate new password
|
|
DB_PASS=$(openssl rand -base64 18 | tr -dc 'a-zA-Z0-9' | head -c16)
|
|
|
|
# Check if user exists, create if not
|
|
if sudo -u postgres psql -tAc "SELECT 1 FROM pg_roles WHERE rolname='${DB_USER}'" 2>/dev/null | grep -q 1; then
|
|
msg_info "User '${DB_USER}' exists, updating password"
|
|
$STD sudo -u postgres psql -c "ALTER USER ${DB_USER} WITH PASSWORD '${DB_PASS}';" || {
|
|
msg_error "Failed to update PostgreSQL user"
|
|
return 1
|
|
}
|
|
else
|
|
$STD sudo -u postgres psql -c "CREATE USER ${DB_USER} WITH PASSWORD '${DB_PASS}';" || {
|
|
msg_error "Failed to create PostgreSQL user"
|
|
return 1
|
|
}
|
|
fi
|
|
|
|
# Create database (use template0 for UTF8 encoding compatibility)
|
|
$STD sudo -u postgres psql -c "CREATE DATABASE ${DB_NAME} WITH OWNER ${DB_USER} ENCODING 'UTF8' LC_COLLATE='C' LC_CTYPE='C' TEMPLATE template0;" || {
|
|
msg_error "Failed to create PostgreSQL database"
|
|
return 1
|
|
}
|
|
$STD sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE ${DB_NAME} TO ${DB_USER};" || {
|
|
msg_error "Failed to grant privileges"
|
|
return 1
|
|
}
|
|
|
|
# Grant schema permissions (required for PostgreSQL 15+)
|
|
$STD sudo -u postgres psql -d "${DB_NAME}" -c "GRANT ALL ON SCHEMA public TO ${DB_USER};" || true
|
|
|
|
# Configure pg_hba.conf for password authentication on localhost
|
|
local PG_HBA
|
|
PG_HBA=$(sudo -u postgres psql -tAc "SHOW hba_file;" 2>/dev/null | tr -d ' ')
|
|
if [[ -n "$PG_HBA" && -f "$PG_HBA" ]]; then
|
|
# Check if md5/scram-sha-256 auth is already configured for local connections
|
|
if ! grep -qE "^host\s+${DB_NAME}\s+${DB_USER}\s+127.0.0.1" "$PG_HBA"; then
|
|
msg_info "Configuring PostgreSQL authentication"
|
|
# Add password auth for jellystat user on localhost (before the default rules)
|
|
sed -i "/^# IPv4 local connections:/a host ${DB_NAME} ${DB_USER} 127.0.0.1/32 scram-sha-256" "$PG_HBA"
|
|
sed -i "/^# IPv4 local connections:/a host ${DB_NAME} ${DB_USER} ::1/128 scram-sha-256" "$PG_HBA"
|
|
# Reload PostgreSQL to apply changes
|
|
systemctl reload postgresql
|
|
msg_ok "Configured PostgreSQL authentication"
|
|
fi
|
|
fi
|
|
|
|
msg_ok "Created PostgreSQL database '${DB_NAME}'"
|
|
fi
|
|
|
|
# Generate JWT Secret
|
|
local JWT_SECRET
|
|
JWT_SECRET=$(openssl rand -base64 32 | tr -dc 'a-zA-Z0-9' | head -c32)
|
|
|
|
# Force fresh download by removing version cache
|
|
rm -f "$HOME/.jellystat"
|
|
fetch_and_deploy_gh_release "jellystat" "CyferShepard/Jellystat" "tarball" "latest" "$INSTALL_PATH"
|
|
|
|
msg_info "Installing dependencies"
|
|
cd "$INSTALL_PATH"
|
|
$STD npm install
|
|
msg_ok "Installed dependencies"
|
|
|
|
msg_info "Building ${APP}"
|
|
$STD npm run build
|
|
msg_ok "Built ${APP}"
|
|
|
|
msg_info "Creating configuration"
|
|
cat <<EOF >"$CONFIG_PATH"
|
|
# Jellystat Configuration
|
|
# Database
|
|
POSTGRES_USER=${DB_USER}
|
|
POSTGRES_PASSWORD=${DB_PASS}
|
|
POSTGRES_IP=localhost
|
|
POSTGRES_PORT=5432
|
|
POSTGRES_DB=${DB_NAME}
|
|
|
|
# Security
|
|
JWT_SECRET=${JWT_SECRET}
|
|
|
|
# Server
|
|
JS_LISTEN_IP=0.0.0.0
|
|
JS_BASE_URL=/
|
|
TZ=$(cat /etc/timezone 2>/dev/null || echo "UTC")
|
|
|
|
# Optional: GeoLite for IP Geolocation
|
|
# JS_GEOLITE_ACCOUNT_ID=
|
|
# JS_GEOLITE_LICENSE_KEY=
|
|
|
|
# Optional: Master Override (if you forget your password)
|
|
# JS_USER=admin
|
|
# JS_PASSWORD=admin
|
|
|
|
# Optional: Minimum playback duration to record (seconds)
|
|
# MINIMUM_SECONDS_TO_INCLUDE_PLAYBACK=1
|
|
|
|
# Optional: Self-signed certificates
|
|
REJECT_SELF_SIGNED_CERTIFICATES=true
|
|
EOF
|
|
chmod 600 "$CONFIG_PATH"
|
|
msg_ok "Created configuration"
|
|
|
|
msg_info "Creating service"
|
|
cat <<EOF >"$SERVICE_PATH"
|
|
[Unit]
|
|
Description=Jellystat - Statistics for Jellyfin
|
|
After=network.target postgresql.service
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=root
|
|
WorkingDirectory=${INSTALL_PATH}/backend
|
|
EnvironmentFile=${CONFIG_PATH}
|
|
ExecStart=/usr/bin/node ${INSTALL_PATH}/backend/server.js
|
|
Restart=always
|
|
RestartSec=10
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
EOF
|
|
systemctl enable --now jellystat &>/dev/null
|
|
msg_ok "Created and started service"
|
|
|
|
# Create update script (simple wrapper that calls this addon with type=update)
|
|
msg_info "Creating update script"
|
|
cat <<'UPDATEEOF' >/usr/local/bin/update_jellystat
|
|
#!/usr/bin/env bash
|
|
# Jellystat Update Script
|
|
type=update bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/addon/jellystat.sh)"
|
|
UPDATEEOF
|
|
chmod +x /usr/local/bin/update_jellystat
|
|
msg_ok "Created update script (/usr/local/bin/update_jellystat)"
|
|
|
|
# Save credentials
|
|
local CREDS_FILE="/root/jellystat.creds"
|
|
cat <<EOF >"$CREDS_FILE"
|
|
Jellystat Credentials
|
|
=====================
|
|
Database User: ${DB_USER}
|
|
Database Password: ${DB_PASS}
|
|
Database Name: ${DB_NAME}
|
|
JWT Secret: ${JWT_SECRET}
|
|
|
|
Web UI: http://${LOCAL_IP}:${DEFAULT_PORT}
|
|
EOF
|
|
chmod 600 "$CREDS_FILE"
|
|
|
|
echo ""
|
|
msg_ok "${APP} is reachable at: ${BL}http://${LOCAL_IP}:${DEFAULT_PORT}${CL}"
|
|
msg_ok "Credentials saved to: ${BL}${CREDS_FILE}${CL}"
|
|
echo ""
|
|
msg_warn "On first access, you'll need to configure your Jellyfin server connection."
|
|
}
|
|
|
|
# ==============================================================================
|
|
# MAIN
|
|
# ==============================================================================
|
|
|
|
# Handle type=update (called from update script)
|
|
if [[ "${type:-}" == "update" ]]; then
|
|
header_info
|
|
if [[ -d "$INSTALL_PATH" && -f "$INSTALL_PATH/package.json" ]]; then
|
|
update
|
|
else
|
|
msg_error "${APP} is not installed. Nothing to update."
|
|
exit 233
|
|
fi
|
|
exit 0
|
|
fi
|
|
|
|
header_info
|
|
get_lxc_ip
|
|
|
|
# Check if already installed
|
|
if [[ -d "$INSTALL_PATH" && -f "$INSTALL_PATH/package.json" ]]; then
|
|
msg_warn "${APP} is already installed."
|
|
echo ""
|
|
|
|
echo -n "${TAB}Uninstall ${APP}? (y/N): "
|
|
read -r uninstall_prompt
|
|
if [[ "${uninstall_prompt,,}" =~ ^(y|yes)$ ]]; then
|
|
uninstall
|
|
exit 0
|
|
fi
|
|
|
|
echo -n "${TAB}Update ${APP}? (y/N): "
|
|
read -r update_prompt
|
|
if [[ "${update_prompt,,}" =~ ^(y|yes)$ ]]; then
|
|
update
|
|
exit 0
|
|
fi
|
|
|
|
msg_warn "No action selected. Exiting."
|
|
exit 0
|
|
fi
|
|
|
|
# Fresh installation
|
|
msg_warn "${APP} is not installed."
|
|
echo ""
|
|
echo -e "${TAB}${INFO} This will install:"
|
|
echo -e "${TAB} - Node.js 22"
|
|
echo -e "${TAB} - PostgreSQL 17"
|
|
echo -e "${TAB} - Jellystat"
|
|
echo ""
|
|
|
|
echo -n "${TAB}Install ${APP}? (y/N): "
|
|
read -r install_prompt
|
|
if [[ "${install_prompt,,}" =~ ^(y|yes)$ ]]; then
|
|
install
|
|
else
|
|
msg_warn "Installation cancelled. Exiting."
|
|
exit 0
|
|
fi
|