Web Server
Web Server settings
Base URL
Base URL is the URL Aidbox is available at. It consists of scheme (HTTP, HTTPS), domain, port (optional) and URL path (optional). Trailing slash is not allowed.
| ID | web.base-url |
| Type | String |
| Default value | (no default) |
| Environment variable | BOX_WEB_BASE_URL |
| Deprecated environment variables | AIDBOX_BASE_URL |
| Sensitive | false — value will be visible in plaintext in Admin UI |
| Set via | Admin UI → Settings Environment variables |
| Hot reload | false — setting requires system restart |
Web server port
Web server port that Aidbox listens on.
| ID | web.port |
| Type | Int |
| Default value | 8080 |
| Environment variable | BOX_WEB_PORT |
| Deprecated environment variables | AIDBOX_PORT |
| Sensitive | false — value will be visible in plaintext in Admin UI |
| Set via | Admin UI → Settings Environment variables |
| Hot reload | false — setting requires system restart |
Web thread count
The number of web server workers in Aidbox. The number of workers determines how many concurrent web requests Aidbox can handle.
| ID | web.thread |
| Type | Int |
| Default value | 8 |
| Environment variable | BOX_WEB_THREAD |
| Sensitive | false — value will be visible in plaintext in Admin UI |
| Set via | Admin UI → Settings Environment variables |
| Hot reload | false — setting requires system restart |
HTTP initial line max length
Length limit for HTTP initial line and per header length, 414 (Request-URI Too Long) will be returned if exceeding this limit.
| ID | web.max-line |
| Type | Int |
| Default value | 8192 |
| Environment variable | BOX_WEB_MAX_LINE |
| Deprecated environment variables | BOX_WEB_MAX__LINE |
| Sensitive | false — value will be visible in plaintext in Admin UI |
| Set via | Admin UI → Settings Environment variables |
| Hot reload | false — setting requires system restart |
Request max body size
Maximum size of the request body in bytes.
| ID | web.max-body |
| Type | Int |
| Default value | 20971520 |
| Environment variable | BOX_WEB_MAX_BODY |
| Deprecated environment variables | BOX_WEB_MAX__BODY |
| Sensitive | false — value will be visible in plaintext in Admin UI |
| Set via | Admin UI → Settings Environment variables |
| Hot reload | false — setting requires system restart |
Last updated 2025-07-15T00:23:16Z