Post-Install Configuration¶

Essential configuration steps after fresh Proxmox VE installation.

🚀 Automated Setup¶

Community Scripts (Recommended):

Proxmox VE Post Install - Automated post-install configuration

Video Tutorials:

Post Install Configuration - Step-by-step post-install guide
Don’t run Proxmox without these settings! - Essential configuration tips

Custom Automated Script:

Use the provided post-install automation script:

# Download and run the post-install script
wget -O - https://raw.githubusercontent.com/your-repo/proxmox-configs/main/scripts/post-install-setup.sh | bash

Or run the local script:

chmod +x configs/scripts/post-install-setup.sh
./configs/scripts/post-install-setup.sh

Configuration Files Available:

The complete automated setup script:

post-install-setup.sh¶

#!/bin/bash

# Proxmox Post-Install Setup Script
# This script automates the post-installation configuration of Proxmox VE
# Run as root on fresh Proxmox installation

set -euo pipefail

# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color

# Logging function
log() {
    echo -e "${GREEN}[$(date +'%Y-%m-%d %H:%M:%S')] $1${NC}"
}

warn() {
    echo -e "${YELLOW}[$(date +'%Y-%m-%d %H:%M:%S')] WARNING: $1${NC}"
}

error() {
    echo -e "${RED}[$(date +'%Y-%m-%d %H:%M:%S')] ERROR: $1${NC}"
    exit 1
}

# Check if running as root
if [[ $EUID -ne 0 ]]; then
   error "This script must be run as root"
fi

log "Starting Proxmox Post-Install Configuration"

# 1. Remove local-lvm and extend root partition
log "Removing local-lvm storage and extending root partition..."
if lvs | grep -q "data"; then
    lvremove -y /dev/pve/data
    lvresize -l +100%FREE /dev/pve/root
    resize2fs /dev/mapper/pve-root
    log "Storage reconfiguration completed"
else
    warn "local-lvm not found, skipping storage reconfiguration"
fi

# 2. Configure repositories
log "Configuring package repositories..."

# Disable enterprise repositories
if [ -f /etc/apt/sources.list.d/pve-enterprise.list ]; then
    sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list
    log "Disabled PVE Enterprise repository"
fi

if [ -f /etc/apt/sources.list.d/ceph.list ]; then
    sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/ceph.list
    log "Disabled Ceph Enterprise repository"
fi

# Add no-subscription repository
if ! grep -q "pve-no-subscription" /etc/apt/sources.list; then
    echo "deb http://download.proxmox.com/debian/pve $(lsb_release -cs) pve-no-subscription" >> /etc/apt/sources.list
    log "Added PVE No-Subscription repository"
fi

# 3. Update system
log "Updating package lists and upgrading system..."
apt update
apt upgrade -y

# 4. Install useful packages
log "Installing additional useful packages..."
apt install -y \
    curl \
    wget \
    vim \
    htop \
    iotop \
    iftop \
    ncdu \
    tree \
    git \
    unzip \
    software-properties-common \
    apt-transport-https \
    ca-certificates \
    gnupg \
    lsb-release

# 5. Disable enterprise popup
log "Disabling enterprise subscription popup..."
PROXMOX_LIB="/usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js"
if [ -f "$PROXMOX_LIB" ]; then
    cp "$PROXMOX_LIB" "${PROXMOX_LIB}.bak"
    sed -i "s/data.status !== 'Active'/false/g" "$PROXMOX_LIB"
    systemctl restart pveproxy.service
    log "Enterprise popup disabled"
else
    warn "Proxmox library file not found, skipping popup disable"
fi

# 6. Configure automatic updates (optional)
log "Configuring automatic security updates..."
cat > /etc/apt/apt.conf.d/20auto-upgrades << EOF
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";
APT::Periodic::AutocleanInterval "7";
EOF

# 7. Create directory structure for services
log "Creating directory structure for Docker services..."
mkdir -p /docker/{transmission/{data,watch},prowlarr/config,radarr/config,bazarr/config}
mkdir -p /opt/docker/media-stack
mkdir -p /mnt/nas-library/MULTIMEDIA/{movies,Downloads/{complete,incomplete}}

# Create arr-stack user
if ! id "arr-stack" &>/dev/null; then
    adduser arr-stack --uid 1002 --disabled-password --gecos ""
    log "Created arr-stack user (UID: 1002)"
fi

# Set permissions
chown -R 1002:1002 /docker/
log "Set permissions for Docker directories"

# 8. Configure network (example - adjust as needed)
log "Network configuration template created at /tmp/interfaces.example"
cat > /tmp/interfaces.example << EOF
# Example network configuration
# Copy to /etc/network/interfaces and modify as needed

auto lo
iface lo inet loopback

# Management interface
auto vmbr0
iface vmbr0 inet static
    address 192.168.1.240/24
    gateway 192.168.1.1
    bridge-ports enp0s31f6
    bridge-stp off
    bridge-fd 0

# Optional: Additional bridge for VMs
#auto vmbr1
#iface vmbr1 inet manual
#    bridge-ports enp0s31f7
#    bridge-stp off
#    bridge-fd 0
EOF

# 9. Create backup script
log "Creating backup script..."
cat > /usr/local/bin/proxmox-backup.sh << 'EOF'
#!/bin/bash
# Simple Proxmox backup script
# Customize as needed for your environment

