Contains scripts to set up a new ProxMox Debian server.
bootstrap.sh | ||
kuma-checks.json | ||
kuma-push.sh | ||
README.md | ||
setup.sh |
Proxmox Debian VM Bootstrap Wizard
A simple, interactive bootstrap for freshly cloned Debian VMs on Proxmox.
It uses a two‑stage approach:
- Bootstrap script (stored as
setup.sh
on your VM template)- Prompts for root if needed
- Downloads and runs the latest interactive wizard
- Remote setup wizard (pulled from Git)
- Menu‑driven (
whiptail
) configuration: updates, sudo, hostname, SSH keys, aliases, fastfetch, CIFS mounts, etc.
- Menu‑driven (
Prerequisites
- Debian‑based VM template
- Network access to
git.jordanwages.com
whiptail
(auto‑installed if missing)- Either
curl
orwget
Installation
-
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
-
Follow the wizard Use the on‑screen 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
- Grant
Customization
-
Default SSH key Edit the
DEFAULT_SSH_KEY
variable in the remotesetup.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
orwget
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.