Home

Proxmox VE System Configuration

see API restrictions

---

Required Configuration

The following commands and configurations are required:

# Download Debian LXC template (**or change OS in base/default.yml**)
pveam download local debian-12-standard_12.7-1_amd64.tar.zst && pveam update

• Ensure your storage is enabled for container content (set in config.env)

Recommended Configuration

The following commands and configurations are recommended:

# 1. Apply base system patches and defaults
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/pve/post-pve-install.sh)"

# 2. Configure regular LXC template updates
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/pve/cron-update-lxcs.sh)"

# 3. Clean and configure the repository sources
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/pve/update-repo.sh)"

# 4. Enable system time synchronization
apt install systemd-timesyncd -y && timedatectl set-ntp true

Optional Configuration

The following commands and configurations are optional, used in development accordingly:

# 1. Create passthrough mappings (test, due token restrictions, see libs/bridge)
mkdir -p /etc/pve/virtual-guest/mapping
echo 'host-device: /dev/serial/by-...' > /etc/pve/virtual-guest/mapping/....conf

# 2. Add mapping permission
pveum role add Mapping.Use -privs 'Mapping.Use'
pveum user token add root@pam git
pveum aclmod / --token 'root@pam!git' --role Mapping.Use

# 3. Install packages for exfat
apt install -y exfatprogs exfat-fuse

# 4. Create mount point for external
mkdir -p /mnt/...

/etc/fstab:

UUID=... /mnt/... exfat noauto,x-systemd.automount,x-systemd.idle-timeout=600,x-systemd.device-timeout=30,noatime,flush,uid=100000,gid=100000,dmask=027,fmask=137,nofail 0 0