joininbox/README.md

JoininBox

A terminal based graphical menu for JoinMarket.

Build a dedicated JoinMarket Box remotely connected to a full node

Tested environments for JoininBox

• Debian Buster X86_64 desktop
• Hardkernel Odroid XU4 running 32 bit Armbian Buster
• Hardkernel Odroid C4 running 64bit Armbian Focal and Buster
• Raspberry Pi Zero, 3 and 4 running Raspberry OS (32 bit Buster)

Connected to Bitcoin Core

• running locally
• on RaspiBlitz over LAN or Tor
• on RoninDojo over Tor

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 to work as the root user or change with:
  $ sudo - su

• Run the build script:

  # download
  wget https://raw.githubusercontent.com/openoms/joininbox/master/build_joininbox.sh
  # inspect the script
  cat build_joininbox.sh
  # run
  sudo bash build_joininbox.sh
  

• start the JoininBox menu by changing to the joinmarket user in the terminal:
  $ sudo su joinmarket
  or
  log in with ssh to:
  joinmarket@LAN_IP_ADDRESS
  the default password is: joininbox - will be prompted to change it on the first start

---

More info

• Video demonstration / Slides of running JoinMarket with JoininBox on the RaspiBlitz
• How to prepare a remote node to accept the JoinMarket connection
• Frequently Asked Questions and notes
• JoinMarket on the RaspiBlitz guide
• Connect JoinMarket running on a Linux desktop to a remote node
• Instructions on how to build the JoininBox step-by-step manually

Forums

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