Skip to content

OpenVPN Connector Setup - Simple OpenVPN Cloud configuration (Clone of https://codeberg.org/openvpn/openvpn-connector-setup/)

License

Notifications You must be signed in to change notification settings

OpenVPN/openvpn-connector-setup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

openvpn-connector-setup

The openvpn-connector-setup tool used to configure the OpenVPN 3 Linux client to connect as a connector in an CloudConnexa™ managed environment.

Before this tool can be used, a connector must already be configured in the CloudConnexa™ portal. As part of this step, the web portal will provide you with a setup token value. This token is mandatory and needed for this tool to configure the host it is being run on.

What does this tool do?

By default this tool will:

  • Download a VPN client configuration profile
  • Configure this VPN profile to be used by openvpn3-autoload at boot time
  • Enable and start the openvpn3-autoload.service systemd unit. This will connect this host to CloudConnexa instantly and ensure it connects automatically each time the host is rebooted.

How to use it

First, configure a new connector in the CloudConnexa portal. When the portal provides you with a setup token, run the script:

[root@host: ~] # openvpn-connector-setup
CloudConnexa™ Connector Setup

This utility is used to configure this host as an OpenVPN Connector
for CloudConnexa.  Before this utility can be run, you must have
configured a connector in the CloudConnexa web portal where an setup
token is provided.  This token is used by this utility to download the
proper VPN configuration profile and complete the configuration.

Enter setup token: <PROVIDED_TOKEN_VALUE>

Downloading CloudConnexa connector profile ... Done
Importing VPN configuration profile "CloudConnexa" ... Done
Enabling [email protected] during boot ... Done
Starting [email protected] ... Done
[root@host: ~] #

At this point everything should be configured and a VPN connection is established to the CloudConnexa service.

It is also possible to provide the setup token on the command line:

[root@host: ~] # openvpn-connector-setup --token <PROVIDED_TOKEN_VALUE>

Options

-h, --help show a help message and exit
--mode MODE Valid values: systemd-unit (default), autoload - uses openvpn3-autoload to start the connection at boot
--token TOKEN_VALUE This value is provided by the CloudConnexa web portal.
--name NAME Configuration profile name to use. Default: "CloudConnexa"
--force Overwrite existing imported profiles
--autoload-file-prefix PREFIX Configuration filename to use in the /etc/openvpn3/autoload/ directory. Default: CloudConnexa
--no-start Do not configure the profile to start at boot
--dco Use the OpenVPN Data Channel Offload (DCO) by default (unavailable with autoload mode)

Manage VPN configurations and sessions

To further manage the VPN configuration and session see the OpenVPN 3 Linux documentation, in particular these man pages:

Project details

This is an Open Source project and the code is published in three different git repositories

Report issues using Codeberg.

Copyright

Copyright (C) OpenVPN Inc. This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3 License.