← Back to projectsPROJECT / SOURCE NOTES

Proxmox & Docker

A collection of interactive shell scripts for preparing Debian-based hosts, Proxmox VE 8, and Docker environments.

  • Linux
  • Shell
  • Docker

Making host setup explicit

This repository groups the setup of a Debian-based host into separate shell scripts. The files cover an initial host setup, a second Proxmox installation stage, SDN setup, and Docker installation.

Rather than hiding every step behind one command, the workflow includes manual checkpoints. In particular, the initial script opens network and host configuration files for editing.

What the scripts contain

The initial stage installs common utilities, configures a local catcher user for sudo, appends an expected public SSH key, and prepares the Proxmox repository. It also installs the default Proxmox kernel and requests a reboot.

The Docker script configures Docker’s Debian package repository and installs Docker Engine, containerd, buildx, and the Compose plugin. It adds the configured local user to the Docker group and enables the associated services.

initial-setup-v0.01.sh
proxmox-part-2-v0.01.sh
proxmox-sdn-v0.01.sh
docker-v0.01.sh

Assumptions are part of the interface

These are host-specific setup scripts, not a universal installer. They expect root access, Debian-style package management, particular filesystem paths, and a local user named catcher. Some steps change networking, package repositories, or installed packages and may restart the host.

The filenames and README do not agree on every instruction. Read the current script before considering any use, and adapt it to an isolated test host first. No setup scripts are executed by this website.

A practical systems notebook

The project is useful as a concrete record of infrastructure decisions: which packages are needed, where manual input belongs, and which assumptions should become configurable in a future iteration.