TAPPaaS

Install a single node local TAPPaaS system

One machine, one disk, one network port, and a Mac or Linux PC beside it on the same wired network. More machines, data disks, switches, Wi-Fi and going public can be added later. What each step does, in more depth: Appendix E.

What you need

The machine

In addition

0. Prepare the Mac or PC

The script needs curl, Docker on a Mac, and dnsmasq for the network boot. On a Mac, with Homebrew:

brew install colima docker dnsmasq && colima start

On Debian or Ubuntu (no Docker needed):

sudo apt install curl dnsmasq

1. Build the installer and start the install

In an empty directory:

curl -fsSL "https://codeberg.org/TAPPaaS/TAPPaaS/raw/branch/main/src/foundation/cluster/bootstrap-tappaas.sh" -o bootstrap-tappaas.sh && chmod +x bootstrap-tappaas.sh
./bootstrap-tappaas.sh

It asks everything first, then runs without questions:

It downloads the Proxmox VE ISO, builds an installer that asks nothing, and writes or serves it. Keep the script's window open: it waits for the machine.

2. Boot the machine

With its network cable connected, boot it from the stick or from the network (its boot menu is often F11, F12 or Esc). Proxmox installs by itself and reboots; take the stick out.

The script finds the machine and runs the TAPPaaS install on it, its log scrolling in the window (and kept in bootstrap-tappaas-<date>.log). If the window closes, run the script again and choose 3 to follow it. It ends with the console's address, such as http://192.168.1.41:9097/setup/day1, and how to show the access token.

3. Day 1 in the console

Open the address from the same network and enter the token. Do the steps in order:

  1. Finish the first node's setup: LAN port This machine alone; disks Boot pool only.
  2. Add more nodes: No more machines.
  3. The admin VPN: enrol this computer and import the WireGuard file it gives you. It is your way in from now on.
  4. Rest of foundation: choose your sign-in password and start it. It installs sign-in, logging and the backup placeholder, then creates your organisation and you.
  5. Status and health checks: when all is well the page says you have a working system.

Then add an application stack (Day 2) to make the system useful.

What one machine means