Getting started

Welcome to Reflex. This guide walks you through installing the agent, connecting your first server, and running your first deployment.

Prerequisites

• A Linux server running Ubuntu 22.04+ or Debian 12+
• Root or sudo access
• A Reflex account — sign up here

Quick start

1. Install the agent

SSH into your server and run:

curl -fsSL https://reflex.expertweb.tools/install/get-reflex.sh | bash

The installer downloads the Reflex agent, registers it with your account, and opens a secure channel back to the Reflex control plane.

2. Verify the connection

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

3. Run your first deployment

Navigate to Pipelines in the dashboard, connect your Git repository, and trigger a deployment. Reflex handles:

• Pulling your code from the configured branch
• Running your build and release commands
• Performing health checks after deployment
• Rolling back automatically if health checks fail

4. Enable self-healing

Visit Playbooks in your server's settings to enable automated repair playbooks. Popular playbooks include:

• PHP-FPM OOM recovery — detects and restarts PHP-FPM when memory is exhausted
• Nginx 502 fix — diagnoses and repairs bad gateway errors automatically
• Disk full emergency — clears safe targets when disk usage exceeds thresholds
• Queue death recovery — restarts stalled queue workers

Each playbook runs automatically when Reflex detects the matching incident signature.

Next steps

• Agent configuration — customise agent behaviour
• API reference — integrate Reflex into your CI/CD pipeline
• Integrations — connect Slack, GitHub, and more