Install on Linux Hosts
Last updated
Was this helpful?
Last updated
Was this helpful?
Using the respective package managers, this method will install the Steadybit agent on your Linux machine. By default, it will install the agent as well as the extensions , , and .
apt
dnf
yum
To install the agent, you must be able to access the following URLs via HTTPS (443) on your target environment:
https://platform.steadybit.com (Platform)
https://packages.steadybit.com with redirect to https://europe-west1-yum.pkg.dev and europe-west1-apt.pkg.dev (.deb and .rpm packages)
https://get.steadybit.com (Setup Scripts)
To install the agent on your Linux system, copy the installation script from the SaaS platform's .
Alternatively, you can update and run the script below with your agent key, which you find on the platform's :
--key
The API key the agent uses
--extensions
The extensions to install
steadybit-extension-host,steadybit-extension-container,steadybit-extension-http
--platform-url
If running on-prem, the URL of your platform installation
https://platform.steadybit.com
--version
Override the used package version
The package repositories have a pull limit. If you're installing the packages on a large number of servers, please consider using a mirror repository.
The Steadybit Agent uses HTTP and WebSockets to communicate with the platform and to download updates. To simplify the agent deployment, consider allowing direct communication to our platform.
If you require a single entry into and out of your network, you can configure the agent to use a proxy:
Edit /etc/steadybit/agent
and set the values for these variables:
Restart the service
When using systemd
When using InitV
For Linux installations, the docker runtime is auto-configured by the extension by looking at the system paths. If this is incorrectly auto-configured, it can be set in /etc/steadybit/extension-container
using STEADYBIT_EXTENSION_CONTAINER_SOCKET
and STEADYBIT_EXTENSION_CONTAINER_RUNTIME
. If you have installed docker just before, etc., please restart your host or the needed services.
The logs for agent and extensions are located in /var/log/steadybit-*.log
The configurations for agent and extensions are located in /etc/steadybit
When using systemd
When using InitV
The same applies to extensions. The services are named steadybit-extension-*
.
Remove the packages using the package manager:
Or when using yum:
By default, the agent-linux.sh
installs the agent and extension on a single host. When installed on multiple hosts, each runs an agent instance, allocating many resources. It is possible to install the agent on a dedicated host and only the container and host extension on each host.
Install only container and host extensions by using --no-agent
flag
Reconfigure the extension to listen on http by editing /etc/steadybit/extension-container
and /etc/steadybit/extension-host
and removing the STEADYBIT_EXTENSION_UNIX_SOCKET=...
line.
If you want to override the default port, set STEADYBIT_EXTENSION_PORT
.
Restart the extensions
Install the Agent as usual
For each extension running on a different host, create a /etc/steadybit/extensions.d/extension-*.yaml
to configure the remote-located extensions
If you want to use additional extensions (e.g. for attacking Java applications), you can apply the --extensions
parameter.