Skip to content

Before you install

The quick start has three pages:

  1. Before you install (this page): check the host, get HAGISTACK, write the configuration file
  2. Install: preflight, all-in-one, status, Horizon sign-in
  3. Your first VM: create a VM, floating IP, SSH, stop, start and delete

It is written for OpenStack beginners who know basic Linux. It builds an all-in-one host.

Use one freshly installed Rocky Linux 10.2 (x86_64) host.

  • Other EL10 distributions (RHEL, AlmaLinux, CentOS 10) continue with a warning and are not verified. Other operating systems and architectures are refused.
  • Work as a user who can become root with sudo.
  • systemd is required.
Item Requirement Notes
Memory 8 GB or more Preflight warns below about 7 GB
Disk 20 GB or more free on / The verified all-in-one node had 60 GB
Virtualisation a readable /dev/kvm Without it, qemu software emulation is used, 10–50× slower
NICs a management NIC, and an existing interface to name as the provider NIC The provider NIC is not attached to the bridge (see below)
Host name a distinct short host name per node Used as the Nova host name and the OVN chassis name
Clock synchronised (chronyd or similar)
Internet access GitHub, EPEL 10, CentOS NFV SIG, RDO dependency repositories, CirrOS see below

Check hardware virtualisation:

Terminal window
ls -l /dev/kvm
grep -cE 'vmx|svm' /proc/cpuinfo

KVM is usable if /dev/kvm exists and the second command prints 1 or more. On a cloud VM, nested virtualisation must be enabled (on GCE, for example, a machine type and option that support it).

The installer adds these sources and downloads from the internet:

  • https://github.com/hagix9/hagistack/releases/download/ (the HAGISTACK RPMs, about 108 MB)
  • EPEL 10 (it also enables CRB)
  • the CentOS Stream 10 NFV SIG (Open vSwitch and OVN)
  • RDO’s EL10 third-party dependency repositories (Python libraries, RabbitMQ/Erlang)
  • download.cirros-cloud.net (the first guest image; not needed with --image-file)

3. Understand the management and provider networks

Section titled “3. Understand the management and provider networks”

HAGISTACK deals with three networks.

Network Role Settings
Management network OpenStack APIs, database, messaging, traffic between nodes. Horizon opens at this address too management IP (--mgmt-ip; default: the source address of the route to 8.8.8.8)
Provider network the external network hagistack-provider; floating IPs come from it --provider-cidr, --provider-gateway, --floating-start, --floating-end
Tenant network the private network hagistack-tenant VMs attach to --tenant-cidr (default 10.10.10.0/24)

This guide uses these example values:

Item Example
Management IP 192.0.2.10
Provider NIC eth1
Provider CIDR 198.51.100.0/24
Provider gateway 198.51.100.1
Floating-IP range 198.51.100.100 to 198.51.100.200

Clone the release tag rocky10.2-rpms-2026.1:

Terminal window
sudo dnf -y install git
git clone --branch rocky10.2-rpms-2026.1 https://github.com/hagix9/hagistack.git
cd hagistack/rocky10.2

The tag contains rpm-release.lock. The installer checks the downloaded RPMs against the SHA-256, size and RPM-set identity pinned in it. Checkouts older than the tag pin no release, and the default source (github) stops.

Settings come from the command line or a configuration file; the command line wins. The file is looked for as ./hagistack.env, then hagistack.env next to the script, then /etc/hagistack/hagistack.env.

Create hagistack/rocky10.2/hagistack.env (replace the values with yours):

Terminal window
cat > hagistack.env <<'EOF'
# RPM_SOURCE=github is the default (the published release)
EXT_NIC=eth1
PROVIDER_CIDR=198.51.100.0/24
PROVIDER_GATEWAY=198.51.100.1
FLOATING_START=198.51.100.100
FLOATING_END=198.51.100.200
EOF
  • Only KEY=VALUE lines, blank lines and # comments are allowed. The file is parsed, never executed.
  • Do not put passwords in it. HAGISTACK generates the passwords.
  • Environment variables are not read.

The main settings:

Option Key Required Default
--ext-nic NAME EXT_NIC all-in-one, controller —
--provider-cidr CIDR PROVIDER_CIDR all-in-one, controller —
--provider-gateway IP PROVIDER_GATEWAY all-in-one, controller —
--floating-start IP FLOATING_START all-in-one, controller —
--floating-end IP FLOATING_END all-in-one, controller —
--mgmt-ip IP MGMT_IP autodetected
--tenant-cidr CIDR TENANT_CIDR 10.10.10.0/24
--dns-server IP DNS_SERVER the provider gateway
--virt-type kvm|qemu VIRT_TYPE from /dev/kvm
--image-file PATH IMAGE_FILE — (use a local image instead of downloading)

Every setting is listed under “Configuration” in rocky10.2/README.md.

Next: Install.