Skip to content

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

Server Foundation

Server Foundation is an image factory for standardized, versioned server images.

Server Foundation Status Page

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.

Current Image

  • Base profile: ubuntu-24.04-base (version 0.1.0)
  • Production profile: ubuntu-24.04-production (version 0.2.0)
  • CyberPanel profile: ubuntu-24.04-cyberpanel (version 0.1.0)
  • Web Server profile: ubuntu-24.04-webserver (version 0.1.0)
  • Docker profile: ubuntu-24.04-docker (version 0.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.

Quick Start

Install the host tools, then run:

make doctor
make init
make validate
make build
make test

To 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 ubuntu and Password ubuntu.
  • 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.yaml

To 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.yaml

The 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.

Repository Layout

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

Documentation

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages