proxmox-lxc-shell-commands/proxmox-lxc-stirling-pdf.sh

#!/usr/bin/env bash

# Stirling-PDF LXC Installation Script
# Description: Self-hosted PDF manipulation tool
# OS: Debian 12 (Bookworm)
# Ports: Web UI: 8080
# Repository: https://github.com/Stirling-Tools/Stirling-PDF
# Last Updated: 2026-01-06

set -euo pipefail

CT_ID=${CT_ID:-29004}
CT_HOSTNAME=${CT_HOSTNAME:-"stirling-pdf"}
CT_CORES=${CT_CORES:-2}
CT_MEMORY=${CT_MEMORY:-2048}
CT_SWAP=${CT_SWAP:-1024}
CT_DISK_SIZE=${CT_DISK_SIZE:-10}

CT_IP=${CT_IP:-"dhcp"}
CT_GATEWAY=${CT_GATEWAY:-""}
CT_BRIDGE=${CT_BRIDGE:-"vmbr0"}
CT_NAMESERVER=${CT_NAMESERVER:-"8.8.8.8"}

CT_STORAGE=${CT_STORAGE:-"local-lvm"}
TEMPLATE_STORAGE=${TEMPLATE_STORAGE:-"local"}
DEBIAN_VERSION="12"
TEMPLATE_NAME=""

STIRLING_PORT=${STIRLING_PORT:-8080}

CT_ONBOOT=${CT_ONBOOT:-1}
CT_UNPRIVILEGED=${CT_UNPRIVILEGED:-0}
CT_FEATURES=${CT_FEATURES:-"keyctl=1,nesting=1"}

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m'

info() { echo -e "${BLUE}[INFO]${NC} $1"; }
success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
error() { echo -e "${RED}[ERROR]${NC} $1"; }

check_root() { [[ $EUID -ne 0 ]] && error "Run as root" && exit 1; }
check_proxmox() { command -v pct &>/dev/null || { error "Run on Proxmox VE host"; exit 1; }; }
check_container_exists() { pct status "$CT_ID" &>/dev/null && { error "Container $CT_ID exists"; exit 1; }; }

detect_and_download_template() {
    info "Updating template database..."
    pveam update 2>&1 || true
    local available_template
    available_template=$(pveam available --section system 2>/dev/null | grep "debian-${DEBIAN_VERSION}" | grep "standard" | tail -1 | awk '{print $2}')
    [[ -z "$available_template" ]] && error "No Debian ${DEBIAN_VERSION} template found" && exit 1
    TEMPLATE_NAME="$available_template"
    info "Found template: $TEMPLATE_NAME"
    pveam list "$TEMPLATE_STORAGE" 2>/dev/null | grep -q "$TEMPLATE_NAME" || pveam download "$TEMPLATE_STORAGE" "$TEMPLATE_NAME" 2>&1
    success "Template ready"
}

create_container() {
    info "Creating LXC container $CT_ID ($CT_HOSTNAME)..."
    local net_config="name=eth0,bridge=${CT_BRIDGE},ip=${CT_IP}"
    [[ "$CT_IP" != "dhcp" ]] && [[ -n "$CT_GATEWAY" ]] && net_config="${net_config},gw=${CT_GATEWAY}"
    pct create "$CT_ID" "${TEMPLATE_STORAGE}:vztmpl/${TEMPLATE_NAME}" \
        --hostname "$CT_HOSTNAME" --cores "$CT_CORES" --memory "$CT_MEMORY" --swap "$CT_SWAP" \
        --rootfs "${CT_STORAGE}:${CT_DISK_SIZE}" --net0 "$net_config" --nameserver "$CT_NAMESERVER" \
        --onboot "$CT_ONBOOT" --unprivileged "$CT_UNPRIVILEGED" --features "$CT_FEATURES" --ostype debian || exit 1
    success "Container created"
}

start_container() {
    info "Starting container..."
    pct start "$CT_ID" && sleep 5
    success "Container started"
}

