Deploying Sentry Self-Hosted with Kubernetes on Amazon EKS

Deploying Sentry Self-Hosted with Kubernetes on Amazon EKS
Photo by David Pupăză / Unsplash

Sentry, an open-source error-tracking tool, is a valuable addition to any development stack, allowing teams to identify, diagnose, and fix errors in applications efficiently.

In this guide, we will walk through the process of deploying Sentry self-hosted on Amazon Elastic Kubernetes Service (EKS), taking advantage of the managed Kubernetes environment offered by AWS.


Before we get started, make sure you have the following prerequisites in place:

Amazon Web Services (AWS) Account: You need access to an AWS account to create and manage EKS clusters.
AWS CLI and eksctl: Install the AWS Command Line Interface (CLI) and eksctl, a command-line utility for creating and managing EKS clusters.
Kubectl: Install kubectl, the Kubernetes command-line tool, to interact with your EKS cluster.

apt install kubectl

Helm: Helm is a package manager for Kubernetes. Install Helm to simplify the deployment of Sentry.

apt install helm

Steps to Deploy Sentry on EKS

Let's proceed with deploying Sentry on your Amazon EKS cluster:

1. Create an EKS Cluster

Use eksctl to create an EKS cluster with the necessary configuration. Replace <cluster-name> with your desired cluster name and <region> with your preferred AWS region:

eksctl create cluster --name <cluster-name> --region <region> --managed --node-type t2.medium --nodes 2

This command creates a managed EKS cluster with two worker nodes of type t2.medium. Adjust the node type and count based on your needs.

2. Configure kubectl

Configure kubectl to use the newly created EKS cluster:

aws eks --region <region> update-kubeconfig --name <cluster-name>

3. Deploy Sentry Using Helm

Now, let's use Helm to deploy Sentry on your EKS cluster. First, add the Sentry Helm repository:

helm repo add sentry
helm repo update

Next, create a values.yaml file to configure Sentry according to your requirements. Here is a basic example:

# values.yaml

  enabled: true
  # Add your Sentry configuration here

Install Sentry with Helm, specifying the namespace:

kubectl create namespace sentry
helm install sentry sentry/sentry -f values.yaml -n sentry

4. Access Sentry

Determine the Sentry web service's external IP address to access the Sentry web interface:

kubectl get svc sentry-web -n sentry

Access the external IP address in your web browser, and you should see the Sentry login screen.

5. Configure Slack Notifications

To enable Slack notifications in Sentry, follow these steps:

  1. Log in to the Sentry web interface.
  2. Navigate to Project Settings > Alerts.
  3. Click on Add New Rule and configure your notification preferences, including Slack integration.
  4. Enter your Slack webhook URL, and save the rule.

Now, Sentry will send notifications to your Slack channel when errors occur.


Deploying Sentry self-hosted on Amazon EKS provides a scalable and managed environment for error tracking and monitoring.

By following these steps, you can quickly set up Sentry and integrate it with your AWS resources, ensuring your development team can efficiently identify and address issues in your applications.