openvpn

OpenVPN Client (openvpn)

Installs OpenVPN client for connecting to VPN networks

Example Usage

"features": {
    "ghcr.io/duplocloud/devcontainers/openvpn:1": {}
}

Options

Options Id	Description	Type	Default Value
enabled	Enable the OpenVPN feature. Set to false to skip installation completely.	boolean	true
autoConnect	Automatically initialize and connect to VPN on container start. Set to false to only install the OpenVPN client.	boolean	true
configDir	Directory where OpenVPN configuration files will be stored. If empty, defaults to $XDG_CONFIG_HOME/openvpn or $HOME/.config/openvpn.	string	-

OpenVPN CLI Feature

Required Configuration

This feature automatically adds NET_ADMIN and NET_RAW capabilities. However, you must manually add the TUN device to your devcontainer.json:

"runArgs": ["--device=/dev/net/tun"]

This is required because the devcontainer features spec does not support adding devices directly.

Full Example

{
  "features": {
    "ghcr.io/duplocloud/devcontainers/openvpn:1": {}
  },
  "runArgs": ["--device=/dev/net/tun"]
}

Configuration Directory

By default, OpenVPN configuration files are stored in:

• $XDG_CONFIG_HOME/openvpn if XDG_CONFIG_HOME is set
• $HOME/.config/openvpn otherwise

You can customize this location using the configDir option:

{
  "features": {
    "ghcr.io/duplocloud/devcontainers/openvpn:1": {
      "configDir": "/custom/path/to/openvpn"
    }
  }
}

This is useful when you need to store configuration in a specific location for persistence or access control reasons.

---

Note: This file was auto-generated from the devcontainer-feature.json. Add additional notes to a NOTES.md.