Skip to content

Getting Started

Before you can do anything, you need to get the code. Because we've sold our soul to the submodule devil, you're going to need to recursively clone the repo into your location.


Throughout the all our documentation and examples the genestack code base will be assumed to be in /opt.

git clone --recurse-submodules -j4 /opt/genestack

Basic Setup

The basic setup requires ansible, ansible collection and helm installed to install Kubernetes and OpenStack Helm:

The environment variable GENESTACK_PRODUCT is used to bootstrap specific configurations and alters playbook handling. It is persisted at /etc/genestack/product` for subsequent executions, it only has to be used once.

export GENESTACK_PRODUCT=openstack-enterprise



If running this command with sudo, be sure to run with -E. sudo -E /opt/genestack/ This will ensure your active environment is passed into the bootstrap command.

Once the bootstrap is completed the default Kubernetes provider will be configured inside /etc/genestack/provider