LogoLogo
Reliability HubAPI DocsPlatform
  • Welcome to Steadybit
  • Quick Start
    • First Steps
    • Compatibility
    • Install Agent and Extensions
    • Run an Experiment
    • Deploy Example Application
  • Concepts
    • Actions
    • Discovery
    • Query Language
  • Install and Configure
    • Install Agent
      • Architecture
      • Install on Kubernetes
      • Install on Linux Hosts
      • Install using Docker Compose
      • Install on Amazon ECS
      • Extension Registration
      • Using Mutual TLS for Extensions
      • Configuration Options
      • Agent State
      • Agent API
    • Install On-Prem Platform
      • Install on Minikube
      • Advanced Agent Authentication
      • Configuration Options
      • Maintenance & Incident Support
      • Syncing Teams via OIDC Attribute
    • Manage Environments
    • Manage Teams and Users
      • Users
      • Teams
      • Permissions
    • Manage Experiment Templates
  • Use Steadybit
    • Experiments
      • Design
      • Run
      • Run History
      • Schedule
      • Variables
      • Emergency Stop
      • Share
        • Templates
        • Duplicate
        • File
      • OpenTelemetry Integration
    • Explorer
      • Landscape
      • Targets
      • Advice
    • Reporting
  • Integrate with Steadybit
    • Extensions
      • Anatomy of an Extension
      • Extension Installation
      • Extension Kits
      • Available Extensions
    • API
      • Interactive API Documentation
    • CLI
    • Badges
    • Webhooks
      • Custom Webhooks
      • Preflight Webhooks
    • Preflight Actions
    • Slack Notifications
    • Audit Log
    • Hubs
  • Troubleshooting
    • How to troubleshoot
    • Common fixes
      • Extensions
      • Agents
      • On-prem platform
Powered by GitBook

Extension Docs

  • ActionKit
  • DiscoveryKit
  • EventKit

More Resources

  • Reliability Hub
  • API Docs
On this page
  • Step 0 - Check Prerequisites
  • Step 1 - Get your keys
  • Step 2 - Deploy Platform
  • What's next?
  • Productive Usage
  • Advanced Configuration
  • Troubleshooting

Was this helpful?

Edit on GitHub
  1. Install and Configure

Install On-Prem Platform

Last updated 4 months ago

Was this helpful?

This part of the documentation is only intended in the context of a supported PoC (Proof of Concept) together with the Steadybit team. Please, to scope your PoC before continuing to evaluate the on-prem solution.

If you just want to try out Steadybit, we recommend you .

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 .

Installing and deploying the Steadybit platform on your servers is simple:

If you need help, please .

Step 0 - Check Prerequisites

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://packages.steadybit.com (Agent Linux Installation)

  • https://get.steadybit.com (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

To install the platform on-premise and connect the agents against it you need an agent key and a valid license. Get in touch with us and we will provide you an on-prem license key and an agent key.

Step 2 - Deploy Platform

In case you can't use Helm or Kubernetes at all, get in touch with us and we'll find the best solution. The platform kan be deployed without Helm and also on plain Docker hosts.

helm repo add steadybit https://steadybit.github.io/helm-charts
helm repo update
helm install steadybit-platform \
  --create-namespace \
  --namespace steadybit-platform \
  --set platform.tenant.agentKey=<replace-with-agent-key> \
  --set platform.tenant.license=<replace-with-license-key> \
  steadybit/steadybit-platform

BE AWARE: The database is not backed up and if the pod is deleted the data is lost!

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.

Productive Usage

As mentioned above, this getting started helped to set up quickly a Steadybit platform.

Before using Steadybit

Advanced Configuration

Troubleshooting

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

Please replace the placeholders replace-with-agent-key and replace-with-license-key with your agent key and license key of :

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 .

For productive usage, we strongly recommend to setup your own Postgres database and configure the Steadybit platform as described .

We'll show you how to do that in our getting started , at step 1.

configure your own Postgres database as .

we recommend to use your internal authorization services such as LDAP or OIDC provider as .

More configuration options can be found in

If you have any problems, check our page. Or please .

helm's QuickStart
GitHub repository
here
Set up Platform & Agents
Advanced Configuration
Troubleshooting
reach out to us
book an appointment
sign up for our SaaS platform
setting up Steadybit
reach out to us
Step 0 - Check Prerequisites
Step 1 - Get your keys
Step 2 - Deploy Platform
Step 1 - Get your keys
described here
described here