Before you install
The quick start has three pages:
- Before you install (this page): check the host, get HAGISTACK, write the configuration file
- Install: preflight,
all-in-one,status, Horizon sign-in - 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.
1. Prepare Rocky Linux 10.2
Section titled “1. Prepare Rocky Linux 10.2”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.
2. Check CPU, memory, disk and NICs
Section titled “2. Check CPU, memory, disk and NICs”| 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:
ls -l /dev/kvmgrep -cE 'vmx|svm' /proc/cpuinfoKVM 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 |
4. Get HAGISTACK from the release tag
Section titled “4. Get HAGISTACK from the release tag”Clone the release tag rocky10.2-rpms-2026.1:
sudo dnf -y install gitgit clone --branch rocky10.2-rpms-2026.1 https://github.com/hagix9/hagistack.gitcd hagistack/rocky10.2The 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.
5. Write the configuration file
Section titled “5. Write the configuration file”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):
cat > hagistack.env <<'EOF'# RPM_SOURCE=github is the default (the published release)EXT_NIC=eth1PROVIDER_CIDR=198.51.100.0/24PROVIDER_GATEWAY=198.51.100.1FLOATING_START=198.51.100.100FLOATING_END=198.51.100.200EOF- Only
KEY=VALUElines, 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.