
## Table of Contents

1. [Introduction](#introduction)
2. [Setup EC2 Ubuntu](#setup-ec2-ubuntu)
3. [Install Docker and Docker Compose](#install-docker-and-docker-compose)
4. [Clone the Sentry Self-Hosted Repo](#clone-the-sentry-self-hosted-repo)
5. [Install Sentry and Create a New User](#install-sentry-and-create-a-new-user)
6. [Run Docker Compose](#run-docker-compose)
7. [Conclusion](#conclusion)

## Introduction

This blog shows how to self-host Sentry.io on an AWS EC2 instance.

Sentry.io provides a self-hosted solution and hosts the source code
[here](https://github.com/getsentry/onpremise). Based on the Sentry
self-host requirements, you'll need to meet the following specifications.
These requirements will probably change when a new version comes out, so
double-check the requirements before setting up the instance.

- Docker 19.03.6+

- Compose 1.28.0+

- 4 CPU Cores

- 8 GB RAM

- 20 GB Free Disk Space

## Setup EC2 Ubuntu

### Launch AWS EC2 Instance

### Choose Ubuntu Server 20.04, Free Tier Eligible

### Choose t2.medium

The requirement is 4 CPU cores, but it looks like a minimum of 2 CPUs works
fine, so I chose t2.medium here.

### Configure Instance Details

This blog does not cover setting up AWS VPC or subnets. Most of the settings
here can be left as default, as long as the VPC has public access.

### Add Storage

For storage, set the size to 25 GB.

### Configure Security Group

Depending on how you want to host Sentry, this could vary. At a minimum, make
sure ingress ports 80 and 22 are open — one for access from the internet and
another for SSH into the instance.

### Finish Creating the Instance

After finishing the EC2 instance creation for Ubuntu, SSH into the instance.
After connecting, we'll perform the following tasks to install Docker.

## Install Docker and Docker Compose

### Setup the Repository

```
sudo apt-get update
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
```

### Add Docker's Official GPG Key

```
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

### Install Docker Engine

```
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
```

### Install Docker Compose on Linux

```
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
```

### Apply Executable Permissions to the Binary

```
sudo chmod +x /usr/local/bin/docker-compose
```

### Reboot Ubuntu

## Clone the Sentry Self-Hosted Repo

```
git clone https://github.com/getsentry/onpremise.git
```

## Install Sentry and Create a New User

During the installation process, you will be asked to create a new account.
Enter the email and password to create a new account. You'll use the email and
password to log in later.

```
cd onpremise/
sudo ./install.sh
```

## Run Docker Compose

This docker-compose command might take some time to finish everything, but
once it completes, you should be able to access Sentry via the browser using
the instance's IP address.

```
sudo docker-compose up -d
```

## Conclusion

If everything works, when you navigate to the instance's IP address in your
browser, you should see the Sentry.io login page. Enter the email and password
you created earlier to log in.

References

- Install Docker Engine on Ubuntu

- Install Docker Compose

- Self-Hosted Sentry nightly


This blog shows how to self-host Sentry.io on an AWS EC2 instance.

How to Self-Host Sentry.io on AWS EC2


## Table of Contents

1. [Introduction](#introduction)
2. [Go to Sentry.io to Register](#go-to-sentryio-to-register)
3. [Run the Page](#run-the-page)
4. [Conclusion](#conclusion)

## Introduction

This blog shows how to get started with Sentry.io for tracking JavaScript
errors and performance.

Often, once you ship your website, you'll continue to add content and
features, which means you'll need to call more APIs to get more data. Then
your site may become slower, so you'll add some caching to make requests
faster and track the speed of your pages so you know if you have improved or
not.

Now, this blog will show how to get started using Sentry.io with JavaScript in
a web application. Sentry.io supports the following features:

- Open-source error tracking system supporting PHP, Node.js, Python, Ruby,
  C#, Java, Go, React, Angular, Vue, and JavaScript.

- The pricing starts as free with limited features and can be upgraded to a
  paid version with more.

## Go to Sentry.io to Register

First, go to Sentry.io to create an account and follow the instructions to
prepare the JavaScript SDK. The application used in this sample was using
Node.js in the backend. The frontend has a TypeScript file called
`global.ts`, and we want to add Sentry.io to the UI's JavaScript
code.

```
import * as Sentry from "@sentry/browser";
import { Integrations } from "@sentry/tracing";

Sentry.init({
    dsn: "{THIS CODE WILL PROVIDE BY SENTRY.IO}",
    integrations: [new Integrations.BrowserTracing()],
    environment: 'local', // default is 'Production'
    // Set tracesSampleRate to 1.0 to capture 100%
    // of transactions for performance monitoring.
    // We recommend adjusting this value in production
    tracesSampleRate: 1.0,
  });
```

## Run the Page

Once you run the page that includes the Sentry.io code, you should start
seeing some data in your Sentry.io account. You can modify the environment
setting as shown above to separate data by different environments.

## Conclusion

That's all you need to get started with Sentry.io. There are many more
settings you can configure, but this is the minimal setup required to get
started with error tracking and performance monitoring.


This blog shows how to get started with Sentry.io for tracking JavaScript errors and performance.

Sentry

How to Self-Host Sentry.io on AWS EC2

How to Get Started with Sentry Error Tracking