CloudConnexa: How to Install and Configure OpenVPN 2 on a Docker Container as a Host Connector

Deploying a Host Connector on a Docker container doesn’t support installing the OpenVPN 3 Linux client. To use a Docker container as a Host Connector for CloudConnexa, install the open-source OpenVPN client, OpenVPN 2.

This example uses an Ubuntu 24.04 Docker container.

How to install and configure OpenVPN2 as a Host Connector

Step 1: Download and transfer the Host Connector connection profile

1. Sign in to your CloudConnexa Portal.
2. Click Networks > Hosts.
3. Click the name of the desired Hosts.
4. Click the Connectors tab for the Hosts.
5. Click the Deploy drop-down.
6. Click Download Profile in .ovpn format.
   
7. Transfer the downloaded .ovpn connection profile to your Docker Server using an SCP program such as WinSCP.
8. Transfer the  .ovpn connection profile to your Docker Container using the docker cp command.

Step 2: Access the Docker Container running in Ubuntu 24.04

Use the following command to access the Docker container from the Docker server:

sudo docker exec -it connector-ubuntu-node /bin/bash

Step 3: Install OpenVPN2

Install the open-source OpenVPN client, OpenVPN 2:

apt install openvpn -y

Step 4: Verify the OpenVPN2 installation

Verify the installed OpenVPN 2 version:

openvpn --version

Step 5: Configure OpenVPN2 to start automatically on boot

1. Transfer the .ovpn connection profile to the path /etc/openvpn/client and rename it to a client.conf filename:

   cp connector01_singapore.ovpn /etc/openvpn/client/client.conf

2. Enable the OpenVPN2 service to run on boot:

   systemctl enable openvpn-client@client.service

3. Restart the OpenVPN2 client service:

   systemctl restart openvpn-client@client.service

Conclusion

Your Docker Container should now automatically connect to CloudConnexa as a HostsConnector using OpenVPN2 upon boot.

If you have any more questions, please submit a support ticket.