# Geph5 testing guide

## Step 1: Installation

Right now, Geph 5 is available in two ways, a **command-line client**, and a **graphical client**.

### Graphical client


To download the graphical client, download from one of these URLs:

- **Linux x86-64**: https://artifacts.geph.io/gnu-latest/geph5-client-gui
- **Windows installer**: https://artifacts.geph.io/windows-gui-latest/geph5-setup.exe
- **macOS**: https://artifacts.geph.io/macos-latest/geph5-client-gui

For Linux and Mac, after downloading, you need to make the file executable. Open a terminal, navigate to the download directory, and run:

chmod +x geph5-client-gui

On Mac, since it's not packaged as an app, you need to right-click to run the executable.

### Command-line client

`geph5-client`. You can either compile from [source](https://github.com/geph-official/geph5), or download the latest version from one of these URLs:
- **Linux x86-64**: https://artifacts.geph.io/musl-latest/geph5-client
- **Windows**: https://artifacts.geph.io/windows-latest/geph5-client.exe
- **macOS**: https://artifacts.geph.io/macos-latest/geph5-client

For Linux and Mac, after downloading, you need to make the file executable. Open a terminal, navigate to the download directory, and run:

chmod +x geph5-client

On Mac, since it's not packaged as an app, you need to right-click to run the executable.

## Step 2: Run the client

### Graphical client

- Open Geph
- Enter your username and password in **Settings*
- Click **Connect** on the dashboard.

You should be able to use your browser to use the Internet.

But you *might* have to configure this manually in your browser to use Geph.

For *Firefox*, this is available in the settings:


Note that it's important to set the *Proxy DNS when using SOCKS v5* setting.

For *Chrome*, there is no native setting, so we recommend using the [Proxy SwitchyOmega extension](https://chromewebstore.google.com/detail/proxy-switchyomega/padekgcemlokbadohgkifijomclgjgif) to set up SOCKS5 proxying.

### Command line

Run `geph5-client --config (path to your YAML config)`. The YAML config needs something like this:

First, you need to create a **config file**. This looks like the following:

socks5_listen: 127.0.0.1:9999
http_proxy_listen: 127.0.0.1:19999
exit_constraint:
  country: JP
broker:
  fronted:
    front: https://www.cdn77.com/
    host: 1826209743.rsc.cdn77.org
credentials:
  legacy_username_password:
    username: (your Geph username)
    password: (your Geph password)

Place your **Geph username and password** in the places indicated above.

Note that the above file connects to the **Japan** server. You can choose from at least the following countries currently:
- JP: Japan
- CH: Switzerland

You can also leave Geph to automatically choose an exit by specifying

exit_constraint: auto

Then, configure your browser to use the right SOCKS v5 proxy.