Skip to content

Quarantine

Fleet → Quarantine (/gravity/fleet/quarantine) lets you isolate a fleet-enrolled host at the network level - useful if you suspect it’s been compromised and want to cut it off without touching the machine directly.

Quarantining a host blocks its outbound network traffic at the operating-system level, except for the connection it needs to keep talking to Sencai - so the platform can still release it later. The isolation runs on the host itself, through the fleet agent, and is Linux-only.

You can trigger it manually or configure a policy that does it automatically:

  • Manual - Fleet → Quarantine → Quarantine Agent, enter the agent’s ID, and optionally apply an existing policy.
  • Policy-driven - define a Quarantine Policy with a trigger type (manual, critical incident, critical vulnerability score, or suspicious execution), and an auto-release window (or manual release only). See the caution below before relying on a policy to isolate a host on its own.
TriggerIntended conditionEvaluated today
ManualOnly when someone explicitly quarantines the agentNo automatic condition
Critical incidentA critical-severity incident is linked to the hostNot yet
Critical vulnerability scoreThe host’s vulnerability score crosses a critical thresholdEvaluation only - no isolation
Suspicious executionAnomalous command execution is detected on the hostNot yet

Each policy also records an auto-release window - the number of hours after which a quarantine triggered by that policy is intended to release itself, or manual only - and whether to notify on trigger. Neither the auto-release window nor the notification has a consumer yet: nothing currently releases a quarantine automatically or sends a notification when a policy fires, regardless of what you configure here. Release a host manually - see below.

Essentially all outbound network traffic from the host is blocked - it can’t reach the internet, other internal services, or anything else outside its connection back to Sencai. It doesn’t touch the host’s own running processes, files, or local services; those keep running, they just can’t communicate outward.

From Fleet → Quarantine → Active Quarantines, click Release on the host and optionally note a reason. Releasing a host requires an organization Owner or Admin role in the organization that quarantined it, and the agent must have the Quarantine: Release capability granted and be connected at that moment - the same online requirement as isolating a host. Release dispatches to the agent the same way quarantine does: where dispatch isn’t enabled for your environment, Release fails and the host stays listed as actively quarantined.

Every quarantine and release action - who triggered it, on which host, when - is recorded in your organization’s audit trail.

Fleet → Quarantine → History lists the most recent quarantine events for your organization (up to the last 20) - whether each is still active or has been released manually, with the trigger type, when it was quarantined, when (if at all) it was released, and any release reason that was given. Use this if you need a quick record of past isolations without pulling the full audit trail.

From Fleet → Quarantine → Quarantine Policies, you can add a new policy (name, trigger type, auto-release window, and whether to notify on trigger) or delete one you no longer need. Deleting a policy doesn’t release any host it’s currently applied to - release those separately from Active Quarantines if needed.

  • Fleet agent - how capabilities are granted, including Quarantine: Isolate and Quarantine: Release
  • Agent policies - autonomy limits for automated actions, secret injections, and custom probes (a different thing from a Quarantine Policy)
  • Remote execution - running commands instead of isolating a host
  • Audit log - reviewing quarantine history
  • Incidents - the broader incident-response workflow