Skip to content
Athena User Guide
Esc
↑↓navigate↵open⌘Jpreview
On this page

Restore a team's box

Put a team's box back to its clean snapshot, and revoke SSH keys and VPN access that should no longer reach it.

Every box is snapshotted immediately before the network opens. A restore returns a box to that clean state, which is how a team recovers from a broken service or a box an attacker has wrecked.

Players can request a restore of their own box from their My box page. You can restore any team’s box.

Restore a box

Open Team boxes, select the team’s box and click Restore from snapshot, or run athena ad box restore. Confirm the dialog.

The restore runs in the background and the box page shows its progress. Its effect on the team:

  • everything the team changed since the snapshot is lost, including its patches;
  • every flag store on the box earns no SLA and no defence in any tick the restore overlaps, from the moment it is requested until the box is healthy again, including a restore that spans several ticks or fails;
  • flags placed before the restore and not yet expired are gone, so reading them back fails until they leave the validity window;
  • flags already stolen stay stolen, the team’s own captures keep scoring, and earlier scores don’t change.

The box keeps its address, its identity and its SSH host key. Its SSH keys are the team’s current keys, not the ones present when the snapshot was taken, so a key revoked since then stays revoked.

A box has one restore at a time. A restore is refused before the network opens, since there is no snapshot yet, while the event host can’t be reached, while another restore of the box is running, and once the event has ended. The final data export records every restore, and marks each store state a restore made unavailable.

Revoke an SSH key

Players register the SSH keys that open their team’s box. To remove one, open the team in Teams, find the key under SSH keys and click Revoke. The key stops opening the box once the host applies the change. Players can revoke their own keys from My box and register new ones there.

Revoke a player’s VPN access

Open the player in Players and click Revoke next to their VPN peer. Their current VPN configuration stops reaching the game network. They can generate a new one from Downloads while they remain on an admitted team and aren’t banned.

Removing a player from a team, or banning them, revokes both their VPN peer and their SSH keys for that team’s box on its own, and unbanning doesn’t bring them back.

Was this page helpful?