# Install and configure Agones on Kubernetes

> Instructions for creating a Kubernetes cluster and installing Agones.

---

LLMS index: [llms.txt](/site/llms.txt)

---

## Usage Requirements

- **Kubernetes cluster version 1.33, 1.34, 1.35**
  - [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine/),
    [Azure Kubernetes Service](https://azure.microsoft.com/en-us/services/kubernetes-service/),
    [Amazon EKS](https://aws.amazon.com/eks/) and [Minikube](https://github.com/kubernetes/minikube) are supported.
  - If you are creating and managing your own Kubernetes cluster, the
    [MutatingAdmissionWebhook](https://kubernetes.io/docs/reference/access-authn-authz/admission-controllers/#mutatingadmissionwebhook), and
    [ValidatingAdmissionWebhook](https://kubernetes.io/docs/reference/access-authn-authz/admission-controllers/#validatingadmissionwebhook)
    admission controllers are required.
    - We also recommend following the
      [recommended set of admission controllers](https://kubernetes.io/docs/reference/access-authn-authz/admission-controllers/#is-there-a-recommended-set-of-admission-controllers-to-use).
- Firewall access for the range of ports that Game Servers can be connected to in the cluster.
- Game Servers must have the [game server SDK](/site/docs/guides/client-sdks/) integrated, to manage Game Server state, health checking, etc.

<div class="alert alert-warning" role="alert"><div class="h4 alert-heading" role="heading">Warning</div>


This release has been tested against Kubernetes versions 1.33, 1.34, 1.35 on GKE. Other versions may work, but are unsupported. It is also likely that not all of these versions are supported by other cloud providers.
</div>


## Supported Container Architectures

The following container operating systems and architectures can be utilised with Agones:

| OS        | Architecture | Support    |
| --------- | ------------ | ---------- |
| linux     | `amd64`      | **Stable** |
| linux     | `arm64`      | Alpha      |
| [windows] | `amd64`      | Alpha      |

For all the platforms in Alpha, we would appreciate testing and bug reports on any issue found.

[windows]: /site/docs/guides/windows-gameservers/

## Agones and Kubernetes Supported Versions

Agones will support 3 releases of Kubernetes, targeting the newest version as being the [latest available version in the GKE Rapid channel](https://cloud.google.com/kubernetes-engine/docs/release-notes#current_versions). However, we will ensure that at least one of the 3 versions chosen for each Agones release is supported by each of the major cloud providers (EKS and AKS). The vendored version of client-go will be aligned with the middle of the three supported Kubernetes versions. When a new version of Agones supports new versions of Kubernetes, it is explicitly called out in the [release notes](https://agones.dev/site/blog/releases/).

The following table lists recent Agones versions and their corresponding required Kubernetes versions:

| Agones version | Kubernetes version(s) |
| -------------- | ------------------    |
| 1.58           | 1.33, 1.34, 1.35   |
| 1.57           | 1.33, 1.34, 1.35      |
| 1.56           | 1.33, 1.34, 1.35      |
| 1.55           | 1.32, 1.33, 1.34      |
| 1.54           | 1.32, 1.33, 1.34      |
| 1.53           | 1.31, 1.32, 1.33      |
| 1.52           | 1.31, 1.32, 1.33      |
| 1.51           | 1.31, 1.32, 1.33      |
| 1.50           | 1.31, 1.32, 1.33      |
| 1.49           | 1.30, 1.31, 1.32      |
| 1.48           | 1.30, 1.31, 1.32      |
| 1.47           | 1.29, 1.30, 1.31      |
| 1.46           | 1.29, 1.30, 1.31      |
| 1.45           | 1.29, 1.30, 1.31      |
| 1.44           | 1.28, 1.29, 1.30      |
| 1.43           | 1.28, 1.29, 1.30      |
| 1.42           | 1.27, 1.28, 1.29      |
| 1.41           | 1.27, 1.28, 1.29      |
| 1.40           | 1.27, 1.28, 1.29      |
| 1.39           | 1.26, 1.27, 1.28      |
| 1.38           | 1.26, 1.27, 1.28      |
| 1.37           | 1.26, 1.27, 1.28      |
| 1.36           | 1.26, 1.27, 1.28      |
| 1.35           | 1.25, 1.26, 1.27      |
| 1.34           | 1.25, 1.26, 1.27      |
| 1.33           | 1.25, 1.26, 1.27      |
| 1.32           | 1.24, 1.25, 1.26      |
| 1.31           | 1.24, 1.25, 1.26      |
| 1.30           | 1.23, 1.24, 1.25      |
| 1.29           | 1.24                  |


## Best Practices {#separation-of-agones-from-gameserver-nodes}
<!-- keep installation/#separation-of-agones-from-gameserver-nodes permalink -->

For detailed guides on best practices running Agones in production, see [Best Practices](/site/docs/guides/best-practices/).

---

Section pages:

- [Create Kubernetes Cluster](/site/docs/installation/creating-cluster/): Instructions for creating a Kubernetes cluster to install Agones on.
- [Install Agones](/site/docs/installation/install-agones/): Install Agones in your existing Kubernetes cluster.
- [Deploy Kubernetes cluster and install Agones using Terraform](/site/docs/installation/terraform/): Install a [Kubernetes](http://kubernetes.io) cluster and Agones declaratively using Terraform.
- [Confirming Agones Installation](/site/docs/installation/confirm/): Verify Agones is installed and has started successfully.
- [Upgrading Agones and Kubernetes](/site/docs/installation/upgrading/): Strategies and techniques for managing Agones and Kubernetes upgrades in a safe manner.