> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlimina.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS EKS Deployment Guide

> How to deploy Limina in EKS

This guide describes how to setup the Limina container on AWS EKS.

## 1. Prerequisites

Before you begin, ensure that you have installed the following tools:

* [AWS CLI Tool](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
* [eksctl](https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html)
* [kubectl](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)

Please also see our installation documentation for more information on how to load the Limina docker image.

## 2. Create EKS cluster and node roles

Follow the AWS documentation to [create an IAM role for your EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/service_IAM_role.html) (if you don't have one already) and this is to [create an IAM role for your EKS node group](https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html).

Once you have both of these roles created, proceed to the next step to create your EKS cluster.

## 3. Create EKS Cluster

Follow the AWS documentation to [create your EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) which gives you the option to perform this task via `eksctl`, the AWS CLI tool or simply through the management console in the AWS portal.

<Note>
  **Reminder:** Once you've created your cluster, don't forget to update your kubectl config to commincate with it by running:

  ```shell AWS Command wrap theme={"theme":"poimandres"}
  aws eks update-kubeconfig --region region-code --name my-cluster
  ```
</Note>

## 4. Create EKS Node Group

Follow the AWS documentation to [create an EKS node group](https://docs.aws.amazon.com/eks/latest/userguide/create-managed-node-group.html) either through `eksctl` or the management console in the AWS portal.

<Tip>
  For the AMI type, be sure to select an AMI with memory >16GB. In addition to this, if you plan to use the GPU container, be sure to select the GPU enabled Linux AMI and a disk size of >30GB.

  For image and PDF processing we recommend choosing a larger instance type such as the `m5zn.3xlarge` for optimal performance.
</Tip>

## 5. Deploy

From here, you can follow our [Kubernetes setup guide](/installation/kubernetes-setup-guide) to go the rest of the way.