Files
balena-supervisor/docs/firewall.md
Christina Ying Wang caed4dcca0 Clarify firewall docs on behavior with host network containers
Change-type: patch
Signed-off-by: Christina Ying Wang <christina@balena.io>
2025-03-25 13:10:52 -07:00

1.4 KiB

Firewall

Starting with Supervisor v11.9.1, the balena Supervisor comes with the ability to control the device's firewall through the iptables package. The Supervisor manipulates the filter table to control network traffic.

Firewall Modes

To switch between firewall modes, the HOST_FIREWALL_MODE (with BALENA_ or legacy RESIN_ prefix) configuration variable may be defined on a fleet or device level through the dashboard, and has three valid settings: on, off, and auto, with off being the default mode.

[!NOTE] Configuration variables defined in the dashboard will not apply to devices in local mode.

Mode Description
on Only traffic for core services provided by balena are allowed. Any other ports, including those used by containers with host networking, are blocked unless explicitly configured.
off All network traffic is allowed.
auto If there are host network services, behaves as if FIREWALL_MODE = on. If there aren't host network services, behaves as if FIREWALL_MODE = off.

Issues

Before v14.9.2 manually-set firewall rules to the filter table will be overwritten by the Supervisor (related issue). Please update your supervisor if you observe this behavior.