Server Foundation is an image factory for standardized, versioned server images.
The first supported images are Ubuntu 24.04 LTS base and production cloud images. The repository is structured so future profiles can add Docker hosts, CyberPanel prerequisites, WordPress, Kubernetes nodes, CI runners, developer images, and additional operating systems without renaming or reorganizing the project.
- Base profile:
ubuntu-24.04-base(version0.1.0) - Production profile:
ubuntu-24.04-production(version0.2.0) - CyberPanel profile:
ubuntu-24.04-cyberpanel(version0.1.0) - Web Server profile:
ubuntu-24.04-webserver(version0.1.0) - Docker profile:
ubuntu-24.04-docker(version0.1.0) - OS: Ubuntu 24.04 LTS
- Artifact: QCOW2
- Builder: Packer + QEMU
The base image includes cloud-init, SSH, qemu guest agent, unattended security updates, UFW, and Fail2Ban. The production image adds persistent logging, auditd, and cloud-safe sysctl hardening. The CyberPanel profile sets up pre-requisites and an unattended first-boot autoinstall service for CyberPanel. The Web Server profile sets up Nginx and configures public HTTP/HTTPS ports. The Docker profile installs the official Docker Engine and Docker Compose plugins with secure logging rotation and live-restore configurations.
Install the host tools, then run:
make doctor
make init
make validate
make build
make testTo run and interact with the built VM console locally:
GUI=1 ./scripts/run-vm.sh artifacts/ubuntu-24.04-base/ubuntu-24.04-base.qcow2- GUI Console Login (on-screen TTY): Log in directly using Username
ubuntuand Passwordubuntu. - SSH Remote Login: Password authentication is disabled by default SSH hardening. Access the VM using the auto-generated SSH key:
ssh -i build/run-vm/id_ed25519 -p 2222 ubuntu@127.0.0.1
To build the production image:
make validate IMAGE=ubuntu-24.04-production PROFILE=profiles/production.yaml
make build IMAGE=ubuntu-24.04-production PROFILE=profiles/production.yaml
make test IMAGE=ubuntu-24.04-production PROFILE=profiles/production.yaml
make inspect IMAGE=ubuntu-24.04-production PROFILE=profiles/production.yamlTo build the Docker host image:
make validate IMAGE=ubuntu-24.04-docker PROFILE=profiles/ubuntu-24.04-docker.yaml
make build IMAGE=ubuntu-24.04-docker PROFILE=profiles/ubuntu-24.04-docker.yaml
make test IMAGE=ubuntu-24.04-docker PROFILE=profiles/ubuntu-24.04-docker.yaml
make inspect IMAGE=ubuntu-24.04-docker PROFILE=profiles/ubuntu-24.04-docker.yamlThe generated image is written to:
artifacts/ubuntu-24.04-base/ubuntu-24.04-base.qcow2
Do not deploy unversioned latest images in production. Treat image versions like software releases and pin deployments to a known profile version.
images/ image-specific notes and future per-image files
modules/ reusable provisioning modules
packer/ Packer templates
profiles/ image recipes
scripts/ local helper scripts
tests/ boot and acceptance tests
docs/ architecture, security, and platform docs
