https://step.dev/knowledgebase/31/categories/installation/ Recent content in Installation on Step Documentation Hugo -- gohugo.io en Fri, 21 Nov 2025 14:00:00 +0000 https://step.dev/knowledgebase/31/setup/download/ Wed, 25 Sep 2024 00:00:00 +0000 https://step.dev/knowledgebase/31/setup/download/ This page provides an overview of the available downloads for the various Step components. Step CLI The Step CLI (Command Line Interface) provides an interface for building, executing, and deploying automation packages within Step. CLI for Step Open Source The CLI of Step Open Source can be downloaded from the GitHub releases page of Step. Following binaries are available, depending on your platform: Windows: step.exe Linux and Mac: step After download, put the executable corresponding to your platform in your PATH. https://step.dev/knowledgebase/31/setup/installation/kubernetes/chart-configuration-samples/ Fri, 19 Apr 2024 14:00:00 +0000 https://step.dev/knowledgebase/31/setup/installation/kubernetes/chart-configuration-samples/ This page provides practical configuration examples for common Step Helm chart deployment scenarios. For a complete reference of all available Helm values and their detailed descriptions, please refer to the Helm Values documentation. Additional Resources: Access enterprise download section - For obtaining access to Step Enterprise artifacts and Docker images Release notes of the Helm Chart - Latest chart versions and changelog Database configuration Step supports two database backends: MongoDB (default) and PostgreSQL. https://step.dev/knowledgebase/31/setup/requirements/ Mon, 29 Nov 2021 14:08:01 +0100 https://step.dev/knowledgebase/31/setup/requirements/ On-premise requirements Below is a list of minimal hardware, system, and software requirements to set up Step. The specified versions of third-party software correspond to the ones officially tested and supported. Step Controller Step DB per Step Agent OS Redhat, SLES, Debian, Windows 7 to 10, Windows Server 2012 to 2022 Redhat, SLES, Debian, Windows 7 to 10, Windows Server 2012 to 2022 Redhat, SLES, Debian, Windows 7 to 10, Windows Server 2012 to 2022 Software: Oracle/Hotspot JDK 21 to 25 installed MongoDB 5. https://step.dev/knowledgebase/31/setup/installation/binaries/quick-setup/ Wed, 13 Feb 2019 12:52:31 +0100 https://step.dev/knowledgebase/31/setup/installation/binaries/quick-setup/ The goal of this guide is to get your first Step cluster running in minutes. After this you can follow our additional tutorials to learn how to create and deploy your first distributed automation scripts (called “Keywords”) on this freshly created cluster. Step SaaS and Step on-prem Step is available in different versions as described in Step pricing. Since we already prepared everything for you in the full-serviced SaaS solution, the easiest way to start using Step is to follow the Getting started with Step SaaS. https://step.dev/knowledgebase/31/setup/installation/kubernetes/agent-runtime-images/ Fri, 21 Nov 2025 14:00:00 +0000 https://step.dev/knowledgebase/31/setup/installation/kubernetes/agent-runtime-images/ Exense provides official agent runtime Docker images that serve as the execution environment for Step agents. These images are required starting with Helm Chart 1.2.0 and Step 27+. See the Chart release note page for details. If the official images do not meet your needs, you can build your own. See Creating your own Step Agent images. Available images The latest tag is always available for each image and always points to the most recent version. https://step.dev/knowledgebase/31/setup/installation/binaries/ Tue, 25 Oct 2022 06:08:01 +0100 https://step.dev/knowledgebase/31/setup/installation/binaries/ This section groups the technical documentation to install Step on-premise based on the archive distribution. For a quick setup it is recommended to start with the Quick setup guide. More details are available in the component installation guides listed below. It is recommended to install the components in following order: Database installation Controller installation Agent(s) installation https://step.dev/knowledgebase/31/setup/installation/kubernetes/ Tue, 25 Oct 2022 06:08:01 +0100 https://step.dev/knowledgebase/31/setup/installation/kubernetes/ This page aims to guide you through the process of installing Step in a Kubernetes environment using the official Helm chart and Docker images of Step. The Docker images and Helm charts are part of Step Enterprise and are only accessible to customers having access to the enterprise registry. As the Step Docker images are not published in a public Docker repository, this page will also explain how to download them and to store them into your company’s private repository. https://step.dev/knowledgebase/31/setup/download/material_request/ Mon, 29 Nov 2021 14:08:01 +0100 https://step.dev/knowledgebase/31/setup/download/material_request/ Enterprise customer credentials Enterprise customers receive their credentials to access to the Step Enterprise artifacts (Enterprise release, Docker images and Helm Chart) from the Step support upon request. Main point of contact for any issue related to access request is support@exense.ch. Nexus and Docker private repository Nexus access Step Enterprise artifacts are now published to our Nexus in the ‘distribution’ repository. The Enterprise repository can be accessed via https, preferably using a Web browser at https://nexus-enterprise. https://step.dev/knowledgebase/31/setup/installation/binaries/dbinstall/ Thu, 28 Feb 2019 14:08:01 +0100 https://step.dev/knowledgebase/31/setup/installation/binaries/dbinstall/ MongoDB This page contains information on installing and configuring MongoDB to be used with Step. Supported version We do support MongoDB version starting from 4.0.x up to 5.0.x. Installation Follow instructions at : MongoDB documentation Configuration If you want to tune your MongoDB instance, you will find all necessary information on the official website at : MongoDB configuration and maintenance. Activate authentication (optional) For activating the authentication between the controller and the MongoDB server, the following actions have to be taken: https://step.dev/knowledgebase/31/releasestrategy/chart-release/ Tue, 14 Oct 2025 00:00:00 +0000 https://step.dev/knowledgebase/31/releasestrategy/chart-release/ Overview The Step Helm Chart is versioned independently from the Step platform itself. This separation allows for chart-specific improvements, Kubernetes compatibility updates, and configuration enhancements without requiring Step platform upgrades. Versioning Scheme The Helm Chart follows semantic versioning with the format: MAJOR.MINOR.PATCH Major version: Breaking changes or significant architectural changes Minor version: New features and enhancements Patch version: Bug fixes and minor improvements Chart Compatibility Matrix The Helm Chart version must be compatible with your Step version. https://step.dev/knowledgebase/31/setup/installation/kubernetes/create-custom-agent-image/ Fri, 19 Apr 2024 14:00:00 +0000 https://step.dev/knowledgebase/31/setup/installation/kubernetes/create-custom-agent-image/ That page aims to guide through the process of creating your own Step Agent images. Currently, only Linux systems are supported, so below explanation / examples assumes your base Docker image is a Linux based one, such as Debian. Before building a custom image, consider whether the official Step agent runtime images already meet your needs. Step provides ready-to-use runtime images including Java, browsers, and WebDrivers. For the full list of available images, see Agent Runtime Images. https://step.dev/knowledgebase/31/whatsnew/release-notes-chart/ Wed, 03 Jul 2019 06:27:34 +0100 https://step.dev/knowledgebase/31/whatsnew/release-notes-chart/ The Helm Chart of Step is versioned independently of Step itself. This page contains the release notes of the Helm Chart. For the release notes of Step refer to Release notes Major release 1.5.0 New features Support Grid Proxy file caching (only available from Step 31+): the Grid Proxy now caches the files it downloads from the primary grid and re-serves them to the local agents, avoiding repeated high-latency downloads from the primary cluster. https://step.dev/knowledgebase/31/setup/installation/binaries/controllerinstall/ Thu, 28 Feb 2019 14:08:01 +0100 https://step.dev/knowledgebase/31/setup/installation/binaries/controllerinstall/ This page contains information on installing and configuring the Step Controller. Prerequisites Step requires at least Java 21 installed on your machine to run. Depending on your platform, make sure to install at least the Java JDK 21 on the machine(s) running Step component(s). Binaries download The latest version of the Community Edition of the Step controller can be downloaded from our Github repository at : Step. The latest version of the Enterprise Edition of the Step controller can be downloaded from our Nexus repository by enterprise customers at : Step Enterprise (Refer to Material request if you haven’t received your access yet) https://step.dev/knowledgebase/31/releasestrategy/docker-image-release/ Tue, 14 Oct 2025 00:00:00 +0000 https://step.dev/knowledgebase/31/releasestrategy/docker-image-release/ Overview Step provides official Docker images for Step components, enabling containerized deployments in Docker, Kubernetes, and other container orchestration platforms. These images are versioned to match the Step platform version they contain. Image Repositories Official Step Docker images are available from the Exense Docker registry at docker.exense.ch/step-enterprise. These images include: Step Controller: The main Step controller application Step Agent: The Step agent for executing keywords Step Grid Proxy: The grid proxy component Starting with Step 31, the Step CLI is also released as a Docker image for both editions, see Step CLI images below. https://step.dev/knowledgebase/31/setup/installation/binaries/agentinstall/ Thu, 28 Feb 2019 14:08:01 +0100 https://step.dev/knowledgebase/31/setup/installation/binaries/agentinstall/ This page explains how to install, configure and run a Step agent. Installation Java agent The Step agent requires at least Java 21 installed in order to run. Depending on your platform, make sure to install at least Java JDK 21 on the machine(s) running Step component(s). The latest version of the Community Edition of the Step agent can be downloaded from our Github repository at : Step. The latest version of the Enterprise Edition of the Step agent can be downloaded from our Nexus repository by enterprise customers at : Step Enterprise (credentials are provided upon requests) https://step.dev/knowledgebase/31/admindocs/maintenance/migration-chart/ Thu, 28 Feb 2019 14:08:01 +0100 https://step.dev/knowledgebase/31/admindocs/maintenance/migration-chart/ The Helm Chart of Step is versioned independently of Step itself. This page contains information related to the upgrade of the Helm chart of Step itself. For the upgrade of Step refer to Upgrade / Migration General migration process Migration to a newest version of the Chart usually requires nothing more than a Helm upgrade, unless some specific migration tasks are mentioned on that page. For instance, upgrading from version 0. https://step.dev/knowledgebase/31/setup/installation/kubernetes/helmvalues/ Fri, 19 Apr 2024 14:00:00 +0000 https://step.dev/knowledgebase/31/setup/installation/kubernetes/helmvalues/ Helm values Values that could be used are listed below. Note that the listed values applies to the latest Chart version, some of them might not be available in previous versions. Image parameters Name Description Default value image.repository Controller and Agent images repository base name "" image.pullPolicy Controller and Agent images pull policy Always imagePullSecrets Registry secret names as an array [] Commons parameters Name Description Default value commons.version Step version to use 3. https://step.dev/knowledgebase/31/setup/ Tue, 30 Jul 2024 00:00:00 +0000 https://step.dev/knowledgebase/31/setup/ This section includes information on how to set up Step and get it running. https://step.dev/knowledgebase/31/setup/installation/ Mon, 29 Jul 2024 00:00:00 +0000 https://step.dev/knowledgebase/31/setup/installation/ This section groups the technical documentation related to the installation of Step on-premise. Step on-premise can be installed manually based on the archive distribution or deployed on Kubernetes with Helm. For the provisioning of a SaaS cluster follow the Step SaaS quick setup guide https://step.dev/knowledgebase/31/admindocs/ Thu, 28 Mar 2019 00:00:00 +0000 https://step.dev/knowledgebase/31/admindocs/ This space is dedicated to the administration and operation of Step. For the installation of Step follow the set up documentation.