You can start running Sequin quickly with Docker Compose.

Prerequisites

You’ll need Docker and Docker Compose installed.

Quick start

The easiest way to get started with Sequin is with our Docker Compose file. This file starts a Postgres database, Redis instance, and Sequin server.

1

Create directory and start services

  1. Download sequin-docker-compose.zip.
  2. Unzip the file.
  3. Navigate to the unzipped directory and start the services:
cd sequin-docker-compose && docker compose up -d
2

Verify services are running

Check that Sequin is running using docker ps:

docker ps

You should see output like the following:

CONTAINER ID   IMAGE                                  COMMAND                  CREATED          STATUS                    PORTS                                                 NAMES
b21f5eb8e6aa   sequin/sequin:latest                   "/scripts/start_comm…"   15 seconds ago   Up 2 seconds              4000/tcp, 0.0.0.0:7376->7376/tcp, :::7376->7376/tcp   sequin-sequin-1
34ee4e39468e   grafana/grafana                        "/run.sh"                15 seconds ago   Up 14 seconds             0.0.0.0:3000->3000/tcp, :::3000->3000/tcp             sequin-sequin_grafana-1
01b006a7f300   prom/prometheus                        "/bin/prometheus --c…"   16 seconds ago   Up 15 seconds             0.0.0.0:9090->9090/tcp, :::9090->9090/tcp             sequin-sequin_prometheus-1
b0b509e37837   postgres:16                            "docker-entrypoint.s…"   16 seconds ago   Up 15 seconds (healthy)   0.0.0.0:7377->5432/tcp, [::]:7377->5432/tcp           sequin-sequin_postgres-1
4438297985da   redis:7                                "docker-entrypoint.s…"   16 seconds ago   Up 15 seconds             0.0.0.0:7378->6379/tcp, [::]:7378->6379/tcp           sequin-sequin_redis-1

All three containers should be up and running (status: Up).

3

Login to Sequin

Open your browser and navigate to http://localhost:7376.

Sign in with the default credentials:

  • Username: admin@sequinstream.com
  • Password: sequinpassword!
5

View metrics in Grafana

Sequin exports various metrics in Prometheus format.

Using the Grafana service from Docker Compose, you can view our example dashboard here.

Sign in with Grafana’s default credentials:

  • Username: admin
  • Password: admin

Using your own database

Using existing Postgres

Sequin uses a Postgres database for configuration and to assist with its change data capture process.

If you have an existing Postgres database you want Sequin to use for config, modify your docker-compose.yaml:

  1. Remove the postgres service section
  2. Update the Sequin service configuration:
services:
  sequin:
    environment:
      - PG_PORT=<port>
      - PG_HOSTNAME=<hostname>
      - PG_DATABASE=<database>
      - PG_USERNAME=<username>
      - PG_PASSWORD=<password>

Using existing Redis

Sequin uses Redis to assist with its change data capture process.

If you have an existing Redis instance:

  1. Remove the redis service section
  2. Update the Sequin service configuration:
services:
  sequin:
    environment:
      - REDIS_URL=<url>

Adding to an existing project

To add Sequin to an existing project’s Docker Compose file, add a sequin service:

services:
  ...
  sequin:
    image: sequin/sequin:latest
    ports:
      - "7376:7376"
    environment:
      - PG_PORT=<port>
      - PG_HOSTNAME=postgres
      - PG_DATABASE=sequin
      - PG_USERNAME=postgres
      - PG_PASSWORD=postgres
      - REDIS_URL=<url>
      - SECRET_KEY_BASE=wDPLYus0pvD6qJhKJICO4dauYPXfO/Yl782Zjtpew5qRBDp7CZvbWtQmY0eB13If
      - VAULT_KEY=2Sig69bIpuSm2kv0VQfDekET2qy8qUZGI8v3/h3ASiY=
    depends_on:
      - postgres
      - redis

Preparing for production

For more configuration options and steps for deploying to production, see the Configuration Reference.