BARTIS.DEV
DOCS/hub/Configuration

Hub Configuration

The Hub manages the state of your infrastructure and provides the API.

Core Settings:

  • PORT: HTTP port for the Web UI and API (Default: :4000).
  • INTERNAL_LINK_PORT: Port where the embedded internal agent listens (Default: :9001).
  • LICENSE: Your Dylaris License Key.
  • HEADLESS: Set to true to disable the Web UI (API Only mode). Useful for integrations.

Database Configuration:

  • DB_TYPE: Select the database engine. Options: sqlite (Default) or postgres.
  • DB_FILE: Path to the SQLite database file (Default: hub.db). Only used if DB_TYPE is sqlite.
  • DB_DSN: Connection string for PostgreSQL. Only used if DB_TYPE is postgres.
    • Standard: host=localhost user=dylaris password=secret dbname=hub port=5432 sslmode=disable
    • With Nexus/TLS: host=nexus-ip ... sslmode=require (Use require if connecting via a TLS tunnel)

Security & Stateless Mode:

  • JWT_SECRET: A 64-byte hex string used to sign API tokens. Critical for stateless setups (Docker/K8s). If not set, a random key is generated on startup (logging out users on restart).

Redis Configuration (Optional): Required for High Availability (HA) or managing multiple Gates.

  • REDIS_ADDR: Address of the Redis server (e.g., 127.0.0.1:6379).
  • REDIS_USER: Redis ACL Username (Optional).
  • REDIS_PASS: Redis Password (Optional).
  • REDIS_DB: Redis Database Index (Default: 0).
  • REDIS_USE_TLS: Set to true to enable TLS (Required if connecting via Nexus).
ID: 11LAST UPDATED: 3/1/2026