Skip to content

server

The server section controls where the gateway listens and how long it keeps HTTP reads/writes open.

Fields

Field Type Default Notes
host string 0.0.0.0 Bind address
port integer 8080 Public HTTP port
read_timeout duration 30s Max time to read the request
write_timeout duration 0s 0s means no explicit write timeout
idle_timeout duration 60s Keep-alive idle timeout

Example

server:
  host: "0.0.0.0"
  port: 8080
  read_timeout: 30s
  write_timeout: 0s
  idle_timeout: 60s

Practical guidance

  • Keep write_timeout: 0s if you expect long streaming responses.
  • Change port if the gateway sits beside another local service that already uses 8080.
  • Changes to this section still require a process restart; the gateway warns on reload but does not rebind the listener live.
  • Most teams can leave this section at defaults and focus on providers plus routing first.