This site requires JavaScript to be enabled
An updated version of this article is available

Install and Configure the Cisco AnyConnect Software VPN on Linux


25.0 - Updated on 05-09-2024 by Mike Caban

24.0 - Updated on 03-13-2024 by Mike Caban

23.0 - Updated on 03-11-2024 by Leon Lam

22.0 - Updated on 10-05-2023 by Leon Lam

21.0 - Updated on 08-03-2023 by Leon Lam

20.0 - Updated on 12-12-2022 by Paty Ruiz Gonzalez

19.0 - Updated on 12-15-2021 by Mike Caban

18.0 - Updated on 12-15-2021 by Mike Caban

17.0 - Updated on 12-09-2021 by Mike Caban

16.0 - Updated on 11-01-2021 by Mike Caban

15.0 - Updated on 11-01-2021 by Mike Caban

14.0 - Updated on 10-21-2021 by Mike Caban

13.0 - Updated on 10-21-2021 by Mike Caban

12.0 - Updated on 10-07-2021 by Mike Caban

11.0 - Updated on 07-22-2021 by Sylvia Bass

10.0 - Updated on 07-13-2021 by Mike Caban

9.0 - Updated on 07-13-2021 by Mike Caban

8.0 - Updated on 07-07-2021 by Mike Caban

7.0 - Updated on 07-07-2021 by Mike Caban

6.0 - Updated on 07-07-2021 by Mike Caban

5.0 - Updated on 06-14-2021 by Mike Caban

4.0 - Updated on 08-21-2020 by Mike Caban

3.0 - Updated on 07-10-2020 by Mike Caban

2.0 - Updated on 07-10-2020 by Mike Caban

1.0 - Authored on 05-07-2015 by Mike Caban

Installing the VPN Client

  1. Download the Anyconnect VPN client.
  2. From the Terminal, navigate to the Downloads folder and unzip the file by typing [tar xzvf anyconnect-xxx.tar.gz]
    • NOTE: The *actual* file name will contain the name of the current version of the installer (e.g. anyconnect-linux64-4.5.03040-predeploy-k9.tar.gz)
  3. A folder with the same name as the file will appear in the current directory. Open the folder and then go to the vpn directory, and once you are there type [./]
  4. The VPN client will be installed on your system and the vpnagentd process will be started. This process will be started each time your system is booted.
  5. NOTE: Ubuntu/Debian users should run this command to download a dependency for the VPN UI: [sudo apt-get install libpangox-1.0-0]

Starting the VPN Client

  1. To start the client from the terminal, type [/opt/cisco/anyconnect/bin/vpnui]. Note: if you are not running a GUI, you can enter interactive mode by entering[/opt/cisco/anyconnect/bin/vpn]
    • NOTE: If you are using a desktop environment, you should be able to find the client in one of your menus as well (e.g. in a RHEL environment, look in Applications -> Internet).
  2. In the “Connect to:” box, type and press Return on your keyboard. Note: in interactive mode type [connect]
  3. In the “Group” menu that will appear, select the tunnel you wish to use, usually “UCI” or “UCIFull”. (See the differences in the Tunnels below.)
  4. Enter your UCInetID and password in the appropriate boxes and click “Connect”.
  5. You should get a banner box. When you do, click “Accept” and you are now connected.

Possible Error Messages

If you get one of the following messages when you try to connect to the campus VPN service:

  • “Connection attempt has failed due to server certificate problem”
  • “AnyConnect cannot confirm it is connected to your secure gateway”

this means that the AnyConnect client cannot validate the certificate on the campus VPN service.

To remedy this, please download and unzip this file and follow the directions in the README file to install the InCommon certificate files on your system.

Ubuntu Linux

If you are using Ubuntu Linux and are having problems using the VPN, Jeff Stern has instructions for making the AnyConnect VPN work on Ubuntu. See for more information.

Linux Openconnect Client

Note: Using the Linux openconnect software is not supported by OIT. If you have problems using this, OIT will not be able to help you. These instructions are provided for you if you want to use something other than the supported Cisco AnyConnect client on your Linux system.

Some Linux distributions include a VPN client called openconnect that can be used with the the UCI VPN service. The instructions below are for Fedora Linux. Other distributions may be similar.

  1. From the terminal, type [sudo openconnect -u UCInetID]
    • replace UCInetID with your actual UCInetID
    • if you don't have openconnect installed, you can download it from your distro's software repo [e.g. sudo apt-get install openconnect]
  2. You will be prompted for the Group to use. Type one of the options, usually UCI or UCIFull (it's not case-sensitive)
  3. You will be prompted for your password. After you give the client your password you will be logged in.

You can minimize the terminal window while you do your work (don’t close it or you will lose your VPN connection). When you are done type ^C (control-c) to terminate openconnect and your VPN session will be logged out.

(Jeff Stern has also written a page on setting up Openconnect for Debian/Ubuntu users, at