Chapter 1. Installation

Since OpenCHAMI is composable and adaptable, it can be installed and deployed in a variety of ways: bare-metal, via Docker/Docker Compose, via Podman Quadlets, and even Kubernetes. This page provides an index to some of them.

1.1. Deployment Recipes

The OpenCHAMI organization maintains a Git repository containing deployment recipes used by various sites. It is ever-evolving, but currently it has recipes for Docker Compose, Podman Quadlets, and Helm for Kubernetes.

1.2. Release RPM

There is also an official release Git repository that houses an RPM package that installs OpenCHAMI services as Podman Quadlets and installs configuration files in standard filesystem locations. It is meant to be a “quickstart for quadlets” on Red Hat systems since, by installing the package and running an additional command, it configures and starts a base OpenCHAMI installation that is ready to boot nodes.

Currently, only RPM is supported and there is only one package that contains all of the necessary services. This is obviously not very composable, so future work entails supporting more packaging options. Contributions are welcome!

To fill any gaps, the deployment recipes repository mentioned above is a good starting point.

1.3. Deployment Guide Index

Here is an index of common OpenCHAMI deployment strategies with links to guides/resources:

  • Docker Compose (Quickstart) – Use Docker Compose to quickly get started with OpenCHAMI by setting up base services.
  • Podman Quadlets (Release RPM) – Use the OpenCHAMI release RPM to run OpenCHAMI services using Podman Quadlets.
  • Libvirt Virtual Machines – Boot Libvirt VMs using OpenCHAMI and Podman Quadlets.