install_docker() {
    info "Installing Docker..."
    pct exec "$CT_ID" -- bash -c "apt-get update -qq && DEBIAN_FRONTEND=noninteractive apt-get install -y -qq ca-certificates curl gnupg"
    pct exec "$CT_ID" -- bash -c "install -m 0755 -d /etc/apt/keyrings && curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc && chmod a+r /etc/apt/keyrings/docker.asc"
    pct exec "$CT_ID" -- bash -c 'echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null'
    pct exec "$CT_ID" -- bash -c "apt-get update -qq && DEBIAN_FRONTEND=noninteractive apt-get install -y -qq docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin"
    pct exec "$CT_ID" -- bash -c "systemctl enable docker && systemctl start docker"
    sleep 3
    success "Docker installed"
}

install_stirling_pdf() {
    info "Installing Stirling-PDF..."
    pct exec "$CT_ID" -- bash -c "mkdir -p /opt/stirling-pdf/{data,config,logs}"

    pct exec "$CT_ID" -- bash -c "cat > /opt/stirling-pdf/docker-compose.yml << 'EOF'
services:
  stirling-pdf:
    image: frooodle/s-pdf:latest
    container_name: stirling-pdf
    restart: always
    ports:
      - \"\${STIRLING_PORT:-8080}:8080\"
    volumes:
      - ./data:/usr/share/tessdata
      - ./config:/configs
      - ./logs:/logs
    environment:
      - DOCKER_ENABLE_SECURITY=false
      - INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false
      - LANGS=ko_KR
    networks:
      - stirling-network

networks:
  stirling-network:
    driver: bridge
EOF"

    pct exec "$CT_ID" -- bash -c "cat > /opt/stirling-pdf/.env << 'EOF'
STIRLING_PORT=${STIRLING_PORT}
EOF"

    info "Starting Stirling-PDF container..."
    pct exec "$CT_ID" -- bash -c "cd /opt/stirling-pdf && docker compose up -d" 2>&1

    info "Waiting for Stirling-PDF to start..."
    local max_attempts=30
    local attempt=1
    while [[ $attempt -le $max_attempts ]]; do
        if pct exec "$CT_ID" -- bash -c "curl -s -o /dev/null -w '%{http_code}' http://localhost:${STIRLING_PORT}/" | grep -q "200\|302"; then
            success "Stirling-PDF is running!"
            break
        fi
        echo -n "."
        sleep 3
        ((attempt++))
    done
    echo ""
    success "Stirling-PDF installed"
}

create_service() {
    pct exec "$CT_ID" -- bash -c 'cat > /etc/systemd/system/stirling-pdf.service << EOF
[Unit]
Description=Stirling-PDF
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/stirling-pdf
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=120

[Install]
WantedBy=multi-user.target
EOF'
    pct exec "$CT_ID" -- bash -c "systemctl daemon-reload && systemctl enable stirling-pdf"
    success "Stirling-PDF service created"
}

verify_installation() {
    local container_ip
    container_ip=$(pct exec "$CT_ID" -- bash -c "hostname -I | awk '{print \$1}'" 2>/dev/null || echo "unknown")

    echo ""
    echo "================================================================"
    echo -e "${GREEN}Stirling-PDF Installation Complete!${NC}"
    echo "================================================================"
    echo "Container ID: $CT_ID | Hostname: $CT_HOSTNAME | IP: $container_ip"
    echo ""
    echo "Web UI: http://${container_ip}:${STIRLING_PORT}"
    echo ""
    echo "Features:"
    echo "  - Merge, split, rotate PDFs"
    echo "  - Convert to/from various formats"
    echo "  - OCR text extraction"
    echo "  - Add watermarks, signatures"
    echo "  - Compress and optimize PDFs"
    echo ""
    echo "Data location: /opt/stirling-pdf"
    echo "================================================================"
}

main() {
    echo "================================================================"
    echo "Stirling-PDF LXC Installation Script"
    echo "================================================================"
    check_root
    check_proxmox
    check_container_exists
    detect_and_download_template
    create_container
    start_container
    install_docker
    install_stirling_pdf
    create_service
    verify_installation
}

main "$@"