# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gopher.security/gophersecurity-app/gopher-app-installation-guide-for-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.