Haveno - A decentralised private key exchange infrastructure for Monero

How to Install Haveno on Tails

Administrator -

Overview

Haveno is a decentralized exchange (DEX) for Monero. This guide will walk you through installing Haveno on Tails OS using Flatpak. Since Tails is an amnesic OS, we will also cover how to install Flatpak and Haveno with persistence enabled, so the installation remains after reboots.

Prerequisites

  1. Tails OS Installed with Persistence Enabled: You must have Tails OS with persistent storage enabled. If you're unsure how to do this, you can follow the instructions here.
  2. Internet Connection: Tails OS routes all internet traffic through Tor by default, ensuring privacy.

Step-by-Step Installation Guide

Step 1: Enable Persistent Storage on Tails

  1. Boot into Tails.

  2. Enable persistent storage by following the official guide here.

  3. Ensure that persistence is unlocked when you start Tails.

    • Open the Tails Persistent Storage application.
    • Check "APT Packages" to allow installing software persistently.

  4. After setting up persistence, restart Tails and make sure it loads with persistence enabled.

Step 2: Set Up Flatpak on Tails

Flatpak is not installed by default on Tails, so you’ll need to install it. Since Tails resets most changes after reboot, make sure to follow the persistence steps carefully.

  1. Open a terminal in Tails.
  2. Install Flatpak by running the following commands:
sudo apt update
sudo apt install flatpak
  1. Once Flatpak is installed, add the Flathub repository to persist it across reboots:
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Step 3: Install Haveno with Flatpak

Now that Flatpak is installed and Flathub is added, you can install Haveno.

  1. Run the following command to install Haveno:
flatpak install flathub io.haveno.Haveno
  1. After installation, Haveno will be available in your applications menu. To ensure Haveno persists across reboots, you must install it while persistence is enabled (confirm this in your persistent storage settings).

Step 4: Running Haveno

  1. Launch Haveno by either clicking it from your application launcher or running the following command in the terminal:
flatpak run io.haveno.Haveno
  1. Haveno will automatically route traffic through Tor, as Tails routes all network activity through Tor by default.

Step 5: Configure Monero Node (Optional)

Haveno requires access to the Monero network to function. You can either run a local Monero node or connect to a remote one.

Option 1: Running a Local Monero Node

If you want to run your own Monero node, you'll need to install the Monero daemon on Tails:

  1. Download the Monero binaries from getmonero.org.
  2. Unpack and set up the Monero daemon in a persistent directory.
  3. Configure Haveno to connect to your local Monero node.

Option 2: Connecting to a Remote Monero Node

  1. Open Haveno.
  2. Navigate to Settings > Monero Node and input the IP address and port of a trusted remote Monero node.

Troubleshooting

Problem: Haveno doesn't persist after reboot

Make sure you've enabled persistence for "APT Packages" and installed Flatpak with persistence enabled. To confirm, check the persistent storage settings in Tails.

Problem: Haveno doesn't launch

If Haveno fails to launch, try running it from the terminal:

flatpak run io.haveno.Haveno

Problem: Flatpak installation issues

If Flatpak fails to install, ensure you have persistence enabled and have allowed "APT Packages" in the persistent storage settings. Also, verify your network connection.

Additional Resources