2026-08-11 11:22:55 -04:00
---
# Code generated by make gen. DO NOT EDIT.
2026-09-28 15:44:10 -04:00
title : "`coder agent-firewall`"
2026-10-20 18:51:44 -04:00
description : Network isolation tool for monitoring and restricting HTTP/HTTPS requests.
2026-08-11 11:22:55 -04:00
---
2026-01-23 12:56:36 -05:00
<!-- DO NOT EDIT | GENERATED CONTENT -->
Network isolation tool for monitoring and restricting HTTP/HTTPS requests
## Usage
```console
2026-06-04 11:14:36 +02:00
coder agent-firewall [flags] [args...]
2026-01-23 12:56:36 -05:00
```
## Description
```console
boundary creates an isolated network environment for target processes, intercepting HTTP/HTTPS traffic through a transparent proxy that enforces user-defined allow rules.
```
## Options
### --config
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|-------------------------------|
| Type | <code>yaml-config-path</code> |
| Environment | <code>$BOUNDARY_CONFIG</code> |
Path to YAML config file.
### --allow
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|------------------------------|
| Type | <code>string</code> |
| Environment | <code>$BOUNDARY_ALLOW</code> |
Allow rule (repeatable). These are merged with allowlist from config file. Format: "pattern" or "METHOD[,METHOD] pattern".
### --log-level
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|----------------------------------|
| Type | <code>string</code> |
| Environment | <code>$BOUNDARY_LOG_LEVEL</code> |
| YAML | <code>log_level</code> |
| Default | <code>warn</code> |
Set log level (error, warn, info, debug).
### --log-dir
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|--------------------------------|
| Type | <code>string</code> |
| Environment | <code>$BOUNDARY_LOG_DIR</code> |
| YAML | <code>log_dir</code> |
Set a directory to write logs to rather than stderr.
### --proxy-port
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|--------------------------|
| Type | <code>int</code> |
| Environment | <code>$PROXY_PORT</code> |
| YAML | <code>proxy_port</code> |
| Default | <code>8080</code> |
Set a port for HTTP proxy.
### --pprof
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|------------------------------|
| Type | <code>bool</code> |
| Environment | <code>$BOUNDARY_PPROF</code> |
| YAML | <code>pprof_enabled</code> |
Enable pprof profiling server.
### --pprof-port
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|-----------------------------------|
| Type | <code>int</code> |
| Environment | <code>$BOUNDARY_PPROF_PORT</code> |
| YAML | <code>pprof_port</code> |
| Default | <code>6060</code> |
Set port for pprof profiling server.
### --jail-type
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|----------------------------------|
| Type | <code>string</code> |
| Environment | <code>$BOUNDARY_JAIL_TYPE</code> |
| YAML | <code>jail_type</code> |
| Default | <code>nsjail</code> |
Jail type to use for network isolation. Options: nsjail (default), landjail.
2026-02-06 09:12:14 -05:00
### --use-real-dns
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-02-06 09:12:14 -05:00
|-------------|-------------------------------------|
| Type | <code>bool</code> |
| Environment | <code>$BOUNDARY_USE_REAL_DNS</code> |
| YAML | <code>use_real_dns</code> |
Use real DNS in the jail instead of the dummy DNS (allows DNS exfiltration). Default: false.
2026-02-24 11:33:37 -07:00
### --no-user-namespace
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-02-24 11:33:37 -07:00
|-------------|------------------------------------------|
| Type | <code>bool</code> |
| Environment | <code>$BOUNDARY_NO_USER_NAMESPACE</code> |
| YAML | <code>no_user_namespace</code> |
Do not create a user namespace. Use in restricted environments that disallow user NS (e.g. Bottlerocket in EKS auto-mode).
2026-01-23 12:56:36 -05:00
### --disable-audit-logs
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|----------------------------------|
| Type | <code>bool</code> |
| Environment | <code>$DISABLE_AUDIT_LOGS</code> |
| YAML | <code>disable_audit_logs</code> |
Disable sending of audit logs to the workspace agent when set to true.
### --log-proxy-socket-path
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-01-23 12:56:36 -05:00
|-------------|----------------------------------------------------------|
| Type | <code>string</code> |
| Environment | <code>$CODER_AGENT_BOUNDARY_LOG_PROXY_SOCKET_PATH</code> |
| Default | <code>/tmp/boundary-audit.sock</code> |
Path to the socket where the boundary log proxy server listens for audit logs.
### --version
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|-------------------|
| Type | <code>bool</code> |
2026-01-23 12:56:36 -05:00
Print version information and exit.
2026-07-07 12:42:01 +02:00
### --enable-session-correlation
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-07-07 12:42:01 +02:00
|-------------|----------------------------------------------------|
| Type | <code>bool</code> |
| Environment | <code>$BOUNDARY_SESSION_CORRELATION_ENABLED</code> |
| YAML | <code>session_correlation_enabled</code> |
Enable session correlation header injection. When no inject targets are configured, the target is auto-derived from CODER_AGENT_URL (set automatically inside Coder workspaces). Disable for deployments without Coder AI Gateway in front.
### --session-id-inject-target
2026-10-21 10:58:04 -07:00
| Property | Value |
2026-07-07 12:42:01 +02:00
|-------------|-------------------------------------------------|
| Type | <code>string</code> |
| Environment | <code>$BOUNDARY_SESSION_ID_INJECT_TARGET</code> |
2026-09-29 17:00:27 +02:00
Inject target for session correlation headers. Repeat the flag once per target; each value describes exactly one target. Format: `domain=<host> [path=<glob>]` . Example: `--session-id-inject-target "domain=prod.coder.com path=/api/v2/aibridge/*"` .