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
.
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.
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.
User removal
To remove a user, first click the Revoke button of the desired user. This action will revoke the user's certificates.
Next, click the Delete button to completely remove the user.
If you haven't deleted the user yet, but only clicked Revoke, the user can be restored using the Unrevoke button.
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/Mac | Android | iOS |
---|---|---|
Software installed
Name | License |
---|---|
OpenVPN | GNU GPL |
ovpn-admin | Apache License 2.0 |
Caddy | Apache License 2.0 |
Useful links
For more information about the installed packages, please refer to their official documentation: