Set Up OpenConnect VPN Server (ocserv) on Ubuntu 22.04 with Let’s Encrypt

This tutorial is going to show you how to run your own VPN server by installing OpenConnect VPN server on Ubuntu 22.04. OpenConnect VPN server, aka ocserv, is an open-source implementation of Cisco AnyConnnect VPN protocol, which is widely used in businesses and universities. AnyConnect is an SSL-based VPN protocol that allows individual users to connect to a remote network.

Why Set Up Your Own VPN Server?

  • Maybe you are a VPN service provider or a system administrator, which behooves you to set up our own VPN server.
  • You don’t trust the no-logging policy of VPN service providers, so you go the self-host route.
  • You can use VPN to implement network security policy. For example, if you run your own email server, you can require users to log in only from the IP address of the VPN server by creating an IP address whitelist in the firewall. Thus, your email server is hardened to prevent hacking activities.
  • Perhaps you are just curious to know how VPN server works.

openconnect ubuntu

Features of OpenConnect VPN Server

  • Lightweight and fast. In my test, I can watch YouTube 4K videos with OpenConnect VPN. YouTube is blocked in my country (China).
  • Runs on Linux and most BSD servers.
  • Compatible with Cisco AnyConnect client
  • There are OpenConnect client software for Linux, MacOS, Windows and OpenWRT. For Android and iOS, you can use the Cisco AnyConnect Client.
  • Supports password authentication and certificate authentication
  • Supports RADIUS accounting.
  • Supports virtual hosting (multiple domains).
  • Easy to set up
  • Resistant to deep packet inspection (DPI)

I particularly like the fact that compared to other VPN technologies, it is very easy and convenient for the end-user to use OpenConnect VPN. Whenever I install a Linux distro on my computer and want to quickly unblock websites or hide my IP address, I install OpenConnect client and connect to the server with just two lines of commands:

sudo apt install openconnect

sudo openconnect -b

There is also OpenConnect VPN client for Fedora, RHEL, CentOS, Arch Linux and OpenSUSE. You can easily install it with your package manager.

sudo dnf install openconnect
sudo yum install openconnect
sudo pacman -S openconnect


To follow this tutorial, you will need a VPS (Virtual Private Server) that can access blocked websites freely (Outside of your country or Internet filtering system). I recommend Kamatera VPS, which features:

  • 30 days free trial.
  • Starts at $4/month (1GB RAM)
  • High-performance KVM-based VPS
  • 9 data centers around the world, including United States, Canada, UK, Germany, The Netherlands, Hong Kong, and Isreal.

Follow the tutorial linked below to create your Linux VPS server at Kamatera.

Once you have a VPS running Ubuntu 22.04, follow the instructions below.

You also need a domain name to enable HTTPS for OpenConnect VPN. I registered my domain name from NameCheap because the price is low and they give whois privacy protection free for life.

Step 1: Install OpenConnect VPN Server on Ubuntu 22.04

Log into your Ubuntu 22.04 server. Then use apt to install the ocserv package from the default Ubuntu repository.

sudo apt update
sudo apt install ocserv

Once installed, the OpenConnect VPN server is automatically started. You can check its status with:

systemctl status ocserv

