Proxmox Node Setup¶

This guide covers installing Proxmox Virtual Environment (PVE) on your first TAPPaaS node, referred to as "tappaas1".

Prerequisites¶

Before starting:

• Hardware prepared per Hardware Selection
• Proxmox VE ISO downloaded and bootable USB created
• Network design documented per Preparation
• Root password ready

Installation¶

Boot and Install¶

1. Insert the Proxmox VE bootable USB
2. Boot from USB and select "Install Proxmox VE"
3. Accept the license agreement
4. Select the target disk for installation

Configuration During Install¶

Configure the following during installation:

Complete Installation¶

1. Set a strong root password
2. Provide an administrator email address
3. Review settings and confirm installation
4. Reboot when prompted and remove the USB drive

Post-Installation¶

Access Web Interface¶

After reboot, access the Proxmox web interface:

https://10.0.0.10:8006

Login with: - Username: root - Password: Your configured password - Realm: Linux PAM standard authentication

Run TAPPaaS Setup Script¶

Execute the post-installation script from the Proxmox shell:

REPO="https://raw.githubusercontent.com/TAPPaaS/TAPPaaS/"
BRANCH="main"
curl -fsSL ${REPO}${BRANCH}/src/foundation/05-ProxmoxNode/install.sh | bash

This script configures foundational settings for TAPPaaS.

Cluster Creation¶

On the first node only, create the cluster:

pvecm create TAPPaaS

Storage Configuration¶

Create ZFS Pool¶

For data storage, create a ZFS pool named "tanka1":

Via GUI:

1. Navigate to Datacenter → tappaas1 → Disks → ZFS
2. Click Create: ZFS
3. Configure:
4. Name: tanka1
5. RAID Level: Mirror (minimum 2 disks)
6. Select available disks

Via CLI:

# For mirrored pool (2 disks)
zpool create tanka1 mirror /dev/sdb /dev/sdc

# For RAIDZ1 (3+ disks)
zpool create tanka1 raidz /dev/sdb /dev/sdc /dev/sdd

Wipe Existing Partitions¶

If disks have existing data:

# Check disk status
lsblk

# Wipe disk (replace sdX with actual device)
wipefs -a /dev/sdX

Network Configuration¶

Verify Bridge Configuration¶

Ensure the network bridge is configured:

cat /etc/network/interfaces

You should see vmbr0 configured with your management IP.

Prepare for Firewall¶

The network will be reconfigured when installing the Firewall. The bridge will be renamed from vmbr0 to lan.

Verification¶

Confirm successful installation:

# Check Proxmox version
pveversion

# Check cluster status
pvecm status

# Check ZFS pool
zpool status tanka1

# Check network
ip addr show vmbr0

Troubleshooting¶

Cannot Access Web Interface¶

• Verify IP configuration: ip addr
• Check firewall: pve-firewall status
• Ensure port 8006 is not blocked

ZFS Pool Creation Fails¶

• Verify disks are not in use: lsblk
• Wipe existing partitions: wipefs -a /dev/sdX
• Check for existing ZFS pools: zpool import

Next Steps¶

Proceed to Firewall installation before adding additional nodes.