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

Lock the roster and reserve the host

Admit the teams, get a sizing quote, and allocate the dedicated host every team's box runs on.

Every attack/defence event runs on one dedicated host, sized for the teams that actually play. The host can only be sized once the roster is fixed, so the order is always: lock the roster, get a quote, reserve.

Lock the roster

The roster locks at the Roster deadline you set when you created the event. To lock it earlier, open the event overview and click Lock roster under Game state, or run athena ad roster lock.

Locking admits every team that exists at that moment and gives each one a stable team number. From then on:

  • no team can be created or disbanded, for the rest of the event;
  • players can still join or leave an admitted team, and a member who leaves loses access to the team’s box;
  • each admitted team gets one box on the host.

The roster can’t exceed Admitted teams (cap). If more teams exist than the cap allows, the lock is refused and nobody is admitted, whether you lock by hand or the deadline passes. Players can create as many teams as they like until the roster deadline, so watch Teams, which lists every team, admitted or not, and delete surplus empty teams before the deadline. Once the deadline has passed, no team can be deleted or disbanded, by you or by its last member leaving, so a refused lock stays refused until you move the Roster deadline later under Settings → Game, delete the surplus empty teams and lock again. A roster with no teams at all is refused too, since there is nothing to run.

Add a reference team

A reference team is a box of your own that the checker visits like any other, useful for confirming the services and checker behave while players attack. On Teams, click Reference team, give it a name and a handle, and create it before the roster locks. It is admitted with the others and gets its own box and checks, so it counts toward the host’s size and price. It is never scored or ranked, and players can’t join it.

Until the roster locks, an existing team can be turned into a reference team, or back, from its details under Reference team. A scored team needs at least one member.

Get a quote

Open Event host and click Get a quote under Sizing quote. If the event isn’t ready, the card says why instead:

  • The roster is not locked yet.
  • A settings change is still synchronizing. Wait for the change to finish, then try again.
  • No enabled service is registered yet.

A quote picks the cheapest host size that fits every team’s declared CPU, memory and disk, plus the capacity the platform reserves for checkers, player VPN traffic and the host itself. The quote shows:

  • the host size and region, and any extra storage volume;
  • how many teams are admitted and how many would fit;
  • the hourly price and the amount held from your wallet.

A size is offered only once Athena has measured it on a real host. If the sizes that would fit haven’t been measured yet, the quote says so rather than offering one.

If no size fits, the quote names the limiting dimension (for example memory or disk) and what each size was short of. What you can still change at this point is limited, because the quote already rests on a locked roster:

  • Checker load is the one input you can reduce. Each of these lowers it for the next quote: disabling a service (fewer services and flag stores), a longer tick (the same checks spread over more time), a shorter flag validity (fewer earlier flags read back each tick) and a shorter checker timeout (a smaller worst case per tick). Change the last three under Settings → Game. Moving any of them the other way raises the load.
  • The per-team CPU, memory and disk, the host region and the admitted-team cap are fixed when the event is created, and the locked roster can’t shrink: admitted teams can’t be deleted.

When the limit comes from the teams’ own resources, this event can’t be given a host. Create a new event with smaller per-team limits or in a region that offers larger sizes. Work out that sizing before the roster locks, since a quote is only available after it.

Reserve and allocate

Click Reserve host and confirm. The hold is taken from your wallet and the host is created. Allocation takes several minutes: the host boots, pulls your service and checker images, creates a box for every admitted team and runs its own checks. Event host shows progress and reports ready once every box and the checker runner agree with what was requested.

If an image pull is refused by your registry, allocation fails instead of retrying. Check the pull credentials on the service and reserve again.

Cancel an allocation

Before the game starts, Cancel allocation on Event host deletes the host and every box on it. The hold is returned and only the time the host existed is charged. A reservation whose host was never created can be released with Release reservation.

Replace the host

Before the network opens, Replace the host on Event host destroys the current host and every box on it and lets you reserve a new one. Use it to change the registered services or their images, ports or flag stores, which are fixed once a host is allocated, or to recover from a reported compromise. The roster, settings, team numbers and schedule stay as they are.

You pay for the time the old host existed. Once it is deleted and billed, make your changes, Get a quote and Reserve host again; the replacement gets its own hold. Anything teams changed on their boxes before the network opened is lost. After the network opens a host can’t be replaced.

See Plans and limits and Manage billing and credits for how holds and charges appear in your wallet.

Was this page helpful?