Install on Linux Hosts
This method will install the Steadybit agent on your Linux machine using the respective package managers. By default, it will install the agent as well as the extensions extension-http, extension-container, and extension-host.
Supported Package Managers
apt
yum / dnf
Prerequisites
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://artifacts.steadybit.io (.deb and .rpm packages)
https://get.steadybit.com (Setup Scripts)
Agent Installation
To install the agent on your Linux system, you can copy the installation script from the setup page in the SaaS platform.
Alternatively, you can update and run the script below with your agent key, which you find in the platform's setup page:
Parameter | Description | Default |
---|---|---|
| The API key the agent uses | |
| The extensions to install |
|
| If running on-prem, the URL of your platform installation |
|
| Override the used package version | |
| Override the default package repository URL |
|
| Override the username for accessing the package repository | |
| Override the password for accessing the package repository |
Configure HTTP Proxy Server
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
Managing the Agent and Extension
Logs
The logs for agent and extensions are located in /var/log/steadybit-*.log
Configuration
The configurations for agent and extensions are located in /etc/steadybit
Start/Stop
When using systemd
When using InitV
The same applies to extensions. The services are named steadybit-extension-*
.
Removing the Agent
Remove the packages using the package manager:
Or when using yum:
Additional Extensions
If you want to use additional extensions (e.g. extension-jvm for attacking Java applications), you can apply the --extensions
parameter.
Using a single agent across multiple hosts
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. Installing the agent on a dedicated host and only the container and host extension on each host is possible.
Non-Agent Hosts
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 theSTEADYBIT_EXTENSION_UNIX_SOCKET=...
line. If you want to override the default port setSTEADYBIT_EXTENSION_PORT
.Restart the extensions
Agent Host
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
Last updated