# A/B Deployment

A/B deployment is an update process whereby you deploy new versions of your game servers alongside your already existing game servers. First in small amounts, allowing you to test your new build first with a few clients, maybe a team of internal or external testers. You control the clients that will connect to the new versions via your matchmaker - you do not update all clients at the same time. Only when you are happy with the new game server version will you send all client-update instructions and will you let all other clients join with the new game servers.

This has the side effect that your game servers running the old version will automatically be abandoned once all your clients have updated. When that moment has been reached, you can delete the remaining game servers still running the old version.

{% hint style="info" %}
This deployment method has not yet been implemented.
{% endhint %}

## Benefits

* No maintenance window is required
* Allows for testing your new game servers before moving the whole community to the new version

## Downsides

* During the A/B deployment process you will have a bit more game servers than normal, occupying a bit more resources, unless you have unused bare metal hosts available

## Performing a A/B Deployment via the UI

{% hint style="info" %}
This deployment method is not yet available. This documentation will be updated as soon as it is available.
{% endhint %}

## Performing a A/B Deployment via the API

{% hint style="info" %}
This deployment method is not yet available. This documentation will be updated as soon as it is available.
{% endhint %}

## Performing a A/B Deployment manually

You can perform all of the above manually if you wish, bypassing our automated systems. For more details on how to do this, please see the [AB Deployment - Manually](https://docs.i3d.net/game-hosting/processes/index/ab-deployment-manually) chapter. Note that you will not receive any live-reporting emails then.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.i3d.net/game-hosting/processes/index/ab-deployment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
