> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remoteagent.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Offline alerts

> Get notified immediately when your agent goes offline, and learn how to bring it back.

RemoteAgent.CHAT monitors the connection status of your agents in real time. When an agent disconnects — whether due to a crash, a machine reboot, or a lost network connection — the bot sends you a Telegram notification immediately.

## How it works

When an agent starts, it establishes a connection to the relay. The relay tracks the agent's heartbeat. If the heartbeat stops (the agent disconnects without sending a graceful shutdown), the bot sends you a message:

```
Your agent "my-api" went offline.
Last seen: just now

Run remoteagent start in your project directory to bring it back.
```

Offline alerts are included on all plans.

## Restarting the agent

When you receive an offline alert, restart the agent on your machine:

```bash theme={null}
cd /path/to/your/project
remoteagent start
```

Or by project name from any directory:

```bash theme={null}
remoteagent start "my-api"
```

The agent reconnects and immediately resumes accepting commands. The bot sends a confirmation:

```
Your agent "my-api" is back online.
```

## Automatic reconnection

The agent has built-in reconnection logic. If the connection drops temporarily (e.g., a brief network blip), the agent attempts to reconnect automatically with exponential backoff. You will only receive an offline alert if the connection cannot be restored within the reconnection window.

This means transient network issues are handled silently — you only get notified for meaningful outages.

## Setting up automatic restarts

To minimize downtime without manual intervention, run the agent as a supervised process that restarts automatically:

<CodeGroup>
  ```bash pm2 theme={null}
  pm2 start "remoteagent start" --name my-api --cwd /path/to/project
  pm2 save
  pm2 startup
  # Follow the instructions pm2 prints to enable startup on boot
  ```

  ```bash systemd theme={null}
  # Create /etc/systemd/system/remoteagent-myapi.service
  # (see the Multi-project page for the full unit file)
  systemctl enable remoteagent-myapi
  systemctl start remoteagent-myapi
  ```
</CodeGroup>

With a process supervisor, the agent restarts within seconds of a crash. You may still receive a brief offline alert (sent the moment the process exits), followed shortly by an online notification when the process supervisor brings it back.

## Checking agent status manually

You can check the status of all your agents at any time by sending `/agents` to the bot, or by visiting the [dashboard](https://remoteagent.chat/dashboard).

The dashboard shows:

* Current status (online / offline)
* Last seen timestamp
* Number of active sessions