ccvpn/templates/pages/install-gnulinux.en.md

Title
Install on GNU/Linux

With NetworkManager

1. Download and install OpenVPN and the NetworkManager plugin with your package manager.

   • Debian: sudo apt-get install openvpn resolvconf network-manager-openvpn network-manager-openvpn-gnome
   • Fedora: sudo yum install openvpn networkmanager-openvpn
   • Arch Linux: sudo pacman -S openvpn networkmanager-openvpn

2. You will also need our CA certificate, available here: https://vpn.ccrypto.org/ca.crt
   You can right click on that link and save the file or download it differently. It will be required to connect, so make sure to not delete it later.

3. Create a new connection and choose the type OpenVPN.

4. You will need to fill in the following VPN configuration:

   • Tab VPN

     • Gateway: gw.random.204vpn.net for a random server, or pick one in the server list.
     • Type: Password
     • User name and Password: The same as on this site.
     • CA certificate: The ca.crt file downloader in the previous step.

   • Tab VPN, click on Advanced, then the first General tab

     • Use custom gateway port: It should be checked and set to 1196.
     • Use a TCP connection: It should be unchecked to use the fastest UDP mode. If you have issues connecting, you can try setting the port to 443 and checking this option.
     • Randomize remote hosts: It should be checked.
     • IPv6 tun link: It should be checked unless you get IPv6-related issues.

5. Save the new connection and connect to it.

With systemd (Arch, Fedora 16 or later, Debian 8 or later, ...)

1. Download and install OpenVPN with your package manager.

   • Debian: sudo apt-get install openvpn
   • Fedora: sudo yum install openvpn
   • Arch Linux: sudo pacman -S openvpn

2. Download the .ovpn file you need in your account and put it in /etc/openvpn/ .
   ie: /etc/openvpn/ccrypto.conf

3. Start the OpenVPN service:

    sudo systemctl start openvpn@ccrypto
   

4. (Optional) To make OpenVPN start at boot, create a text file anywhere and write your username and password inside, on two lines.
   Then, add at the end of your ccrypto.conf file:

    auth-user-pass /path/to/the/file.txt
   

   And enable the systemd service :

    systemctl enable openvpn@ccrypto
   

   For additional security, you can make sure only root is be able to access this file:

    sudo chown root:root /path/to/the/file.txt
    sudo chmod 600 /path/to/the/file.txt
   

Without systemd (Debian before 8.0, ...)

1. Download and install OpenVPN with your package manager.

   • Debian: sudo apt-get install openvpn resolvconf
   • Fedora: sudo yum install openvpn

2. Download the .ovpn file you need in your account and put it in /etc/openvpn/ .
   ie: /etc/openvpn/ccrypto.conf

3. Start the OpenVPN service:

    sudo service openvpn start ccrypto
   

4. (Optional) To make OpenVPN start at boot, create a text file anywhere and write your username and password inside, on two lines.
   Then, add at the end of your ccrypto.conf file:

    auth-user-pass /path/to/the/file.txt
   

   And add the configuration file name to the AUTOSTART list in /etc/default/openvpn (you can add it at the end):

    AUTOSTART="ccrypto"
   

   For additional security, you can make sure only root is be able to access this file:

    sudo chown root:root /path/to/the/file.txt
    sudo chmod 600 /path/to/the/file.txt