---
name: "openvpn3-admin-netcfg-service"
section: "8"
platform: "linux"
package: "openvpn3-client"
version: "24.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/openvpn3-admin-netcfg-service"
---

# openvpn3-admin-netcfg-service(8)

OpenVPN 3 Linux Administration - Network Configuration Service

## NAME

openvpn3-admin-netcfg-service - OpenVPN 3 Linux Administration - Network Configuration Service

## SYNOPSIS

```
openvpn3-admin netcfg-service [OPTIONS]
openvpn3-admin netcfg-service -h | --help
```

## DESCRIPTION

This is the management interface for the openvpn3-service-netcfg service, with the net.openvpn.v3.netcfg D-Bus service name.

## OPTIONS

- **-h, --help**

  Print  usage and help details to the terminal

- **--config-show**

  Shows the contents of the configuration file used by [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md).

- **--config-set**

  Modifies a configuration setting in the configuration file. Changing the configuration file will require the [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) process to be restarted before they become active.  This option requires two arguments: *CONFIG-NAME* and *CONFIG-VALUE*.  Valid *CONFIG-NAMEs* are:

  - **log-level**

    Defines the default log-level to use when [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) starts.  Valid values are integers between **0** and **6**.

  - **log-file**

    Sets the log destination for log events.  See the **--log-file** option in the man page to [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) for details.

  - **idle-exit**

    Sets the automatic idle shut down time-out.  See the **--idle-exit** option in the man page to [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) for details.

  - **resolv-conf**

    Defines which **resolv.conf** file should be used for DNS resolver configuration.  See the **--resolv-conf** option in the man page to [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) for details.

  - **systemd-resolved**

    Configures the DNS resolver configuration to use [**systemd-resolved**(8)](/systemd-resolved/8.md).  See the **--systemd-resolved** option in the man page to [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) for details.  To activate this feature, the *COFIG-VALUE* must be **1** or **yes**.

  - **redirect-method**

    Configures the host route/redirect method to use to access the VPN server when **--redirect-gateway** is used.  See the **--redirect-method** option in the man page to [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) for details.  Valid *CONFIG-VALUEs* are: **host-route**, **bind-device** or **none**.

  - **set-somark**

    Configures the Netfilter SO\_MARK value to use for OpenVPN traffic.  See the **--redirect-method** option in the man page to [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md) for details.

- **--config-unset**

  Similar to **--config-set** but removes a setting from the configuration file.

- **--list-subscribers**

  Lists all services which has been granted a subscription for NetworkChange signals and which change types they have requested a notification for.  These signals are sent each time a virtual network adapter is created, modified or destroyed, including DNS changes.

- **--unsubscribe** *DBUS-UNIQUE-NAME*

  This can forcefully unsubscribe a service from receiving NetworkChange signals.  The argument must be the unique D-Bus name (typically **:1.xxxx** where **x** denotes an integer).

## SEE ALSO

[**openvpn3**(1)](/openvpn3/1.md) [**openvpn3-service-netcfg**(8)](/openvpn3-service-netcfg/8.md)