# Installing Whirlpool

## Prepare your Pi

First we need to install OpenJDK 8:

```
$ sudo apt-get install openjdk-8-jre
```

Next, pull the Whirlpool Client CLI lastest repository:

```
$ mkdir /home/**user**/whirlpool
$ cd whirlpool
$ sudo wget https://github.com/Samourai-Wallet/whirlpool-runtimes/releases/tag/cli-0.9.0/whirlpool-client-cli-0.9.0-run.jar
```

{% hint style="info" %}
Make sure you verify you have the latest release at: <https://github.com/Samourai-Wallet/whirlpool-runtimes/releases&#x20>;
{% endhint %}

## Mobile App Pairing

Open up your Samourai Mobile Wallet

Press 3 dots on top right -> Settings -> Transactions-> Pair to Whirlpool GUI. Copy the code to clipboard

Send the code to yourself, how you feel is most secure.

## Back to Pi

Make sure you are in your whirlpool directory and run the following command:

```
$ java -jar whirlpool-client-cli-0.9.0-run.jar --init 
```

{% hint style="info" %}
This starts the initial installation process. You will be asked to if you want to run through Tor: Yes. And ask for the pairing code: Paste went asked.&#x20;

Also note, grab the API key that will be spit out during this command. It is also located in the config file that is generated. You'll need that later
{% endhint %}

Now once the init install is complete it will close out whirlpool. Now we will change things a little for better configurations: However you will be able to change more in the GUI once we pair it.

```
$ java -jar whirlpool-client-cli-0.9.0-run.jar --server=mainnet --tor --auto-mix --authenticate --mixs-target=0 --listen
```

{% hint style="info" %}
Set --mixs-target=0 for infinite mixes by default, or change to any number you'd like. This can also be configured in the GUI.
{% endhint %}

So at this point Whirlpool Cli will run and eventually prompt you with your Samourai wallet passphrase. Enter that and it will begin to mix.

## Whirlpool GUI

Let's install the Whirlpool GUI on a your main computer for a beautiful interface.

Go to <https://github.com/Samourai-Wallet/whirlpool-gui/releases> and grab the appropriate file for your system. For this guide: I'll just use the App.Image

```
$ wget https://github.com/Samourai-Wallet/whirlpool-gui/releases/download/0.9.0/whirlpool-gui.0.9.0.AppImage
$ sudo chmod +x whirlpool-gui.0.9.0.AppImage
```

Now lets launch it:

```
$ ./whirlpool-gui.0.9.0.AppImage
```

Ok so you'll be shown with two options: Standalone CLI or Remote CLI. Select remote CLI (our pi)

Next you'll need to enter your Pi's IP address: 192.168.X.XXX&#x20;

API Key you saved earlier, copy the code, click on the api box and hit Ctrl+V.&#x20;

Leave the Port alone

Now connect. May take a minute or so, but you'll see the wallet ask for your passphrase again. This is your Mobile wallet BIP39 passphrase you entered in the CLI.&#x20;

Once it registers you'll be connected for self-sovereign continuous mixing.&#x20;

## Credits

Big thanks to PuraVida and the Whirlpool telegram group. And of course the Samourai Dev team for building awesome Bitcoin products.

Don't be afraid to ask other questions in the telegram group:  <https://t.me/whirlpool_trollbox>

DM me on Twitter: @BTCxZelko or Telegram @BTCxZelko if you have any questions.

<https://tippin.me/@BTCxZelko>  <---So my wife doesn't kill me :sweat\_smile:&#x20;


---

# 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://bitcoin-on-raspberry-pi-4.gitbook.io/workspace/installing-whirlpool.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.