Installation

Run Tzylo Auth CE locally using Docker or source code.

Tzylo Auth CE runs as a standalone authentication service connected to your own database.

The recommended way to run Auth CE is using Docker. This keeps setup minimal and avoids local environment issues.

Recommended: Docker

Run Auth CE using the official Docker image:

Docker run

docker run -p 7200:7200 \
  -e DATABASE_URL="postgresql://user:pass@host:5432/db" \
  -e JWT_SECRET="supersecret" \
  tzylo/auth-ce:latest

Auth CE will start on:

Server URL

http://localhost:7200

Auth CE connects to your database directly. When using a local database from Docker, use host.docker.internal instead of localhost.

Check database connectivity using:

Health check

GET /health/db

A healthy response indicates Auth CE is running and connected to your database.

Local setup is useful for contributors or when customizing the core service.

Clone repository

git clone https://github.com/tzylo/tzylo-auth-ce.git
cd tzylo-auth-ce
pnpm install

.env

JWT_SECRET=your-secret
DATABASE_URL=postgresql://user:pass@localhost:5432/authdb

Start server

pnpm dev