logofirst
logofirst GitHub

Install Label Studio Enterprise on Amazon Elastic Kubernetes Service (EKS)

Install Label Studio Enterprise on Amazon Elastic Kubernetes Service (EKS).

Before you start, review the deployment planning guidance.

For further details beyond these steps, see the Amazon tutorial on how to Deploy a Kubernetes Application with Amazon Elastic Container Service for Kubernetes.

1. Prerequisites

Before you can install Label Studio Enterprise on an EKS cluster, make sure that the following software prerequisites are installed and configured:

Software Version
Kubernetes and kubectl version 1.17 or higher
AWS CLI
eksctl
aws-iam-authenticator
Helm version 3.6.3 or higher
Redis version 6.0.5 or higher
PostgreSQL version 11.9 or higher

2. Deploy Kubernetes using eksctl

Use the eksctl tool to deploy an EKS cluster in your Amazon AWS environment. The eksctl create cluster command creates a virtual private cloud (VPC), a security group, and an IAM role for Kubernetes to create resources. For detailed instructions, see Getting started with Amazon EKS in the Amazon EKS User Guide.

Note: The Amazon user that creates the cluster is the one managing the cluster. See Managing users or IAM roles for your cluster in the Amazon EKS User Guide.

  1. To deploy an EKS cluster, run the following:
    eksctl create cluster \
    --name my-cluster \
    --region region-code \

For example:

eksctl create cluster --name label-studio-enterprise --region us-east-2
  1. Then, verify that the deployment was successful:
    kubectl get all

After your cluster is up and running, and you configure your infrastructure such as ingress, you can prepare your cluster to install Label Studio Enterprise.

3. Prepare the Kubernetes cluster to install Label Studio Enterprise

Before installing Label Studio Enterprise, prepare the Kubernetes cluster with kubectl.

Retrieve Label Studio Enterprise and configure the license

  1. Create a key to pull the latest Label Studio Enterprise image from the Docker registry. From the command line of your cluster, run the following:
    kubectl create secret docker-registry heartex-pull-key \
        --docker-server=https://index.docker.io/v2/ \
        --docker-username=heartexlabs \
        --docker-password=<CUSTOMER_PASSWORD>
  2. Create the Label Studio Enterprise license as a Kubernetes secret. You can specify it as a file or as a specific URL.
    From the command line, specify the license as a file:
    kubectl create secret generic lse-license --from-file=license=path/to/lic
    Or from the command line, specify the license as a URL:
    kubectl create secret generic lse-license --from-literal=license=https://lic.heartex.ai/db/<CUSTOMER_LICENSE_ID>

4. Set up Label Studio Enterprise Helm chart

See Configure a values.yaml file for Label Studio Enterprise.