Requirements and Pre-Installation

7 min

User Permission Requirements

Must be an Account Admin in Swimlane.

Multi-Factor Authentication (MFA) must be disabled for installation, or use the "Exempt Force SSO" option if MFA is enabled.

The user used for installation is not saved, and may be removed after installation. Instead, machine IDs and secrets are created during installation for agent communication.

Supported Operating Systems

For the latest supported OS list, see Critical Prerequisites.

Hardware Requirements

Resource	Minimum
CPU	2 vCPUs (x64)
RAM	2 GB
Disk	OS minimum + 20 GB

Additional hardware may be required dependent on workload and specific processing requirements.

Network Requirements:

Outbound HTTPS (443) to your Swimlane Turbine instance and quay.io

Whitelist all of quay.io

Remote agent installation typically downloads a bash script from your Swimlane Turbine instance. During installation, several containers will be downloaded from quay.io. They may also be downloaded during cron-based upgrades. Connectors are not downloaded from quay.io and are instead pulled from the primary Swimlane Turbine instance.

Required Software

You must install Docker (latest) or Podman 4.2+ (only one required):

Docker

Install Docker

Docker service and client required; no license needed.

Agent auto-restarts after OS reboot by default.

Podman

Install Podman

Additional packages such as podman-plugins may be required depending on the installation method.

While you can install either Docker (latest) or Podman 4.2+ to run the Remote Agent, Docker is recommended for most users as it is generally easier to get started with. Podman is better suited for advanced system administrators.

Python 3

Install Python

OS Level Requirements

Remote agents heavily use container technology to run isolated workloads. Different Linux OS distributions come with different default settings for container namespaces.

Control Groups v2 (Cgroup v2)

Only Cgroup v2 is supported. Remote agents require Cgroup v2 for proper resource management and rootless container nesting. Most modern distributions (RHEL 9, Rocky Linux 9, Amazon Linux 2023) use Cgroup v2 by default. If your system is configured for Cgroup v1 or "Hybrid" mode, the agent installation will fail.

Maximum User Namespaces

Before running the install script, verify and/or set the maximum user namespaces:sudo sysctl user.max_user_namespaces=65536

User namespaces allow containers to run as non-root users.

SELinux and Non-root Installs

For RHEL/SELinux or non-root scenarios, follow the container engine post-install docs.

Docker Post-Install

Podman Rootless Troubleshooting

Podman and Operating System Integration

Podman remote agents can now be managed using Quadlets, providing improved operating system integration and reliability.

Quadlets are exclusive to Podman and are not compatible with Docker.

When installing remote agents with Podman, use the -Q flag to enable Quadlet support.

To migrate existing Podman remote agents, disable and remove any existing systemd configurations, then add -q flag to the update script crontab.

Supported Operating Systems for Quadlets:

RHEL 9: 9.2, 9.4, 9.5, 9.6

Rocky Linux 9: 9.2, 9.4

Supported Podman version: 4.4+

This enhancement ensures that Podman remote agents restart seamlessly with the system and are fully supported through Quadlet-based management.

Note that all Remote Agents in a host or system should either be in quadlet mode or non-quadlet mode but not both.