Install Sentry with a cluster management project

Introduced in GitLab 14.0.

The Sentry Helm chart recommends at least 3 GB of available RAM for database migrations.

Assuming you already have a Cluster management project created from a management project template, to install Sentry you should uncomment this line from your helmfile.yaml:

  - path: applications/sentry/helmfile.yaml

Sentry is installed by default into the gitlab-managed-apps namespace of your cluster.

You can customize the installation of Sentry by defining applications/sentry/values.yaml file in your cluster management project. Refer to the chart for the available configuration options.

We recommend you pay close attention to the following configuration options:

  • email. Needed to invite users to your Sentry instance and to send error emails.
  • user. Where you can set the login credentials for the default administrator user.
  • postgresql. For a PostgreSQL password that can be used when running future updates.

When upgrading, it’s important to provide the existing PostgreSQL password (given using the postgresql.postgresqlPassword key) to avoid authentication errors. Read the PostgreSQL chart documentation for more information.

Here is an example configuration for Sentry:

# Admin user to create
  # Indicated to create the admin user or not,
  # Default is true as the initial installation.
  create: true
  email: "<your email>"
  password: "<your password>"

  from_address: "<your from email>"
  host: smtp
  port: 25
  use_tls: false
  user: "<your email username>"
  password: "<your email password>"
  enable_replies: false

  enabled: true
  hostname: "<>"

# Needs to be here between runs.
# See for more info
  postgresqlPassword: example-postgresql-password