Contains scripts to set up a new ProxMox Debian server.
Find a file
2025-08-14 20:22:22 -05:00
bootstrap.sh Fixed whiptail dependency in the bootstrap with a failover. 2025-08-14 03:27:51 -05:00
kuma-checks.json Update kuma-checks.json 2025-08-01 03:37:08 -05:00
kuma-push.sh Update kuma-push.sh 2025-08-01 16:16:42 -05:00
README.md replaced neofetch with fastfetch 2025-08-14 20:22:22 -05:00
setup.sh replaced neofetch with fastfetch 2025-08-14 20:22:22 -05:00

Proxmox Debian VM Bootstrap Wizard

A simple, interactive bootstrap for freshly cloned Debian VMs on Proxmox.
It uses a twostage approach:

  1. Bootstrap script (stored as setup.sh on your VM template)
    • Prompts for root if needed
    • Downloads and runs the latest interactive wizard
  2. Remote setup wizard (pulled from Git)
    • Menudriven (whiptail) configuration: updates, sudo, hostname, SSH keys, aliases, fastfetch, CIFS mounts, etc.

Prerequisites

  • Debianbased VM template
  • Network access to git.jordanwages.com
  • whiptail (autoinstalled if missing)
  • Either curl or wget

Installation

  1. Invoke remotely
    On your Debian template, run the following command:

    curl -s https://git.jordanwages.com/wagesj45/proxmox-server-setup/raw/branch/main/bootstrap.sh | bash
    
  2. Follow the wizard Use the onscreen menus to:

    • Grant sudo to selected users
    • Apply system updates
    • Set a new hostname
    • Add SSH keys for root & your primary user
    • Install core & optional utilities (htop, jq, git, etc.)
    • Configure NFS mounts for your NAS shares

Customization

  • Default SSH key Edit the DEFAULT_SSH_KEY variable in the remote setup.sh to your own public key.

  • Optional packages Tweak the TOOLS=(…) array in the remote script to add or remove utilities.

  • NFS shares Adjust the NFS_HOSTS=(…) array to match your NAS hostnames.


Troubleshooting

  • Fetch failures Ensure network connectivity and that curl or wget is installed.

  • Rerunning Simply invoke:

    sudo setup.sh
    

    again to repeat the wizard.

  • Manually inspect If a step errors out, inspect the console output for hints.