# networkNamespace

This is the name of the network namespace.

This parameter applies to omuxsock: Unix sockets Output Module.

Name:

  networkNamespace

Scope:

  module, action

Type:

  string

Default:

  module=none, action=none

Required?:

  no

Introduced:

  v8.2512

## Description

Sets a name for the `networknamespace` property. If no network namespace is set, the local (startup) network namespace is used by default. The namespace must be created (and interfaces appropriately configured) prior to starting rsyslogd. rsyslogd must be explicitly built with namespace support, otherwise an error will occur when the namespace is subsequently used against an input stream. The underlying operating system must also support the setns() system call, otherwise the input instance will be unable to bind within the given namespace.

Note

The network namespace should exist as a named file under /var/run/netns/. In particular, the namespace must be created prior to starting rsyslogd. Rsyslogd must be explicitly built with namespace support, otherwise an error will occur when the namespace is subsequently used by an output action. The underlying operating system must also support the setns() system call, otherwise the output action will be unable to operate within the given namespace.

## Module usage

If networkNamespace is set at the module level, then it becomes the default networkNamespace setting for all omuxsock actions.

    module(load="omuxsock" networkNamespace="management")

## Action usage

> An empty string (`""`) can be used at the action level to override a module level `networkNamespace` setting and explicitly use the startup network namespace for that action.

    action(type="omuxsock" socketName="/tmp/example" networkNamespace="routing")
    action(type="omuxsock" socketName="rsyslogd.msg.handler" networkNamespace="")

## See also

See also omuxsock: Unix sockets Output Module.

Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.