Deactivate and delete a fleet

Overview

This article walks you through how to deactivate and delete fleets in your AccelByte Multiplayer Servers (AMS) account on the AccelByte Gaming Services (AGS) Admin Portal.

Prerequisites

Before you begin this guide, you must:

• Access to your game's namespace and account in the AGS Admin Portal.
• Created fleets to manage the allocation of your dedicated servers.

Deactivate a fleet

Deactivating a fleet is designed for scaling that won't impact players, typically employed in production scenarios. Initiating a drain sends a signal to the Dedicated Servers (DS), allowing them to gracefully handle ongoing processes such as flushing logs or updating statistics. For code examples, see Listen to the drain signal. After a defined drain timeout (configurable in the Admin Portal), the dedicated server is forcibly terminated.

To deactivate a fleet, follow these steps:

1. Go to your game namespace on the AGS Admin Portal.

2. On the sidebar, open the AccelByte Multiplayer Servers menu and select Fleet Manager or Fleets. The Fleets page shows a list of the fleets in your AMS accounts.

3. From the list, find and open the fleet that you want to deactivate.

4. On the details page of the fleet, under its name, you will see the Fleet Status toggle. Switch off the toggle. The Deactivate Fleet pop-up appears.

5. On the pop-up, type in the name of the fleet to confirm the deactivation, then click Deactivate. The fleet is immediately deactivated.

Delete a fleet

Deleting a fleet ensures immediate termination, often used in development scenarios to control costs. It forcibly terminates all running DS instances.

danger

Logs and artifacts are not collected from the terminated DS instances, reflecting an immediate termination of all fleet resources.

To delete a fleet, follow these steps:

1. Go to your game namespace on the AGS Admin Portal.

2. On the sidebar, open the AccelByte Multiplayer Servers menu and select Fleet Manager or Fleets. The Fleets page shows a list of the fleets in your AMS accounts.

3. You can delete a fleet in two ways:

   • From the fleets list: find the fleet that you want to delete and click on its corresponding delete (trash icon) button under the Actions column.
   • On its details page: find and open the fleet that you want to delete. On its details page, click Delete.

   The Delete Fleet pop-up appears.

4. On the pop-up, type in the name of the fleet to confirm the deletion, then click Delete. The fleet is immediately deleted.