Skip to main content

OVPN Admin

Description

OVPN Admin offers a simple web-based interface to manage users, their certificates and OpenVPN-based routes for accessing private and public resources.

Getting started

OVPN Admin is installed with an image and is automatically enabled when on server boot.

After the image is installed, the OVPN Admin web interface will be available at https://example.com, where example.com is the hostname of your server.

To enter the web-interface use admin login and password, which you can find in a file on the server:

/root/.app_password

To access this file, you will need to log in to the server via SSH. You can connect to the server via SSH:

  • With an SSH key, if this option is enabled before a server is created
  • With the root user password sent by mail when server is activated

Changing domain

If you wish to use your domain or subdomain to access the OVPN Admin web interface, you will need to log on to the server via SSH under the root user and run the command:

add_domain

You will be prompted to enter a domain or subdomain in the format subdomain.example.com.

note

Make sure your domain exists and is pointed to the IPv4 address of your server!

When the script finishes, a Let's Ecnrypt certificate will be issued for the specified domain or subdomain and the web-interface will be available at https://example.com/, where example.com is the previously specified domain (subdomain).

User creation

You can create profiles to connect to the VPN by clicking the Add user button. Alt text

In the opened menu, you will only need to enter a name for the new profile. After creating the user, in the Actions field, click the Download config button to get the configuration file for the connection.
Alt text

User removal

To remove a user, first click the Revoke button of the desired user. This action will revoke the user's certificates.
Alt text

Next, click the Delete button to completely remove the user.
Alt text

If you haven't deleted the user yet, but only clicked Revoke, the user can be restored using the Unrevoke button.
Alt text

Getting client application

To work with OpenVPN on your device, be it a PC or a smartphone, you will need to install a client application on it.

For example, you can use the official OpenVPN Connect client, which can be dowloaded at the following links along with the documentation:

PC - Windows/MacAndroidiOS
PC LinkAndroid LinkiOS Link
Android QRQR iOS

Software installed

NameLicense
OpenVPNGNU GPL
ovpn-adminApache License 2.0
CaddyApache License 2.0

For more information about the installed packages, please refer to their official documentation: