Skip to content

Quick start

This is a quick start guide for TeskaLabs SeaCat Auth, it should get you up to speed swiftly.


Following list contains all prerequisities for a successful deployment of the SeaCat Auth:

Note: This guide is designed for Windows (using WSL2 and Docker), Mac OS (using Docker Desktop) and Linux.

Step 1: Create the deployment directory

We assume in this guide that SeaCat Auth will be deployed into the /opt/site-auth.

Note: We also call the deployment directory a "site".

The structure of a deployment directory:


The SeaCat Auth GitHub repository contains a template of the deployment directory in the ./doc/docker directory. This template of the deployment directory can be also downloaded here.

Step 2: Adjust SeaCat Auth configuration

Step 3: Install Web User Interfaces

  • Install SeaCat Auth Web UI into ./seacat-auth-webui/ from

  • Install SeaCat Web UI into ./seacat-webui/ from

Step 4: Launch SeaCat Auth

Execute docker-compose up -d in the /opt/site-auth directory.

Now SeaCat Auth runs in the so-called provisioning mode. You can use SeaCat Web UI to finish the setup by creating users etc. For that step, please proceed to setting up SeaCat Auth in provisioning mode.

Next steps

Deploying SeaCat Auth with custom hostname and HTTPS

This part of the guide assumes that your server has a proper public domain name.

Custom hostname on localhost

To run SeaCat Auth locally with custom hostname, just add the hostname to /etc/hosts on your machine, for example  auth.test.loc

Since you can't obtain a trusted SSL certificate via ACME challenge for internal hostnames, you need to generate a self-signed SSL certificate:

openssl req -x509 -newkey rsa:4096 -keyout nginx-conf/key.pem -out nginx-conf/cert.pem -days 365 -nodes

Note that self-signed certificates are not trusted, and produce warnings on most devices. They should be only used for development purposes in local environments.