Quick start

The fastest way to try Atlas is with Docker Compose.

Docker

git clone https://github.com/AllanGallop/Atlas.git
cd Atlas
docker compose up --build

Service	URL
Control API	http://localhost:8090
Postgres	localhost:5433
Redis	localhost:6380
NATS	localhost:4223
NATS monitor	http://localhost:8223

Seed a domain

curl -X POST http://localhost:8090/domains \
  -H "Content-Type: application/json" \
  -d '{"domains": ["example.com"], "collectors": ["ct", "rdap", "dns"]}'

Query intelligence

curl http://localhost:8090/domains/example.com
curl http://localhost:8090/domains/example.com/subdomains
curl http://localhost:8090/domains/example.com/pivots
curl http://localhost:8090/pivots/nameserver/ns1.example.net

Start CT backfill

Populate the local CT store before subdomain lookups return useful results:

curl -X POST http://localhost:8090/ct/backfill \
  -H "Content-Type: application/json" \
  -d '{"target_tlds": ["com", "io", "co.uk"], "include_readonly": true}'

Monitor progress:

curl http://localhost:8090/ct/status
curl http://localhost:8090/metrics

Start a campaign

curl -X POST http://localhost:8090/campaigns \
  -H "Content-Type: application/json" \
  -d '{
    "seeds": ["example.com"],
    "collectors": ["dns", "http", "tls", "ct", "rdap"],
    "limits": { "max_depth": 2, "max_entities": 5000 }
  }'

Poll progress:

curl http://localhost:8090/campaigns/{campaign_id}/progress

End-to-end test

docker compose up -d --build
bash tests/e2e.sh

Scale workers

docker compose up -d --scale worker=4

See Architecture for how jobs flow through NATS, Redis, and Postgres.