Getting started with Warewulf Pro

This guide walks you through enabling Warewulf Pro entitlement on a freshly-provisioned server and installing the core components: the Warewulf server, the web interface, the Pro overlays, and Apptainer.

For everything that comes after - configuring the server, building images, provisioning nodes - see the upstream Warewulf documentation.

Prerequisites

• A Rocky Linux 9 server (physical or virtual). Other Enterprise Linux 9 distributions also work.
• Network access from the server to CIQ Depot (or a local Depot mirror for air-gapped environments).
• A CIQ Portal account with Warewulf Pro entitlement. If you don't have access, contact csm-help@ciq.com.

Step 1 - Enable the Warewulf Pro repository

The depot command-line utility configures the CIQ Depot repositories on your server. If depot is not yet installed, follow the Depot client installation guide.

Once depot is installed, log in and enable Warewulf Pro:

# depot login
# depot enable warewulf-pro

Step 2 - Install the packages

With the repository enabled, install Warewulf Pro and enable its services. The connected-server path is covered step by step in Standard install via Depot; the one-shot install is:

# dnf -y install warewulf warewulf-cockpit apptainer cockpit "warewulf-overlays-*"
# systemctl enable --now warewulfd cockpit.socket

The Warewulf web interface is then available at https://<your-server>:9090/warewulf. For the connected and air-gapped install paths and the full package breakdown, see Installation.

Step 3 - (Optional) Import Pro node images

If you plan to use Pro's turn-key node images (OpenHPC, Slurm, OpenPBS, Fuzzball Substrate), import them with wwctl. See Pro node images for the full catalog and the import commands.

What's next

• Configure the Warewulf server - set warewulf.conf, configure DHCP/TFTP, and provision your first node. The upstream Warewulf documentation covers all of this in depth.
• Set up the web interface - see Web interface for API token configuration and Cockpit integration.
• Build your own images - community Warewulf documentation has a complete Containerfile-and-CI workflow guide.