====== Installing ProtonVPN GUI on Ubuntu (Manual Repository Setup) ======

This guide explains how to manually add the ProtonVPN repository to Ubuntu and install the GNOME desktop application.

===== Requirements =====
  * Ubuntu with GNOME desktop environment
  * Internet connection
  * sudo/root access

===== Step 1: Add the GPG Key =====

<code bash>
sudo apt install gnupg
wget -q -O - https://repo.protonvpn.com/debian/public_key.asc | sudo apt-key add -
</code>

> **Note:** You may see a warning that `apt-key` is deprecated. This can be ignored for now.

===== Step 2: Add the ProtonVPN Repository =====

<code bash>
echo "deb https://repo.protonvpn.com/debian stable main" | sudo tee /etc/apt/sources.list.d/protonvpn-stable-release.list
</code>

===== Step 3: Update Package Sources =====

<code bash>
sudo apt update
</code>

===== Step 4: Install the GNOME Desktop App =====

<code bash>
sudo apt install proton-vpn-gnome-desktop
</code>

===== Step 5 (Optional): Enable System Tray Support =====

<code bash>
sudo apt install libayatana-appindicator3-1 gir1.2-ayatanaappindicator3-0.1 gnome-shell-extension-appindicator
</code>

===== Troubleshooting =====

If the package is still not found:

  * Check the contents of the repository file:
<code bash>
    cat /etc/apt/sources.list.d/protonvpn-stable-release.list
</code>
    It should contain: 
<code>
    deb https://repo.protonvpn.com/debian stable main
</code>
  * Run:
<code bash>
    sudo apt clean && sudo apt update
</code>

===== Alternative: Install CLI Version =====

If you prefer the command-line interface:

<code bash>
sudo apt install protonvpn-cli
</code>

Then log in and connect:
<code bash>
protonvpn-cli login YOUR_USERNAME
protonvpn-cli connect --fastest
</code>

====== Using ProtonVPN CLI on Ubuntu ======

This guide explains how to install and use ProtonVPN via the command-line interface (CLI) on Ubuntu.

===== Requirements =====
  * Ubuntu system (any desktop environment)
  * ProtonVPN account
  * sudo/root access

===== Step 1: Install the CLI tool =====

If the ProtonVPN repository is already added, simply run:

<code bash>
sudo apt install protonvpn-cli
</code>

If not, follow the repository setup instructions from the GUI installation page.

===== Step 2: Initialize the CLI =====

<code bash>
protonvpn-cli init
</code>

This will prompt you to choose:
  * VPN protocol (OpenVPN or WireGuard)
  * DNS settings
  * Kill switch behavior
  * Auto-connect options

===== Step 3: Log in =====

<code bash>
protonvpn-cli login YOUR_USERNAME
</code>

Replace `YOUR_USERNAME` with your actual ProtonVPN account name.

===== Step 4: Connect to VPN =====

To connect to the fastest available server:

<code bash>
protonvpn-cli connect --fastest
</code>

To connect to a specific country:

<code bash>
protonvpn-cli connect DE
</code>

To disconnect:

<code bash>
protonvpn-cli disconnect
</code>

===== Step 5: Status and Diagnostics =====

Check connection status:

<code bash>
protonvpn-cli status
</code>

View current IP and server:

<code bash>
protonvpn-cli info
</code>

===== Optional Commands =====

Enable kill switch:

<code bash>
protonvpn-cli killswitch --on
</code>

Enable auto-connect on boot:

<code bash>
protonvpn-cli configure --autoconnect on
</code>

===== References =====
  * https://protonvpn.com/support/linux-vpn-tool/