firewalld.helper - firewalld helper configuration files


A firewalld helper configuration file provides the information of a helper entry for firewalld. The most important configuration options are ports, family and module.

This example configuration file shows the structure of a helper configuration file:

<?xml version="1.0" encoding="utf-8"?>
<helper module="nf_conntrack_module" [family="ipv4|ipv6"]>
  <port portid[-portid]" protocol="tcp|udp|sctp|dccp"/>

The config can contain these tags and attributes. Some of them are mandatory, others optional.

The mandatory helper start and end tag defines the helper. This tag can only be used once in a helper configuration file. There is one mandatory and also optional attributes for helper:


The mandatory module of the helper. This is one of the netfilter conntrack helper modules. The name starts with nf_conntrack_.


The optional family of the helper. This can be one of these ipv types: ipv4 or ipv6. If the family is not specified, then the helper is usable for IPv4 and IPv6.


To give the helper a version.

Is an optional start and end tag and is used to give a helper a more readable name.

Is an optional start and end tag to have a description for a helper.

Is an mandatory empty-element tag and can be used several times to have more than one port entry. All attributes of a port entry are mandatory:


The port string can be a single port number or a port range portid-portid or also empty to match a protocol only.


The protocol value can either be tcp, udp, sctp or dccp.

firewall-applet(1), firewalld(1), firewall-cmd(1), firewall-config(1), firewalld.conf(5),, firewalld.dbus(5), firewalld.icmptype(5), firewall-offline-cmd(1), firewalld.richlanguage(5), firewalld.service(5),, firewalld.zones(5), firewalld.policy(5), firewalld.policies(5), firewalld.ipset(5), firewalld.helper(5)

firewalld home page:

Thomas Woerner <>


Jiri Popelka <>


Eric Garver <>

firewalld 2.2.0