Linux install

This page describes StackState version 4.1.

The StackState 4.1 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.1 version range to upgrade to a more recent release.

Go to the documentation for the latest StackState release.

StackState prefers Kubernetes! In the future we will move away from Linux support. Read about installing StackState on Kubernetes.

StackState can be installed either with Linux packages on one or two Linux machines or with Helm on a Kubernetes cluster.

Choosing your installation type

Before setting up StackState, you need to choose whether you want to run StackState in Development, POC, or Production mode.

  • Development setup: requires only one machine, but will be limited to 1000 components/relations per view, due to the limited setup. This is recommended for small trials.

  • POC setup: used for bigger installations, giving almost the same power as production, but is not suited for processing perpetual data streams.

  • Production setup: used when bringing StackState to production or when the other environments are too limiting.


Before starting the installation, ensure your system(s) meet the StackState installation requirements.


There is an RPM package available that provides easy installation and upgrade of StackState on Fedora, Red Hat or CentOS. For Debian and Ubuntu, there is a DEB package available. Packages can be obtained from our distribution website.


StackState supports three different installation configurations:

  • Production setup suitable for production use.

  • Proof-of-concept (POC) setup suitable for proof of concepts. This is not suited for processing perpetual data streams.

  • Development setup suitable for a pilot or demo. This setup can deal with limited amounts of topology (max 1000 components/relations per view).


To upgrade your StackState installation, see the instructions in our upgrading guide.


StackState provides Role Based Access Control functionality that works with LDAP authentication servers. See RBAC pages for more information on the topic. You can also find how to configure LDAP servers.

StackState also supports authentication against a KeyCloak OIDC Authentication server. Find out how to configure a KeyCloak OIDC Authentication server.


If you have any issues installing StackState, refer to our troubleshooting guide or contact our technical support.

Last updated