Skip to Content
Reference ImplementationsATL-ServerConfiguration

Configuration

Environment variables and CLI flags for atl-server.

All settings can be set via CLI flags or environment variables (same names).

Core settings

  • ATL_ROLE: standalone | node | sequencer
  • ATL_SERVER_HOST: HTTP bind host (default 127.0.0.1)
  • ATL_SERVER_PORT: HTTP bind port (default 3000)
  • ATL_DATABASE_PATH: path to database directory/file (default ./atl.db)
  • ATL_SIGNING_KEY_PATH: path to 32-byte Ed25519 seed file (required for standalone and sequencer)
  • ATL_BASE_URL: external base URL used to generate upgrade_url in receipts (defaults to http://{host}:{port})
  • ATL_LOG_LEVEL: tracing filter (default info)

Access control

If set, all /v1/* endpoints require Authorization: Bearer <token>.

  • ATL_ACCESS_TOKENS: comma-separated tokens (example: tokenA,tokenB)

Tree identity

Tree UUID controls the log instance identity (origin ID is derived from it).

  • ATL_TREE_UUID: optional UUID; if not set, the server persists a generated UUID under {ATL_DATABASE_PATH}/tree_uuid

gRPC (Node/Sequencer)

Sequencer gRPC server:

  • ATL_GRPC_PORT: gRPC listen port in sequencer mode (default 50051)
  • ATL_SEQUENCER_TOKEN: shared secret required by Node to call Sequencer (recommended)

Node gRPC client:

  • ATL_SEQUENCER_URL: Sequencer endpoint (default http://localhost:50051)
  • ATL_SEQUENCER_TOKEN: shared secret (must match Sequencer)
  • ATL_GRPC_KEEP_ALIVE_SECS (default 30)
  • ATL_GRPC_RETRY_COUNT (default 3)
  • ATL_GRPC_RETRY_BACKOFF_MS (default 100)
  • ATL_GRPC_CONCURRENCY_LIMIT (default 1000)

Background jobs

  • ATL_BACKGROUND_DISABLED: true/1 to disable all jobs

Tree closer (controls when trees are closed and become eligible for Super-Tree / OTS):

  • ATL_TREE_CLOSE_INTERVAL_SECS (default 60)
  • ATL_TREE_LIFETIME_SECS (default 3600)

TSA (RFC 3161) job:

  • ATL_TSA_URLS: comma-separated list (default https://freetsa.org/tsr)
  • ATL_TSA_TIMEOUT_MS (default 5000)
  • ATL_TSA_INTERVAL_SECS (default 60)
  • ATL_TSA_JOB_BATCH_SIZE (default 100)
  • ATL_TSA_ACTIVE_INTERVAL_SECS (default 60)

OTS (Bitcoin OpenTimestamps) job:

  • ATL_OTS_POLL_INTERVAL_SECS (default 600)
  • ATL_OTS_UPGRADE_BATCH_SIZE (default 100)

Sequencer tuning

  • ATL_BATCH_SIZE (default 10000)
  • ATL_BATCH_TIMEOUT_MS (default 100)
  • ATL_BUFFER_SIZE (default 100000)
  • ATL_BATCH_RETRY_COUNT (default 3)
  • ATL_BATCH_RETRY_BASE_MS (default 10)
  • ATL_SYNC_MODE: true/1 to bypass batching (default false)
Last updated on
InstallationAPI Reference