#Enterprise

enterprise.conf is the base URL the API uses when it builds callback, well-known, and self-referential links. It is independent of the listen address in web.conf.

#Example File

# walt.id Enterprise Service
# Base configuration

# Base domain of this service, e.g. `waltid.cloud`
baseDomain = "enterprise.localhost"
baseSsl = false
basePort = 3000

# corsAllowedHosts = ["abc.enterprise.waltid.dev", "xyz.enterprise.waltid.dev"]

Behind a reverse proxy that terminates TLS on port 80 or 443, set basePort to the public port, not the container listen port. The Enterprise quickstart uses basePort = 80 because Caddy owns enterprise.localhost:80 and proxies /v1, /v2, /auth, and /.well-known to the API.

#Fields

#baseDomain

String — Domain suffix used to build organization hostnames, for example {organizationId}.enterprise.localhost.

#baseSsl

Boolean — When true (the code default if omitted), generated URLs use https. Set false for local HTTP.

#basePort

Integer, optional — Port included in generated public URLs. Omit it to use the protocol default (443 for HTTPS, 80 for HTTP). Set it when the public URL is not on that default, for example 3000 when the API is reached directly.

#corsAllowedHosts

Array of strings, optional — Extra Origin hosts allowed by CORS, in addition to the organization hosts derived from baseDomain. Default is an empty list.