GlcoinCore/joininbox
1
0
Fork 0
mirror of https://github.com/openoms/joininbox.git synced 2026-08-14 12:43:13 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 3
No description
381 commits 12 branches 52 tags 3.2 MiB
Find a file
openoms c6be35e427
INFO: menu options for m0, m4 and to show the DOCS 
related: https://github.com/openoms/joininbox/issues/33
2021-03-06 11:11:45 +00:00
images readme update 2021-02-15 11:42:19 +00:00
scripts INFO: menu options for m0, m4 and to show the DOCS 2021-03-06 11:11:45 +00:00
.gitignore add and update scripts 2020-01-22 22:24:21 +00:00
build_joininbox.md update joinmarket to v0.6.3.1 2020-07-01 12:05:10 +01:00
build_joininbox.sh match build script version with release 0.2 2021-02-15 08:58:11 +00:00
FAQ.md WALLET: add option to rescan wallet in bitcoind 2021-02-22 01:30:43 +00:00
prepare_remote_node.md bitcoinrpc: create a remote wallet 'joininbox' 2021-02-14 13:10:38 +00:00
README.md readme: add video from Keep It Simple Bitcoin 2021-03-05 13:49:21 +00:00

README.md

JoininBox

A minimalistic, security focused linux environment for JoinMarket with a terminal based graphical menu.

Features

  • 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

Connect to a Bitcoin Core node

  • 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
  • (Soon: run a pruned node locally on JoininBox)

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

Required 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 recovered fully

Set up with an SDcard image

  • Find the links to the prebuilt image in the releases

  • Verify the downloaded image

  • 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

    password change

  • 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

    config menu

  • Continuing with one of the options or exiting will get you to the main JoininBox menu where you can start using JoinMarket

    menu

  • Find more info on the usage and community help at the end of this readme

Set up JoininBox on Linux

Tested environments

Install JoininBox

  • 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

More info

About JoinMarket

Forums

Donations