Sample output:

 ocserv.service - OpenConnect SSL VPN server
     Loaded: loaded (/lib/systemd/system/ocserv.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2020-04-12 19:57:08 HKT; 12s ago
       Docs: man:ocserv(8)
   Main PID: 216409 (ocserv-main)
      Tasks: 2 (limit: 9451)
     Memory: 1.6M
     CGroup: /system.slice/ocserv.service
             ├─216409 ocserv-main
             └─216429 ocserv-sm

Hint: If the above command doesn’t quit immediately, you can press the Q key to gain back control of the terminal.

If it’s not running, then you can start it with:

sudo systemctl start ocserv

By default OpenConnect VPN server listens on TCP and UDP port 443. If it’s being used by web server, then the VPN server would probably fail to start. We will see how to change the port in OpenConnect VPN configuration file later.

If there’s a firewall running on your server, then you will need to open port 80 and 443. For example, if you use UFW, then run the following command.

sudo ufw allow 80,443/tcp

Step 2: Install Let’s Encrypt Client (Certbot) on Ubuntu 22.04 Server

The gnutls-bin package installed along with ocserv provides tools to create your own CA and server certificate, but we will obtain and install Let’s Encrypt certificate. The advantage of using Let’s Encrypt certificate is that it’s free, easier to set up and trusted by VPN client software.

Run the following commands to install Let’s Encrypt client (certbot) from the default Ubuntu repository.

sudo apt install certbot

To check the version number, run

certbot --version

Sample output:

certbot 1.21.0

Step 3: Obtain a Trusted TLS Certificate from Let’s Encrypt

I recommend using the standalone or webroot plugin to obtain TLS certificate for ocserv.

Standalone Plugin

If there’s no web server running on your Ubuntu 22.04 server and you want OpenConnect VPN server to use port 443, then you can use the standalone plugin to obtain TLS certificate from Let’s Encrypt. Run the following command. Don’t forget to set A record for your domain name.

sudo certbot certonly --standalone --preferred-challenges http --agree-tos --email [email protected] -d


  • certonly: Obtain a certificate but don’t install it.
  • --standalone: Use the standalone plugin to obtain a certificate
  • --preferred-challenges http: Perform http-01 challenge to validate our domain, which will use port 80.
  • --agree-tos: Agree to Let’s Encrypt terms of service.
  • --email: Email address is used for account registration and recovery.
  • -d: Specify your domain name.

As you can see the from the following screenshot, I successfully obtained the certificate.

ocserv ubuntu 20.04 letsencrypt certbot

Using webroot Plugin

If your Ubuntu 22.04 server has a web server listening on port 80 and 443, then it’s a good idea to use the webroot plugin to obtain a certificate because the webroot plugin works with pretty much every web server and we don’t need to install the certificate in the web server.

First, you need to create a virtual host for


If you are using Apache, then

sudo nano /etc/apache2/sites-available/

And paste the following lines into the file.

<VirtualHost *:80>        

        DocumentRoot /var/www/ocserv

Save and close the file. Then create the web root directory.

sudo mkdir /var/www/ocserv

Set www-data (Apache user) as the owner of the web root.

sudo chown www-data:www-data /var/www/ocserv -R

Enable this virtual host.

sudo a2ensite

Reload Apache for the changes to take effect.

sudo systemctl reload apache2

Once virtual host is created and enabled, run the following command to obtain Let’s Encrypt certificate using webroot plugin.

sudo certbot certonly --webroot --agree-tos --email [email protected] -d -w /var/www/ocserv


If you are using Nginx, then

sudo nano /etc/nginx/conf.d/

Paste the following lines into the file.

server {
      listen 80;

      root /var/www/ocserv/;

      location ~ /.well-known/acme-challenge {
         allow all;

Save and close the file. Then create the web root directory.

sudo mkdir -p /var/www/ocserv

Set www-data (Nginx user) as the owner of the web root.

sudo chown www-data:www-data /var/www/ocserv -R

Reload Nginx for the changes to take effect.

sudo systemctl reload nginx

Once virtual host is created and enabled, run the following command to obtain Let’s Encrypt certificate using webroot plugin.

sudo certbot certonly --webroot --agree-tos --email [email protected] -d -w /var/www/ocserv

Step 4: Edit OpenConnect VPN Server Configuration File

Edit ocserv main configuration file.

sudo nano /etc/ocserv/ocserv.conf

First, we need to configure password authentication. By default, password authentication through PAM (Pluggable Authentication Modules) is enabled, which allows you to use Ubuntu system accounts to login from VPN clients. This behavior can be disabled by commenting out the following line.

auth = "pam[gid-min=1000]"

If we want users to use separate VPN accounts instead of system accounts to login, we need to add the following line to enable password authentication with a password file.

auth = "plain[passwd=/etc/ocserv/ocpasswd]"

After finishing editing this config file, we will see how to use ocpasswd tool to generate the /etc/ocserv/ocpasswd file, which contains a list of usernames and encoded passwords.

Note: Ocserv supports client certificate authentication, but Let’s Encrypt does not issue client certificate. You need to set up your own CA to issue client certificate.

Next, if you don’t want ocserv to use TCP and UDP port 443, then find the following two lines and change the port number. Otherwise leave them alone.

tcp-port = 443
udp-port = 443

Then find the following two lines. We need to change them.

server-cert = /etc/ssl/certs/ssl-cert-snakeoil.pem
server-key = /etc/ssl/private/ssl-cert-snakeoil.key

Replace the default setting with the path of Let’s Encrypt server certificate and server key file.

server-cert = /etc/letsencrypt/live/
server-key = /etc/letsencrypt/live/

Then, set the maximal number of clients. Default is 128. Set to zero for unlimited.

max-clients = 128

Set the number of devices a user is able to log in from at the same time. Default is 2. Set to zero for unlimited.

max-same-clients = 2

By default, keepalive packets are sent every 300 seconds (5 minutes). I prefer to use a short time (30 seconds) to reduce the chance of VPN connection dropout.

keepalive = 30

Next, find the following line. Change false to true to enable MTU discovery.

try-mtu-discovery = false

You can set the time that a client is allowed to stay idle before being disconnected via the following two parameters. If you prefer the client to stay connected indefinitely, then comment out these two parameters.


After that, set the default domain to

default-domain =

The IPv4 network configuration is as follows by default. This will cause problems because many home routers also set the IPv4 network range to

ipv4-network =
ipv4-netmask =

We can use another private IP address range ( to avoid IP address collision, so change the value of ipv4-network to

ipv4-network =

Now uncomment the following line to tunnel all DNS queries via the VPN.

tunnel-all-dns = true

The default DNS resolver addresses are as follows, which is fine.

dns =
dns =

Note: If you are a VPN service provider, then it’s a good practice to run your own DNS resolver on the same server. If there’s a DNS resolver running on the same server, then specify the DNS as

dns = is the IP address of OpenConnect VPN server in the VPN LAN. This will speed up DNS lookups a little bit for clients because the network latency between the VPN server and the DNS resolver is eliminated.

Then comment out all the route parameters (add # symbol at the beginning of the following lines), which will set the server as the default gateway for the clients.

#route =
#route =
#route =
#route = fd00::/8
#route = default

#no-route =

Save and close the file Then restart the VPN server for the changes to take effect.

sudo systemctl restart ocserv

Step 5: Create VPN Accounts

Now use the ocpasswd tool to generate VPN accounts.

sudo ocpasswd -c /etc/ocserv/ocpasswd username

You will be asked to set a password for the user and the information will be saved to /etc/ocserv/ocpasswd file. To reset password, simply run the above command again.

Step 6: Enable IP Forwarding

In order for the VPN server to route packets between VPN clients and the Internet, we need to enable IP forwarding by running the following command.

echo "net.ipv4.ip_forward = 1" | sudo tee /etc/sysctl.d/60-custom.conf

Then apply the changes with the below command. The -p option will load sysctl settings from /etc/sysctl.d/60-custom.conf file. This command will preserve our changes across system reboots.

sudo sysctl -p /etc/sysctl.d/60-custom.conf

Step 7: Configure IP Masquerading in Firewall

We need to set up IP masquerading in the server firewall, so that the server becomes a virtual router for VPN clients. I will use UFW, which is a front end to the iptables firewall. Install UFW on Ubuntu with:

sudo apt install ufw

First, you need to allow SSH traffic.

sudo ufw allow 22/tcp

Then find the name of your server’s main network interface.

ip addr

As you can see, it’s named ens3 on my Ubuntu server.

openconnect-ubuntu 20.04-command-line

To configure IP masquerading, we have to add iptables command in a UFW configuration file.

sudo nano /etc/ufw/before.rules

By default, there are some rules for the filter table. Add the following lines at the end of this file. Replace ens3 with your own network interface name.

# NAT table rules

# End each table with the 'COMMIT' line or these rules won't be processed

In Nano text editor, you can go to the end of the file by pressing Ctrl+W, then pressing Ctrl+V.

ufw masquerade rule ocserv ubuntu

The above lines will append (-A) a rule to the end of of POSTROUTING chain of nat table. It will link your virtual private network with the Internet. And also hide your network from the outside world. So the Internet can only see your VPN server’s IP, but can’t see your VPN client’s IP, just like your home router hides your private home network.

By default, UFW forbids packet forwarding. We can allow forwarding for our private network. Find the ufw-before-forward chain in this file and add the following 3 lines, which will accept packet forwarding if the source IP or destination IP is in the range.

# allow forwarding for trusted network
-A ufw-before-forward -s -j ACCEPT
-A ufw-before-forward -d -j ACCEPT

ufw allow packet fowarding

Save and close the file. Then enable UFW.

sudo ufw enable

If you have enabled UFW before, then you can use systemctl to restart UFW.

sudo systemctl restart ufw

Now if you list the rules in the POSTROUTING chain of the NAT table by using the following command:

sudo iptables -t nat -L POSTROUTING

You can see the Masquerade rule.


It can take some time for UFW to process the firewall rules. If the masquerade rule doesn’t show up, then restart UFW again (sudo systemctl restart ufw).

Step 8: Open Port 443 in Firewall

Run the following command to open TCP and UDP port 443. If you configured a different port for ocserv, then change 443 to your configured port.

sudo ufw allow 443/tcp
sudo ufw allow 443/udp

Now OpenConnect VPN server is ready to accept client connections.

If you run a local DNS Resolver

For those of you who run a local DNS resolver, if you specified as the DNS server for VPN clients, then you must allow VPN clients to connect to port 53 with the following UFW rule.

sudo ufw insert 1 allow in from

You also need to edit the BIND DNS server’s configuration file (/etc/bind/named.conf.options) to allow VPN clients to send recursive DNS queries like below.

allow-recursion {;; };

Then restart BIND.

sudo systemctl restart named

Step 9: Fix Futex Error

Run the following command to check the ocserv systemd journals.

sudo journalctl -eu ocserv

If your server has the following error, you need to install the latest ocserv version to fix the futex error.

The futex facility returned an unexpected error code.

Check your current ocserv version.

ocserv -v

Ubuntu 22.04 repository currently ships with ocserv 1.1.3. It might update ocserv in the future, but right now you need to follow the instructions below to install the latest ocserv version.

Install build dependency packages.

sudo apt install -y git ruby-ronn libbsd-dev libsystemd-dev libpcl-dev libwrap0-dev libgnutls28-dev libev-dev libpam0g-dev liblz4-dev libseccomp-dev libreadline-dev libnl-route-3-dev libkrb5-dev libradcli-dev libcurl4-gnutls-dev libcjose-dev libjansson-dev libprotobuf-c-dev libtalloc-dev libhttp-parser-dev protobuf-c-compiler gperf nuttcp lcov libuid-wrapper libpam-wrapper libnss-wrapper libsocket-wrapper gss-ntlmssp haproxy iputils-ping freeradius gawk gnutls-bin iproute2 yajl-tools tcpdump

Clone the ocserv Git repository.

git clone

Generate configuration scripts.

cd ocserv

autoreconf -fvi

Compile the source code. If you see deprecated warnings, you can ignore them.

./configure && make

Install the binaries.

sudo make install

The files will be install to /usr/loca/bin/ and /usr/local/sbin/. Next, we need to copy the systemd service file.

sudo cp /lib/systemd/system/ocserv.service /etc/systemd/system/ocserv.service

Edit this file.

sudo nano /etc/systemd/system/ocserv.service

Because the compiled version of ocserv binary is located at /usr/local/sbin/ocserv, we need to change

ExecStart=/usr/sbin/ocserv --foreground --pid-file /run/ --config /etc/ocserv/ocserv.conf


ExecStart=/usr/local/sbin/ocserv --foreground --pid-file /run/ --config /etc/ocserv/ocserv.conf

Save and close the file. Then reload systemd.

sudo systemctl daemon-reload

Restart ocserv service.

sudo systemctl restart ocserv

How to Install and Use OpenConnect VPN client on Ubuntu 22.04 Desktop

Run the following command to install OpenConnect VPN command line client on Ubuntu desktop.

sudo apt install openconnect

You can Connect to VPN from the command line like below. -b flag will make it run in the background after connection is established.

sudo openconnect -b

You will be asked to enter VPN username and password. If the connection is successfully established, you will see the following message.

Got CONNECT response: HTTP/1.1 200 CONNECTED
CSTP connected. DPD 90, Keepalive 32400
Connected tun0 as, using SSL
Established DTLS connection (using GnuTLS). Ciphersuite (DTLS1.2)-(RSA)-(AES-256-GCM).

To stop the connection, run:

sudo pkill openconnect

To run the client non-interactively, use the following syntax.

echo -n password | sudo openconnect -b -u username --passwd-on-stdin

If you want to use Network Manager to manage VPN connection, then you also need to install these packages.

sudo apt install network-manager-openconnect network-manager-openconnect-gnome

If you are successfully connected to the VPN server, but your public IP address doesn’t change, that’s because IP forwarding or IP masquerading is not working. I once had a typo in my iptables command (using a wrong IP address range), which caused my computer not being able to browse the Internet.

If you encounter the following error, then you should disable the UDP port in ocserv, which is explained later in the speed optimization section.

DTLS handshake failed: Resource temporarily unavailable, try again

If you have the following error, it’s likely that your VPN username or password is wrong.

fgets (stdin): Inappropriate ioctl for device

Auto-Connect on System Startup

To let OpenConnect VPN client automatically connect to the server at boot time, we can create a systemd service unit.

sudo nano /etc/systemd/system/openconnect.service

Put the following lines to the file. Replace the red text.

  Description=OpenConnect VPN Client systemd-resolved.service

  ExecStart=/bin/bash -c '/bin/echo -n password | /usr/sbin/openconnect -u username --passwd-on-stdin'


Save and close the file. Then enable this service so that it will start at boot time.

sudo systemctl enable openconnect.service

Explanation of the file content:

  • systemd-resolved.service and make this service run after network is up. We want the openconnect.service start after the systemd-resolved.service because that will ensure the DNS server address set by OpenConnect won’t be overridden by systemd-resolved.service.
  • In reality, this service can still run before network is up. We add Restart=always and RestartSec=2 to restart this service after 2 seconds if this service fails.
  • Systemd doesn’t recognise pipe redirection, so in the ExecStart directive, we wrap the comand in single quotes and run it with the Bash shell.
  • Since OpenConnect VPN client will run as a systemd service, which runs in the background, there’s no need to add -b flag to the openconnect command.
  • The KillSignal directive tells Systemd to send the SIGINT signal when the systemctl stop openconnect command is issued. This will performs a clean shutdown by logging the session off, and restoring DNS server settings and the Linux kernel routing table.

To start this Systemd service immediately, run

sudo systemctl start openconnect

To stop this Systemd service, run

sudo systemctl stop openconnect

How to Automatically Restart OpenConnect Client When Resuming from Suspend

If your Ubuntu desktop goes into suspend state, the OpenConnect client would lose connection to the VPN server. To make it automatically restart when resuming from suspend, we need to create another systemd service unit.

sudo nano /etc/systemd/system/openconnect-restart.service

Add the following lines in the file.

Description=Restart OpenConnect client when resuming from suspend

ExecStart=/bin/systemctl --no-block restart openconnect.service


Save and close the file. Then enable this service.

sudo systemctl enable openconnect-restart.service

Automatic-Restart When VPN Connection Drops

Sometimes the VPN connection would drop due to other reasons. You can run the following command to check if the VPN client can ping the VPN server’s private IP address ( If the ping is unsuccessful, then the command on the right will be executed to restart the VPN client. || is the OR operator in Bash. It executes the command on the right only if the command on the left returned an error.

ping -c9 || systemctl restart openconnect

The ping will be done 9 times, i.e 9 seconds. You can use an infinite loop in the Bash shell to make the whole command run forever. Press Ctrl+C to stop it.

for ((; ; )) do (ping -c9 || systemctl restart openconnect) done

Now we can create a systemd service for this task.

sudo nano /etc/systemd/system/openconnect-check.service

Add the following lines to this file. We specify that this service should run after the openconnect.service.

Description=OpenConnect VPN Connectivity Checker

ExecStart=/bin/bash -c 'for ((; ; )) do (ping -c9 || systemctl restart openconnect) done'


Save and close the file. Then start this service.

sudo systemctl start openconnect-check

Enable auto-start at boot time.

sudo systemctl enable openconnect-check

Once this service is started, the ping command will run forever. If the VPN connection drops, it will automatically restart openconnect.service.

OpenConnect GUI Client for Windows and macOS

They can be downloaded from OpenConnect GUI Github Page.


OpenConnect VPN is pretty fast. I can use it to watch 4k videos on YouTube. As you can see, my connection speed is 63356 Kbps, which translates to 61 Mbit/s.

ocserv vpn speed test singapore server

And here’s the test results on

ocserv vpn speed test singapore

Speed Optimization

OpenConnect by default uses TLS over UDP protocol (DTLS) to achieve faster speed, but UDP can’t provide reliable transmission. TCP is slower than UDP but can provide reliable transmission. One optimization tip I can give you is to disable DTLS, use standard TLS (over TCP), then enable TCP BBR to boost TCP speed.

To disable DTLS, comment out (add # symbol at the beginning) the following line in ocserv configuration file.

udp-port = 443

Save and close the file. Then restart ocserv service.

sudo systemctl restart ocserv.service

To enable TCP BBR, please check out the following tutorial. Note that you need to disable DTLS in ocserv, or TCP BBR won’t work.

In my test, standard TLS with TCP BBR enabled is two times faster than DTLS.

Another very important factor affecting speed is how good the connection between your local computer and the VPN server is. If you live in the middle east and the VPN server is located in the U.S, the speed would be slow. Choose a data center that’s close to where you live.

Also, check your CPU load average. (htop can be installed by sudo apt install htop).


Make sure the CPU load average is under 1. I once had a CPU load average of 3, which caused a high latency between the VPN client and VPN server.

Auto-Renew Let’s Encrypt Certificate

Edit root user’s crontab file.

sudo crontab -e

Add the following line at the end of the file. It’s necessary to reload ocserv service for the VPN server to pick up new certificate and key file.

@daily certbot renew --quiet && systemctl reload ocserv

Troubleshooting Tips


Note that if you are using OpenVZ VPS, make sure you enable the TUN virtual networking device in VPS control panel. (If you use Vultr VPS, then you have KVM-based VPS, so you don’t have to worry about this.)

Log File

If you encounter any problem, then check OpenConnect VPN server log.

sudo journalctl -eu ocserv.service

I found that if I change port 443 to a different port, the great firewall of China will block this VPN connection.

Debugging Mode

If ocserv tells you that it can’t load the /etc/ocserv/ocserv.conf file, you can stop ocserv.

sudo systemctl stop ocserv

Then run it in the foreground with debugging enabled.

sudo /usr/sbin/ocserv --foreground --pid-file /run/ --config /etc/ocserv/ocserv.conf --debug=10

Then output might give you some clues why ocserv isn’t working.

Can’t browse the Internet

If you are successfully connected to the VPN server, but you can’t browse the Internet, that’s because IP forwarding or IP masquerading is not working. I remember my VPS provider once did a platform upgrade, which changed the name of the main network interface from ens3 to enp3s0, so I had to update the name in the UFW file (/etc/ufw/before.rules).

Syntax Error

If you see the following error when trying to establish VPN connection, it’s probably because there’s a syntax error in your ocserv config file. Check the journal (sudo journalctl -eu ocserv) to find out.

Got inappropriate HTTP CONNECT response: HTTP/1.1 401 Cookie is not acceptable

Restart Your Computer

If you see the following error when trying to establish VPN connection, it’s likely a local computer problem. Try restarting your computer.

Server '' requested Basic authentication which is disabled by default

TLS connection was non-properly terminated

If you see the following error on the client when trying to establish a VPN connection,

SSL connection failure: The TLS connection was non-properly terminated.

you probably should restart the ocserv service on the VPN server.

sudo systemctl restart ocserv

You can create a cron job to automatically restart ocserv once per day at 4 AM.

sudo crontab -e

Add the following line.

0 4 * * * systemctl restart ocserv

Save and close the file.

Make OpenConnect VPN server and web server use port 443 at the same time

Please read the following article:

More Useful Tips

Wrapping Up

That’s it! I hope this tutorial helped you install and configure OpenConnect VPN on Ubuntu 22.04. As always, if you found this post useful, then subscribe to our free newsletter to get more tips and tricks 🙂

Rate this tutorial
[Total: 30 Average: 4.9]

77 Responses to “Set Up OpenConnect VPN Server (ocserv) on Ubuntu 22.04 with Let’s Encrypt

  • Ramin Farmani
    4 years ago

    I follow your instruction but still receive this error on client

    DTLS handshake failed: Resource temporarily unavailable, try again.

    what else I can do

  • “I found that if I change port 443 to a different port, the Internet filtering system of my country will block this VPN connection.”
    So what is your country?

  • Ubuntu 16 has and old version of ocserv.
    It’s version (0.10.11-1build1) and there are a lot of improvements since that version in the current one (0.12.2)
    Now I’m working on compiling it to work on ubuntu, but seems like ocserv is more compatible with debian. Still I got some errors if I want to run it as service using systemctl.

    Is this the only vpn working in china? Microsoft SSTP is working? OpenVPN port 443 working?

    • I now only use self-hosted OpenConnect VPN and Shadowsocks proxy in China. They are very stable.

      I used OpenVPN before with a VPN provider. It worked but can be easily interrupted by the great firewall. I have never used Microsoft SSTP.

  • also I wanted to tell you that the email your system sends, is going to spam folder.

    • My email server complies with all legitimate email-sending practices. It takes time to build a good email reputation. Microsoft is very strict on accepting emails. Initially the emails are likely to go into spam folder. If many people mark my emails as not spam, then my emails are more likely to go to inbox.

  • Shadowsocks proxy is not blocked in China? You can make OpenVPN connects to it and then it can work without being filtered by the great firewall?

  • andrescol
    4 years ago

    Greetings, friend. great tutorial. I stayed here: sudo openconnect -b When the command is issued, the message:

    Got inappropriate HTTP CONNECT response: HTTP/1.1 401 Unauthorized
    Creating SSL connection failed

    What I can do? tks

  • reza kazemi
    4 years ago

    thank you very much

  • Mufaddal
    3 years ago

    I’m getting an error.

    error: unknown user: nobody

    Could you please guide me on what could be the problem?

  • i just set up OpenConnect VPN server on ubuntu 18.04. Users are able to connect and get an IP address assigned by the OpenConnect server. Corp network is OpenConnect server is vpn clients get addresses. From the vpn client i can ping and, but can’t ping any other corp servers on the network
    ICMP packets get to the corp servers, but get dropped because the corp servers don’t know how to route to subnet

    any help is greatly appreciated

    • if I do route add mask on any of the corp servers I am able to communicate with the corp servers from the VPN client

  • Hello,

    How can we disable TLS 1.0 in the OpenConnect VPN server config?

  • Xiao,

    Thanks for the TLS disablement update.

    There is a few more things we would like to disable. Are you able to assist with disabling elliptic curves? P-192 (prime192v1) (192 bits) to be specific and a list of ciphers



  • I have set up the server successfully but I can’t route traffic through the VPN server. I can only ping the server successfully but can’t ping any other IP.

  • Jan 29 11:52:02 ip-172-31-30-232 ocserv[5028]: sec-mod: sec-mod initialized (socket: /var/run/ocserv-socket.5018)
    Jan 29 11:52:02 ip-172-31-30-232 ocserv[5018]: main: tlslib.c:854: error loading file ‘/etc/letsencrypt/live//fullchain.pem ‘
    Jan 29 11:52:02 ip-172-31-30-232 systemd[1]: ocserv.service: Main process exited, code=exited, status=1/FAILURE
    Jan 29 11:52:02 ip-172-31-30-232 ocserv[5018]: main: tlslib.c:1000: error loading the certificate or key file
    Jan 29 11:52:02 ip-172-31-30-232 ocserv[5028]: sec-mod: error receiving msg head from main
    Jan 29 11:52:02 ip-172-31-30-232 ocserv[5028]: sec-mod: error processing sync command from main
    Jan 29 11:52:02 ip-172-31-30-232 systemd[1]: ocserv.service: Failed with result ‘exit-code’.
    Jan 29 11:52:02 ip-172-31-30-232 systemd[1]: ocserv.service: Start request repeated too quickly.
    Jan 29 11:52:02 ip-172-31-30-232 systemd[1]: ocserv.service: Failed with result ‘exit-code’.
    Jan 29 11:52:02 ip-172-31-30-232 systemd[1]: Failed to start OpenConnect SSL VPN server.


    I am following your instructions to the letter but I run into this issue when trying to setup ocserv server.
    Has something changed since this guide was posted?


    • This line:

      Jan 29 11:52:02 ip-172-31-30-232 ocserv[5018]: main: tlslib.c:854: error loading file ‘/etc/letsencrypt/live//fullchain.pem ‘

      indicates that you didn’t correctly specify the path to TLS certificate. If you go to the /etc/letsencrypt/live/ directory, you will understand what went wrong.

      • Hi Guo An,

        Thanks for the speedy response. I should have mentioned that I removed the site’s domain from the nginx log.

        • * From the ocserv log before posting it.

          Because of the execution of the certbot command as sudo, I suspect that this may be a permissions issue, because as a regular user I cannot access the certificates directory.

          However, I have tried the following:

          – Running ocserv as a root user (just for testing)
          – changing permissions and owner of the certificates.

          ocserv is still unable to read the certificates, at this point I’m not sure if it’s an issue with the certificate.

      • you have a space ‘/etc/letsencrypt/live//fullchain.pem ‘ remove space

    • The problem is that ocserv can’t load the TLS certificate file. Please make sure the TLS certificate exist in the /etc/letsencrypt/live/ directory and double check your /etc/ocserv/ocserv.conf file.

      From the log, I suspect that you added a whitespace at the end of the TLS certificate path.

      • What do you think about outline vpn

        • I haven’t set up outline VPN yet. From I have learned, Outline is based on Shadowsocks, which is a SOCKS5 proxy, not a VPN. Shadowsocks is very popular with Chinese netizens, used as a tool to bypass the Great Firewall. I have been using Shadowsocks for 3 years. It’s super fast.

        • Murat
          3 years ago

          it is super easy to set up. Can you please write a review about it

  • Anonymous
    3 years ago

    Thank you, real detailed guide.

  • Username
    3 years ago

    Love this guide. Is there anything we can do to enable having an IPV6 address along with an IPV4 address?

  • Linux Newbie
    3 years ago

    Thanks, this is really a great guide 🙂

  • Excellent guide! Thank you so much!!

  • I hope this help
    I have successfully upgrade to TLS1.3

    Use TLS1.3 with Ocserv anyconnect on Debian

  • Morteza
    3 years ago

    Hi Xiao Guo An
    Thanks for fantastic post. I installed ocserv on ubuntu 18.04 and its worked like charm.
    I want to create bunch user(more than 500 user) and I need to set some expiration period date after first users connection(like 3 month, 6 month etc… after first connection to the server).
    Could you please guide me to do that?


  • Tanzil Hussain
    3 years ago

    how can I use the sql database to connect VPN users with ocserv server without using ocpassd file?

  • Hello, thanks for the great article. One comment, do not disable UDP because you think it’s unreliable. Your payload (in the tunnel) decides if its require an unreliable connection and if yes it uses in the tunnel TCP.

    So if a TCP (in tunnel) package (e.g. HTTP package) gets lost it’s resent automatically again caused by the payload and not because of the VPN tunnel an that within an fast UDP frame. UDP performs much faster because it does not wait for ACKs on long distances and assume you stream video via UDP – if a package get’s lost it doesn’t make sense to resend it, if you put TCP around it resends it (and throws it away on destination but blocks your link).

    • I know it’s not an ideal solution, but using TLS on TCP port 443 is the only way to survive the great firewall of China. If I enable UDP, my openconnect client would complain about DTLS handshake failure.

      DTLS handshake failed: Error in the push function.
      (Is a firewall preventing you from sending UDP packets?)
  • G.R.Regis
    3 years ago

    I’ve tried this on a couple of servers now, my home server and a VPS I rent that both run Ubuntu 18.04, and I get the following error on each:

     Sep 21 02:47:28 myserver systemd[1]: Dependency failed for OpenConnect SSL VPN server.
    Sep 21 02:47:28 myserver systemd[1]: ocserv.service: Job ocserv.service/start failed with result 'dependency'.

    I tried googling for an answer, and all I could see was that there was an issue with the ports being used. Now I have webservers running on each (apache on one and nginx on the other) and I changed the port for ocserv to 8443 on each as per the tutorial for each type of server. I even tried creating /etc/systemd/system/ocserv.socket.d/port.conf file to no avail. Any help is apprceiated. 谢谢.

    • Double check your configuration file and the /etc/systemd/system/ocserv.service file. I can’t help fix an error that I didn’t encounter myself.

  • G.R.Regis
    3 years ago

    After thinking about it a bit, I realized I didn’t reboot the server (it never prompted me to), so I tried that and it fixed the issue.

  • Tanzil Hussain
    3 years ago

    Best VPS for openconnect where you can change IP in case of blockage by your country without rebuilding VPS:

  • how do I add mfa to it?

  • Jonny Li
    3 years ago

    Hi Guoan,

    Thanks for such a detail document and I tried to follow step by step to build my VPN server. But I met a UFW forwarding issue after inserted this part to /etc/ufw/before.rules

    # NAT table rules
    # End each table with the 'COMMIT' line or these rules won't be processed

    After doing that, I tried to restart the UFW, but it told me below, “Bad argument `*nat'”

    $ systemctl status ufw.service
    ?.ufw.service - Uncomplicated firewall
       Loaded: loaded (/lib/systemd/system/ufw.service; enabled; vendor preset: enabled)
       Active: failed (Result: exit-code) since Sat 2019-12-07 14:57:11 UTC; 19s ago
         Docs: man:ufw(8)
      Process: 12493 ExecStop=/lib/ufw/ufw-init stop (code=exited, status=0/SUCCESS)
      Process: 12667 ExecStart=/lib/ufw/ufw-init start quiet (code=exited, status=1/FAILURE)
     Main PID: 12667 (code=exited, status=1/FAILURE)
    Dec 07 14:57:11 anyconnect systemd[1]: Stopped Uncomplicated firewall.
    Dec 07 14:57:11 anyconnect systemd[1]: Starting Uncomplicated firewall...
    Dec 07 14:57:11 anyconnect ufw-init[12667]: Bad argument `*nat'
    Dec 07 14:57:11 anyconnect ufw-init[12667]: Error occurred at line: 75
    Dec 07 14:57:11 anyconnect ufw-init[12667]: Try `iptables-restore -h' or 'iptables-restore --help' for more information.
    Dec 07 14:57:11 anyconnect ufw-init[12667]: Problem running '/etc/ufw/before.rules'
    Dec 07 14:57:11 anyconnect systemd[1]: ufw.service: Main process exited, code=exited, status=1/FAILURE
    Dec 07 14:57:11 anyconnect systemd[1]: ufw.service: Failed with result 'exit-code'.
    Dec 07 14:57:11 anyconnect systemd[1]: Failed to start Uncomplicated firewall.

    The part I added into the before.rules is like below,

    # NAT table rules
    # don't delete the 'COMMIT' line or these rules won't be processed

    Checked the steps for several times but found nothing missed.
    Could you please show me some hints?
    I’m using 18.04 version.

    Thx in advance,
    Jonny Li

  • Jonny Li
    3 years ago

    ok, I got the answer now, Still didn’t fully focus on reading.

    “Add the following lines at the end of this file. Replace ens3 with your own network interface name.”

    Jonny Li

  • MentallicA
    3 years ago

    Hello there

    I am noob and I want to know what does the Domain Name use for and this Domain Name should be linked to which host? does it need to be linked to the vps I wanna run openconnect on it or what?

    • First, you need to buy a domain name from a domain registrar like NameCheap. Then you should create a DNS A record for at your domain registrar’s website. The value of DNS A record is the IP address of your VPS.

  • Hello, first sorry for my English. Congratulation for the article.

    I have 2 questions

    1. I didn’t manage to fix “DTLS Handshake Failure”. I have done everything you have write above, probably there it’s something that i didn’t understand.
    2. If i want to use application openvpn for windows to connect to the vpn server, i have to use my own CA, right?

    Thank you very much and go on with these kind of articles

    • 1. Which part you don’t understand?

      2. You can’t use OpenVPN client to connect to the OpenConnect VPN server. OpenVPN and OpenConnect VPN are two different VPN protocols. You need to use the OpenConnect Client for Windows. And if you followed my tutorial, your OpenConnect VPN server is configured with a valid SSL/TLS certificate. You just need to enter the server address, username and password in the OpenConnect Client.

      • Thank you very much for your fast answer

        2. I messed up the names 🙂 I thought that OpenVPN and OpenConnectVPN (the only difference it’s “connect” 🙂 ) it’s the same program 🙂 don’t laugh too loud 🙂

        1. I guess that I didn’t understand something because even if I commented out the two lines that contain “ocserv.socket” and I disabled the service, I have the same problem with “handshake”

        Happy New Year

      • P.S. or L.E.

        I found out what was the problem :). The vpn server it’s behind a router and I was having opened only 443 tcp port, udp port wasn’t :). After I’ve opened udp port…everything it’s working well.

        Don’t forget, keep going with these kind of articles 🙂

  • Tanzil Hussain
    2 years ago

    if some one looking for a openconnect vpn panel and custom applicaton where you can make bulk accounts auto expiry and many more thing just contact me
    my portfolio:

  • tnx for the useful article that help me so many time
    but for now i need the connected user can see eche other in the private network for example i want to client1 that connect to openconnect can see the web server of client2
    do you think that is possible?

    • They are in the same private network, so they can ping each other. If the web server is set to listen on all interfaces, then other hosts in the private network can browse the website.

  • Dear Xiao
    I Done it all and its all ok. I even created multiple accounts and speed is good.
    With some internet connection I Get this:

    The secure gateway has rejected the connection attempt. A new connection attempt to the same or another secure gateway is needed, which requires re-authentication

    I couldn’t find anything solid about it. The error is ambiguous to me.
    If its helpful , I can send you the ocserv.conf

    Great article.
    I learned a lot.

  • Dear Xiao Guoan, is it possible to disable the timeout ocserv when not in use, and the locked phone turns off the tunnel after 15-20 minutes?
    Is there any way to assure that time?

  • Hi
    thanks for a really good guide.
    but I have a problem:
    I have a mtproto proxy running ( on port 443 and I launched ocserv VPN on port 4443 they work OK when I use them separately, but when my VPN is on I can’t use my mtproto.
    is there a fix for that so I don’t have to turn my mtproto off on my client device everytime I turn on VPN ?

  • Hi Buddy, this is an excellent guide, great job! Thank you.

  • Alireza
    2 years ago

    Thanks for your great article.
    I didn’t find any article on the web that guide step by step so thanks to you again.
    I’ve set it up on my VPS and it works properly.
    Now I’m trying to put my server behind Cloudflare. Everything works well but in the last step of connection I get this:

    Got CONNECT response: HTTP/1.1 200 CONNECTED
    CSTP connected. DPD 90, Keepalive 32400
    Connected as, using SSL
    Unknown packet 35 34 0d 0a 53 54 46 01
    Send BYE packet: Unknown packet received
    Unknown error; exiting.

    and connection drop.
    any hint?

    • OpenConnect VPN doesn’t work with Cloudflare CDN. You can use the Cloudflare DNS service, but don’t enable proxy in Cloudflare for your VPN server.

    • Go to cloudflare, DNS tab, DNS management section, and disable proxied(DNS only) for record.
      I did and works for me.

  • Tanzil Hussain
    2 years ago

    if some one looking for a openconnect vpn panel and custom applicaton where you can make bulk accounts auto expiry and many more thing just contact me
    my portfolio:

  • Lear Zhou
    2 years ago


    Is there a way to not using Masquerading, just using route for packet forwarding?

    I’ve been tried various ways but still no luck, and googled with some similar explorations of openvpn, which involved configuration on openvpn side.

    It is because I am using a server behind NAT to run ocserv, if using Masquerading to forwarding packets, it would be double-NAT. Other scenarios including prioritizing various clients based on the ip they got, in which case, using Masquerading will lost original assigned ip info of these clients.

  • michaelchen
    2 years ago

    This is the best openconnect tutorial I’ve seen. Thank you

  • Hi Xiao,

    many thanks for this (and all the other) great guide, it worked perfectly 100% without even one single error.
    And the VPN works amazing.

    I installed the ocserv in a Vultr VPS, and I have 2 additional IPv4 on that server.

    My question is the following:
    Is it possible to have a rotating IP for the VPN server?
    So for example the external IP will switch every 8h (just as an example).

    Many thanks for your great and inspiring work!
    Thank you!

    • You can set up SNAT (Source NAT) in the firewall like this:

      sudo iptables -t nat -A POSTROUTING -p tcp -m statistic --mode nth --every 2 --packet 0 -j SNAT --to-source the.first.ip.address 
      sudo iptables -t nat -A POSTROUTING -p tcp -j SNAT --to-source the.second.ip.address

      So the firewall will change IP address every other packet. You probably want to change 2 to a much bigger value like 1,000,000

  • hello i am trying to make the per-user-group for deferent levels of vpn, but when I make the group file and restart the server. I get the error

     Message from [email protected] at Dec 13 03:09:24 ...
     ocserv[1362]: user 'shaun' requested group 'group1' but is not a member
    • To add a user to a group, run

      sudo ocpasswd -c /etc/ocserv/ocpasswd username -g group_name

      Then restart ocserv.

      sudo systemctl restart ocserv
  • I did that, and still getting the error.. I added the two groups with the config for the routes in each per-user-group folder.. and uncommented the following lines to allow a drop down to select which group you want at login

     # Groups that a client is allowed to select from.
    # A client may belong in multiple groups, and in certain use-cases
    # it is needed to switch between them. For these cases the client can
    # select prior to authentication. Add multiple entries for multiple groups.
    # The group may be followed by a user-friendly name in brackets.
    select-group = group1
    select-group = group2
    • so I got the group to work but what i am finding is i can’t add one user to two groups.

  • Tigran
    1 year ago

    How can I connect a MikroTik router to this VPN&

  • Guvanch Chariyev
    11 months ago

    Hello. Thanks for great article.
    Can I block some website ips, for example users can not connect to or specific ip?
    Any suggestion?

  • brookkelly
    1 month ago

    awesome blog to share

Leave a Comment

  • Comments with links are moderated by admin before published.
  • Your email address will not be published.
  • Use <pre> ... </pre> HTML tag to quote the output from your terminal/console.
  • Please use the community ( for questions unrelated to this article.
  • I don't have time to answer every question. Making a donation would incentivize me to spend more time answering questions.

The maximum upload file size: 2 MB. You can upload: image. Links to YouTube, Facebook, Twitter and other services inserted in the comment text will be automatically embedded. Drop file here