Connection statuses
The Connections page shows two independent pieces of state for each connection: its activation status (a lifecycle state you control) and its real-time connectivity (whether the gateway tunnel is currently live).
Activation statuses
Section titled “Activation statuses”| Status | Meaning |
|---|---|
| Provisioning | A transient state immediately after creation while the platform sets up the connection. It advances automatically to Ready (or moves into the admin offer setup path); you don’t act on it directly. Shown with a pulsing hourglass indicator. |
| Ready | Provisioned and configured, but not yet activated by you. The gateway tunnel is not open. |
| Active | The connection is enabled and available for use. The gateway will establish a tunnel when both sides are running. |
| Paused | Temporarily suspended in the contact system. Existing open tunnels on the Mirth side are not forcibly disconnected, but no new ones are permitted. |
| Offered | An admin connection offer has been sent to the peer and is waiting for their response (accept or decline). |
| Failed | The connection entered an error state. Check the error message in the detail view. You can retry by moving it back to Ready. |
| Declined | The admin connection offer was declined by the recipient. Terminal — cannot be reactivated. |
| Expired | The admin connection offer was not accepted before the expiry time. Terminal. |
| Terminated | The connection was explicitly terminated by one of the parties. Terminal. |
Terminal statuses (Declined, Expired, Terminated) are hidden from the list by default. Click the count chip at the top of the list to show them.
Real-time connectivity indicators
Section titled “Real-time connectivity indicators”The connectivity indicator is separate from the activation status and updates automatically based on gateway presence events.
| Indicator | Meaning |
|---|---|
| Connected | The gateway is currently subscribed to the MQTT signaling topic for this connection. The tunnel is live. Shown with a pulsing green dot when the activation status is also Active. |
| Disconnected | The gateway was previously connected but is not currently subscribed. The connection has worked before. |
| Never connected | The connection is Active (or Paused) but has never successfully established a tunnel. Shown as a warning — check your Mirth gateway plugin configuration. |
| Not yet connected | The connection is Ready and has not been activated yet. Expected state before first activation. |
| Awaiting acceptance | The connection is in the Offered state, waiting for the peer to respond. |
Status transitions you can trigger
Section titled “Status transitions you can trigger”| From | To | Action |
|---|---|---|
| Ready | Active | Activate |
| Active | Paused | Pause |
| Paused | Active | Resume |
| Failed | Ready | Retry |
| Any non-terminal | — | Terminate (moves to Terminated) |
Related
Section titled “Related”- Connection types — P2P vs. Admin RW/RO explained.
- Troubleshooting connections — What to check when a connection shows “Never connected” or “Failed”.