joininbox/README.md

JoininBox

A terminal based menu and helper UI for JoinMarket.

Install the JoininBox menu on a RaspiBlitz v1.5+

• Run the script in the RaspiBlitz terminal (will install JoinMarket if not active already):

  # download
  wget https://raw.githubusercontent.com/openoms/joininbox/master/build_menu_on_raspiblitz.sh
  # run
  bash build_menu_on_raspiblitz.sh
  

Build a dedicated JoinMarket Box remotely connected to a full node

• Test environments:
  • Hardkernel Odroid XU4 running Armbian
  • Raspberry Pi 3 and 4 running Raspbian
  • Debian Buster desktop
  • Connected to a RaspiBlitz 1.4 (any Bitcoin Core node can work, including previous RaspiBlitz versions)

Install and set up the base image

• Set up Armbian on the Hardkernel Odroid XU4
• Download and verify Raspbian SDcard image for a Raspberry Pi

Set up JoininBox

• Continue work as the root user.

• Continue with the manual building steps
  or

• Run the build script:

  # download
  wget https://raw.githubusercontent.com/openoms/joininbox/master/build_joininbox.sh
  # run (install Tor also)
  sudo bash build_joininbox.sh --with-tor
  

• start in the RaspiBlitz terminal: sudo su joinmarket

---

More info:

• How to prepare a remote node to accept the JoinMarket connection
• Manual instructions on how to build the JoininBox
• Frequently Asked Questions and notes
• JoinMarket on the RaspiBlitz guide
• Connect JoinMarket running on a Linux desktop to a remote node

Forums:

• Keybase: https://keybase.io/team/raspiblitz#joinmarket
• Telegram: https://t.me/joinmarketorg
• IRC: #joinmarket on Freenode
• Reddit: https://www.reddit.com/r/joinmarket/