A minimalistic, security focused linux environment for JoinMarket with a terminal based graphical menu.
- Send transactions with improved privacy using CoinJoin and PayJoin
- Run the Yield Generator as a service and earn fees for providing liquidity
- Use the JoinMarket-QT GUI remotely over SSH
- Signet support to test for free
- Try signet locally
- Connect remotely to a
- RaspiBlitz over LAN or Tor
- RoninDojo over LAN or Tor
- Run locally as part of the RaspiBlitz SERVICES
- Start a pruned node from https://prunednode.today/
The addresses, transactions and balances of JoinMarket can be seen in the watch-only wallet of the connected node.
- use your own or trusted node
- to protect privacy in case of physical access use disk encryption
- RaspberryPi 4 (alternatively any other computer running a Debian Linux flavour)
- Power supply (5V 3A and above recommended)
- Heatsink case
- 16GB SDcard (minimum)
- (USB SSD to run a pruned bitcoin node locally)
- other tested hardware
JoininBox operates on the minimum viable hardware under the assumption that the seed (and passphrase) of the wallets used is safely backed up and can be used to recover the funds!
-
Find the links to the prebuilt image in the releases
-
Write to the SDcard with Balena Etcher
-
Assemble the RaspberryPi and connect with a LAN cable to the internet
-
Make sure that your laptop and the RPi are on the same local network
-
Boot by connecting the power cable
-
Open a terminal (OSX/Win10) and connect with ssh.
Use the hostname of the latest SDcard image (rpi4-20210210
) or to find the IP address to connect to:- scan with the AngryIP Scanner
- use
sudo arp -a
or - check the router interface
ssh joinmarket@rpi4-20210210
→ use the password:joininbox
-
after the first loging will be prompted to change the password to access Joininbox
-
next will be presented with the CONFIG menu to
- Edit the joinmarket.cfg manually
- Connect to a remote bitcoin node on mainnet
- Try JoinMarket on signet
-
Continuing with one of the options or exiting will get you to the main JoininBox menu where you can start using JoinMarket
-
Find more info on the usage and community help at the end of this readme
- Debian Buster X86_64 desktop
- Raspberry Pi 4 running 64bit Debian Buster
- Hardkernel Odroid XU4/HC1 running 32bit Armbian Buster
- Hardkernel Odroid C4 running 64bit Armbian Focal and Buster
- Raspberry Pi Zero, 3 and 4 running RaspberryOS (32bit Buster)
-
Start 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
- 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 documentation
- Recommendations for users on waxwing's blog
- JoinMarket on the RaspiBlitz guide
- JoinMarket on Ubuntu video by K3tan
- How to use JoinMarket command line focused video by Keep It Simple Bitcoin
- Connect JoinMarket running on a Linux desktop to a remote node
- Telegram: https://t.me/joinmarketorg
- IRC: #joinmarket on Freenode
- Reddit: https://www.reddit.com/r/joinmarket/
- Keybase: https://keybase.io/team/raspiblitz#joinmarket
- For JoinMarket (general): https://bitcoinprivacy.me/joinmarket-donations
- To waxwing for JoinMarket: https://joinmarket.me/donations/
- To openoms for JoininBox (LN + payjoin enabled): http://7tpv3ynajkv6cdocmzitcd4z3xrstp3ic6xtv5om3dc2ned3fffll5qd.onion/apps/4FePMm7m818oppkTYNZRwbDnL6HP/pos