Self-hosting

Enterprise customers can run Tellr inside their own VPC. The same docker-compose used in development scales to a single-node production install with Postgres 16 and Redis 7.

Requirements

• Postgres 16 with pgcrypto, pg_trgm, btree_gin.
• Redis 7.
• Node 20+ for the API and worker, Go 1.22+ for the TLS proxy.
• A TLS-terminating load balancer (or our Go proxy at the edge).

Quick start

git clone https://github.com/tellr/tellr
cd tellr
docker compose up -d
psql $DATABASE_URL -f db/migrations/0001_init.sql
pnpm install
pnpm ti:seed
pnpm dev

Threat-intel ingestion

The worker fetches public threat data on a schedule. By default it refreshes Tor exits every 30 minutes, cloud ranges daily, and the disposable email list weekly. Everything is stored in your Postgres — no outbound calls at check time.

Data residency

Because Tellr is one Postgres database and one Redis instance, residency is wherever you host them. EU, US, on-prem, gov-cloud — same image, different infra.