> For the complete documentation index, see [llms.txt](https://docs.gopher.security/gophersecurity-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gopher.security/gophersecurity-app/gopher-app-installation-guide-for-linux.md).

# Gopher App Installation Guide for Linux

#### Supported Platforms: Debian, Fedora and CentOS/RHEL

{% tabs %}
{% tab title="Debian" %}

### Install, upgrade or uninstall Gopher App via command line

* To install Gopher App, run the following command(the first time install):<br>

  ```bash
  curl -fsSL "https://debian.repo.gopher.security/gopher-security.gpg" | sudo gpg --yes --dearmor -o /etc/apt/trusted.gpg.d/gopher-security.gpg
  echo "deb [signed-by=/etc/apt/trusted.gpg.d/gopher-security.gpg] https://debian.repo.gopher.security bionic main" | sudo tee /etc/apt/sources.list.d/gopher-security.list
  sudo apt update
  sudo apt install gopher.security.app
  ```
* To upgrade Gopher App to the latest version, run the following command:<br>

  ```bash
  sudo apt update && sudo apt install gopher.security.app
  ```
* To uninstall Gopher App, run the following command:<br>

  ```bash
  sudo apt remove gopher.security.app
  ```

### Install, upgrade or uninstall Gopher CLI via command line

* To install Gopher CLI, run the following command line (the first time install):<br>

  ```bash
  curl -fsSL "https://debian-cli.repo.gopher.security/gopher-security.gpg" | sudo gpg --yes --dearmor -o /etc/apt/trusted.gpg.d/gopher-security.gpg
  echo "deb [signed-by=/etc/apt/trusted.gpg.d/gopher-security.gpg] https://debian-cli.repo.gopher.security bionic main" | sudo tee /etc/apt/sources.list.d/gopher-security.list
  sudo apt update
  sudo apt install gopher.security.app.cli
  ```
* To upgrade Gopher CLI to the latest version, run the following command:<br>

  ```bash
  sudo apt update && sudo apt install gopher.security.app.cli
  ```
* To uninstall Gopher CLI, run the following command:<br>

  ```bash
  sudo apt remove gopher.security.app.cli
  ```

### Install Gopher App via standalone package

* Go to [GopherSecurity App Downloads and Releases](https://docs.gopher.security/software-downloads#software) and download the standalone package.
* Run the following command to install Gopher App from the directory where you downloaded the package to, e.g. (must start with path / or ./ if in current directory):<br>

  ```bash
  apt install  /home/ubuntu/Downloads/GopherSecurity-linux-0.0.1-80-amd64-release.deb
  ```

{% endtab %}

{% tab title="Fedora " %}

### Install, upgrade or uninstall Gopher App via command line

* To install Gopher App, run the following command to create repo file:<br>

  ```bash
  sudo tee /etc/yum.repos.d/gopher-security-app.repo << 'EOF'
  [gopher-security-app]
  name=Gopher Security
  baseurl=https://rpm.repo.gopher.security
  gpgcheck=1
  gpgkey=https://rpm.repo.gopher.security/gophersecurity.gpg
  enabled=1
  EOF
  sudo yum clean all && sudo yum update && sudo yum install gopher.security.app.x86_64
  ```
* To upgrade Gopher App, run the following command:<br>

  ```bash
  sudo yum clean all && sudo yum update && sudo yum install gopher.security.app.x86_64
  ```
* To uninstall Gopher App, run the following command:<br>

  ```bash
  sudo yum remove gopher.security.app.x86_64
  ```

### Install, upgrade or uninstall Gopher CLI via command line

* To install Gopher CLI, run the following command to create repo file:<br>

  ```bash
  sudo tee /etc/yum.repos.d/gopher-security-cli.repo << 'EOF'
  [gopher-security-cli]
  name=Gopher Security CLI
  baseurl=https://rpm-cli.repo.gopher.security
  gpgcheck=1
  gpgkey=https://rpm-cli.repo.gopher.security/gophersecurity.gpg
  enabled=1
  EOF
  sudo yum clean all && sudo yum update && sudo yum install gopher.security.cli.x86_64
  ```
* To upgrade Gopher CLI to the latest version, run the following command:<br>

  ```bash
  sudo yum clean all && sudo yum update && sudo yum install gopher.security.cli.x86_64
  ```
* To uninstall Gopher CLI, run the following command:<br>

  ```bash
  sudo apt remove gopher.security.cli.x86_64
  ```

### Install Gopher App via standalone package

* Go to [GopherSecurity App Downloads and Releases](https://docs.gopher.security/software-downloads#software) and download the standalone package.
* Run the following command to install Gopher App from the directory where you downloaded the package to, e.g. (must start with path / or ./ if in current directory):<br>

  ```bash
  sudo yum install  /home/rpm/Downloads/gopher.security-app-0.0.2+34-1.release.x86_64.rpm
  ```

{% endtab %}

{% tab title="CentOS/RHEL" %}

### Install, upgrade or uninstall Gopher App via command line

* To install Gopher App, run the following command:<br>

  ```bash
  sudo tee /etc/yum.repos.d/gopher-security-app.repo << 'EOF'
  [gopher-security-app]
  name=Gopher Security
  baseurl=https://rpm.repo.gopher.security
  gpgcheck=1
  gpgkey=https://rpm.repo.gopher.security/gophersecurity.gpg
  enabled=1
  EOF
  sudo yum update && sudo yum install epel-release && sudo yum install gopher.security.app.x86_64
  ```
* To upgrade Gopher App to the latest version, run the following command:<br>

  <pre class="language-bash"><code class="lang-bash"><strong>sudo yum update gopher.security.app.x86_64
  </strong></code></pre>
* To uninstall Gopher App, run the following command<br>

  ```bash
  sudo yum remove gopher.security.app.x86_64
  ```

### Install, upgrade or uninstall Gopher CLI via command line

* To install Gopher CLI, run the following command:<br>

  ```bash
  sudo tee /etc/yum.repos.d/gopher-security-cli.repo << 'EOF'
  [gopher-security-cli]
  name=Gopher Security CLI
  baseurl=https://rpm-cli.repo.gopher.security
  gpgcheck=1
  gpgkey=https://rpm-cli.repo.gopher.security/gophersecurity.gpg
  enabled=1
  EOF
  sudo yum update && sudo yum install gopher.security.cli.x86_64
  ```
* To upgrade Gopher CLI to the latest version, run the following command:<br>

  ```bash
  sudo yum update gopher.security.cli.x86_64
  ```
* To uninstall Gopher CLI, run the following command:<br>

  ```bash
  sudo yum remove gopher.security.cli.x86_64
  ```

### Install Gopher App via standalone package

* Go to [GopherSecurity App Downloads and Releases](https://docs.gopher.security/software-downloads#software) and download the standalone package.
* Note for CentOS/RHEL we require to additionally install `epel-release package`
* Run the following command to install Gopher App from the directory where you downloaded the package to, e.g. (must start with path / or ./ if in current directory):<br>

  ```bash
  sudo yum install  /home/rpm/Downloads/gopher.security-app-0.0.2+34-1.release.x86_64.rpm
  ```

{% endtab %}
{% endtabs %}

### Gopher CLI options via command line

1. Run the following command to show the version:<br>

   ```bash
   gopher version
   ```
2. Run the following command to show Gopher help:<br>

   ```bash
   gopher -help
   ```
3. Run the following command to login \
   **Note**: Refer to [Quick Start to Use GopherSecurity App](/gophersecurity-app/gopher-app-quick-start.md) for instructions on signing in.<br>

   ```bash
   gopher login
   ```
4. Run the following command to list all peer-to-peer end-to-end encrypted virtual networks:<br>

   ```bash
   gopher net list
   ```
5. Run the following command to connect or disconnect a network where the ‘1’ refers to the first network in the list:<br>

   ```bash
   gopher net --connect 1
   gopher net --disconnect 1
   ```
6. Run the following command to view the all teams:<br>

   ```bash
   gopher team list
   ```
7. Run the following command to switch to team 1 where ‘1’ refers the first team in the list:<br>

   ```bash
   gopher team --use 1
   ```
8. Run the following command to obtain the Gopher IP address for the network you connected:<br>

   ```bash
   ip addr
   ```

### Run GopherSecurity via GUI

1. Click "Show Applications" from the desktop.

<figure><img src="/files/O7EXfr7kdDymqYRbqwRd" alt=""><figcaption><p>Show Applications</p></figcaption></figure>

2. Click the Gopher Security Icon

<figure><img src="/files/yNgGbLuaXl6WmqgMQh1s" alt=""><figcaption></figcaption></figure>

3. Click the Gopher Security app icon from the left sidebar or top status bar to show or hide the app.

<figure><img src="/files/tuT6YIfXYqmdwDS3v6PA" alt=""><figcaption><p>Show/Hide Gopher Security App</p></figcaption></figure>

**Note:**  Refer to [Quick Start to Use GopherSecurity App](/gophersecurity-app/gopher-app-quick-start.md) for instructions on signing in.