Install On-Prem Platform

Search…
This guide helps you with the initial installation and deployment of our steadybit platform On-Premise. It is explicitly of use for spaces where it is not yet possible to take advantage of our Software as a Service (SaaS) platform and the need to host our platform yourself. After completing this getting started, continue by setting up steadybit​
If you are interested in using our SaaS platform, let us know and continue directly with the getting started of how to set up the platform.
Installing and deploying the steadybit platform on your servers is simple:
​Step 0 - Check Prerequisites​
​Step 1 - Get your key​
​Step 2 - Deploy Platform​
If you need help, please reach out to us.
Step 0 - Check Prerequisites
You should have already received an invitation mail for the steadybit platform where you can login with your e-mail address and a temporary password. This temporary password needs to be changed immediately at first login. After that, you see the following page which we need later on.
Get your keys
Before continuing, make sure that access to the following URLs via HTTPS (443) is possible from your location of installation:
https://docker.steadybit.io and https://index.docker.io (Docker Image)
https://artifacts.steadybit.io (Agent Linux Installation)
https://get.steadybit.io (Setup Scripts)
https://steadybit.github.io/helm-charts (when using Kubernetes and helm)
The platform itself exposes the following ports:
Port 8080: Application port for UI/API
Port 7878: Acceptor port for agents
Step 1 - Get your keys
After logging in into the steadybit platform you get access to the Agent Key. The Agent Key is needed to install the platform and connect the steadybit agents against it.
Get your keys
So, simply copy the agent key from here and use it in the next step to deploy the platform.
Step 2 - Deploy Platform
Our platform is installed as Docker container. The platform container image is available in the steadybit Docker Registry. The machine you are installing steadybit onto, must have 4 CPUs and 8 GB available memory.
Please choose one of the following deployment options:
​Step 2.1 - Kubernetes​
​Step 2.2 - Docker​
Step 2.1 - Kubernetes
It is our goal to make the installation as easy as possible for you, that's why we recommend you to use our Helm chart that takes a lot of the work out of it and only requires a few parameters from you. If you are not familiar with Helm and would like to learn more about it, check out helm's QuickStart​
Please replace the placeholder replace-with-agent-key with your agent key copied in Step 1 - Get your key and start the helm chart installation with:
helm repo add steadybit https://steadybit.github.io/helm-charts
helm repo update
helm install steadybit-platform \
  --create-namespace \
  --namespace steadybit-platform \
  --set agent.key=<replace-with-agent-key> \
  steadybit/steadybit-platform
To make it convenient for you, we have a default for everything. That's also why we include the necessary Postgres database and set up everything for you automatically. Nevertheless, feel free to adjust parameters after having a look on the helm chart in our public GitHub repository.
BE AWARE: The database is not backed up and if the pod is deleted the data is lost!
For productive usage, we strongly recommend to setup your own Postgres database and configure the steadybit platform as described here.
In case you prefer to deploy our steadybit platform using Kubernetes directly instead of the helm chart, you can find everything you need here.
See also Kubernetes for further informations about the setup with Kubernetes.
Step 2.2 - Docker
At least a Docker installation and a PostgresSQL database is required to run the platform. Please replace the placeholder agent-key with your value copied in Step 1 - Get your key. Furthermore, replace the placeholders jdbc-url, jdbc-user and jdbc-password in our one liner script with the settings of your running PostgreSQL database.
curl -sfL https://get.steadybit.io/platform.sh | sh -s -- -a <agent-key> -d <jdbc-url> -e <jdbc-user> -f <jdbc-password>
See also Docker for further informations about the setup with Docker.
What's next?
Done, the platform is running. The default login for the on-prem platform is
username: admin
password: admin
Now you can set it up by connecting the first agents to it.
We'll show you how to do that in our getting started Set up Platform & Agents, at step 1.
Productive Usage
As mentioned above, this getting started helped to set up quickly a steadybit platform.
Before using steadybit
configure your own Postgres database as described here.
we recommend to use your internal authorization services such as LDAP or OIDC provider as described here.
Advanced Configuration
More configuration options can be found in Advanced Configuration​
FAQ
Install as Docker Container
Last modified 1mo ago
Copy link
Outline
Step 0 - Check Prerequisites
Step 1 - Get your keys
Step 2 - Deploy Platform
Step 2.1 - Kubernetes
Step 2.2 - Docker
What's next?