Skip to content

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).

StatusMeaning
ProvisioningA 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.
ReadyProvisioned and configured, but not yet activated by you. The gateway tunnel is not open.
ActiveThe connection is enabled and available for use. The gateway will establish a tunnel when both sides are running.
PausedTemporarily suspended in the contact system. Existing open tunnels on the Mirth side are not forcibly disconnected, but no new ones are permitted.
OfferedAn admin connection offer has been sent to the peer and is waiting for their response (accept or decline).
FailedThe connection entered an error state. Check the error message in the detail view. You can retry by moving it back to Ready.
DeclinedThe admin connection offer was declined by the recipient. Terminal — cannot be reactivated.
ExpiredThe admin connection offer was not accepted before the expiry time. Terminal.
TerminatedThe 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.

The connectivity indicator is separate from the activation status and updates automatically based on gateway presence events.

IndicatorMeaning
ConnectedThe 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.
DisconnectedThe gateway was previously connected but is not currently subscribed. The connection has worked before.
Never connectedThe connection is Active (or Paused) but has never successfully established a tunnel. Shown as a warning — check your Mirth gateway plugin configuration.
Not yet connectedThe connection is Ready and has not been activated yet. Expected state before first activation.
Awaiting acceptanceThe connection is in the Offered state, waiting for the peer to respond.
FromToAction
ReadyActiveActivate
ActivePausedPause
PausedActiveResume
FailedReadyRetry
Any non-terminalTerminate (moves to Terminated)