BACKUP_DIR="/mnt/backup"
DATE=$(date +%Y%m%d_%H%M%S)

# Create backup directory if it doesn't exist
mkdir -p "$BACKUP_DIR"

# Backup Proxmox configuration
tar -czf "$BACKUP_DIR/pve-config-$DATE.tar.gz" /etc/pve/

# Backup Docker configurations
if [ -d "/docker" ]; then
    tar -czf "$BACKUP_DIR/docker-configs-$DATE.tar.gz" /docker/
fi

# Clean old backups (keep last 7 days)
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +7 -delete

echo "Backup completed: $DATE"
EOF

chmod +x /usr/local/bin/proxmox-backup.sh
log "Backup script created at /usr/local/bin/proxmox-backup.sh"

# 10. Final steps
log "Post-install configuration completed successfully!"
log ""
log "Next steps:"
log "1. Reboot the system: 'reboot'"
log "2. Configure network settings if needed: /etc/network/interfaces"
log "3. Set up storage: Run storage-setup.sh"
log "4. Deploy services: Use docker-compose files in configs/"
log "5. Configure monitoring and backups"
log ""
log "Web interface: https://$(hostname -I | awk '{print $1}'):8006"

# Ask for reboot
read -p "Reboot now? (y/N): " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    log "Rebooting system..."
    reboot
fi

⚙️ Manual Configuration Steps¶

If you prefer manual configuration, follow these steps:

1. Storage Reconfiguration¶

Remove local-lvm and extend root partition:

# Remove local-lvm storage
lvremove /dev/pve/data

# Extend root partition
lvresize -l +100%FREE /dev/pve/root
resize2fs /dev/mapper/pve-root

2. Repository Configuration¶

Disable enterprise repositories and add no-subscription:

# Disable enterprise repos
sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list

# Add no-subscription repository
echo "deb http://download.proxmox.com/debian/pve $(lsb_release -cs) pve-no-subscription" >> /etc/apt/sources.list

# Update packages
apt update && apt upgrade -y

4. Network Configuration¶

Configure network interfaces (example for static IP):

# Edit network configuration
nano /etc/network/interfaces

Example configuration:

auto lo
iface lo inet loopback

auto vmbr0
iface vmbr0 inet static
    address 192.168.1.240/24
    gateway 192.168.1.1
    bridge-ports enp0s31f6
    bridge-stp off
    bridge-fd 0

Restart networking:

systemctl restart networking

5. Install Essential Packages¶

apt install -y curl wget vim htop iotop iftop ncdu tree git unzip

📋 Post-Configuration Checklist¶

After running the configuration:

[ ] Reboot system: reboot
[ ] Verify web access: https://your-ip:8006
[ ] Check storage: Datacenter → Storage (local should show all content types)
[ ] Update system: Node → Updates → Refresh → Upgrade
[ ] Configure backups: Set up automated backup procedures
[ ] Deploy services: Use Docker Compose stacks from configs/

🔧 Configuration Files¶

All configuration scripts and templates are available in:

Automated script: configs/scripts/post-install-setup.sh
Network template: configs/templates/network-interfaces.template
Backup script: Created at /usr/local/bin/proxmox-backup.sh

📊 Verification Commands¶

Verify your configuration:

# Check storage
df -h

# Check services
systemctl status pveproxy pvedaemon pve-cluster

# Check network
ip addr show

# Check repositories
apt update

7. Configure Storage and Repositories¶

Configure storage and repository settings:

In ‘Datacenter’ - ‘Storage’, remove ‘local-lvm’
In ‘Node’ - ‘Shell’, enter commands:

lvremove /dev/pve/data
lvresize -l +100%FREE /dev/pve/root
resize2fs /dev/mapper/pve-root

In ‘Datacenter’ - ‘Storage’, edit ‘local’ and select all options in content
Configure Repositories:

In ‘Node’ - ‘Updates’ - ‘Repositories’, select repository ENTERPRISE and PVE-ENTERPRISE and select DISABLE
In ‘Node’ - ‘Updates’ - ‘Repositories’, add repository ‘No-Subscription’
In ‘Node’ - ‘Updates’, click REFRESH and then UPGRADE
In GUI select REBOOT

8. Enable Notifications¶

Configure email notifications for system alerts:

# Via Web Interface:
# 1. Navigate to 'Datacenter' → 'Notifications'
# 2. Add a new notification target: 'SMTP'
# 3. Configure SMTP settings (server, port, authentication)
# 4. In notification handler, modify 'default-matcher':
#    - Select your SMTP notification target
#    - Unselect 'mail-to-root'

9. Trusted TLS Certificates¶

Configure Let’s Encrypt certificates for secure web access:

# Via Web Interface:
# 1. Navigate to 'Datacenter' → 'ACME'
# 2. Add ACME Account (Let's Encrypt)
# 3. Configure DNS challenge or HTTP challenge
# 4. Request certificate for your domain
# 5. Enable automatic renewal

🚨 Troubleshooting¶

Common issues and solutions:

Storage Issues - Verify LVM configuration: lvs - Check filesystem: df -h

Network Issues - Check interface status: ip link show - Verify bridge configuration: brctl show

Service Issues - Check logs: journalctl -u pveproxy - Restart services: systemctl restart pveproxy