Skip to content
Talk to our solutions team

Error Codes

The gateway returns standard HTTP statuses at the edge:

HTTPCondition
400The request host matches no domainmaps entry
403kisai-auth rejected the request and no loginurl is configured
302 / 307Auth redirect to loginurl, or an entrypoint/endpoint redirect
404No route/endpoint matched the path (static servers honor notfoundpath)
429A rate-limit middleware tripped
502 / 503 / 504Backend error / unavailable / timeout

TLS: if ACME issuance fails, the gateway serves its self-signed default certificate rather than failing the listener.

These are returned at boot or on a config reload; a failed reload keeps the last-known-good config live.

CodeMeaning
gateway-sd-watcher-invalid-configThe service-discovery watcher config is invalid
gateway-invalid-tls-options-configA tlsoptions block is malformed
gateway-invalid-tls-options-not-foundA route references a tlsoptions name that isn’t defined
gateway-invalid-internal-portLegacy listener mode requires a valid internal.port
gateway-invalid-or-empty-entry-pointAn entrypoint has no name
gateway-invalid-or-empty-backendA backend has no name or URLs

Additional reload failures — duplicate names, unresolved route→domainmap/endpoint/backend references, unknown certresolver or extramiddlewares, and writes to protected passthrough paths — abort the reload with a message naming the offender.

See also Operations → Failure modes.