Installing the Reflex agent

The Reflex agent is a lightweight process that runs on your server, reporting health metrics and executing deployments and repair playbooks.

Supported platforms

OS	Version	Architecture
Ubuntu	22.04, 24.04	x86_64, arm64
Debian	12, 13	x86_64, arm64

Installation

SSH into your server and run the one-line installer shown in your Reflex dashboard under Add Server. The installer:

1. Downloads the latest agent binary for your architecture
2. Registers the server with your Reflex account
3. Opens an encrypted channel to the Reflex control plane

The whole process takes under 60 seconds.

Manual installation

If you prefer not to pipe to bash, download the installer script first and review it before running:

# Download the installer script from the URL shown in your dashboard
curl -fsSL <your-install-url> -o get-reflex.sh

# Review it
less get-reflex.sh

# Run it
bash get-reflex.sh

Verifying the installation

Once installed, the agent reports back within seconds. Check your Reflex dashboard — your server should appear with a green "Connected" status.

Firewall requirements

The agent initiates outbound connections only — no inbound ports need to be opened.

Direction	Protocol	Destination	Port
Outbound	HTTPS	reflex.expertweb.tools	443

Removing the agent

To remove the Reflex agent from a server, use the removal option in your dashboard under Server Settings → Remove Server. This cleanly uninstalls the agent and disconnects the server from your account.