bisq/seednode
Devin Bileck 0bab863ee9
Fix command shown in README used to install collectd service
The install_collectd_debian.sh script reads user input to obtain the
onion address. However, when you pipe the output of curl into the shell
you're making the script text be standard input of the shell, which
takes it in as commands to run. After that, there's nothing left to
read. Even if it were to try, it wouldn't get anything from the terminal
input, because it's not connected to it. The pipe has replaced standard
input for the shell process.

Instead, create a pipe for bash to read the output of curl from and
provide it as the script file argument. In this case, the standard input
of the script is still connected to the terminal, and read will work.
2020-06-17 22:35:02 -07:00
..
docker Remove myAddress from docs and scripts as it is not used/needed anymore 2019-03-08 10:58:53 -05:00
src Bump version number for v1.3.4 2020-04-30 10:19:27 +02:00
.dockerignore Merge seednode repository at eedf81c 2018-09-14 11:51:34 +02:00
bisq.env Monitoring install scripts (#3985) 2020-02-20 16:48:56 +01:00
bisq.service Increase BSQ explorer TMPFS allocation to 2GB for growing datastore 2020-05-09 12:30:15 +09:00
bitcoin.conf Add one command installation script for tor + btcnode + seednode 2019-12-20 21:35:12 +09:00
bitcoin.service Add one command installation script for tor + btcnode + seednode 2019-12-20 21:35:12 +09:00
blocknotify.sh Add missing blocknotify.sh script and README instructions 2019-11-17 04:29:49 -10:00
create_jar.sh Merge seednode repository at eedf81c 2018-09-14 11:51:34 +02:00
create_jaronly_archive.sh Add script to create seednode jar archive without jar deps 2019-12-06 22:40:54 +09:00
docker-compose.yml Merge seednode repository at eedf81c 2018-09-14 11:51:34 +02:00
install_seednode_debian.sh Update install scripts for Git LFS 2020-06-17 22:35:01 -07:00
README.md Fix command shown in README used to install collectd service 2020-06-17 22:35:02 -07:00
torrc Various improvements to seednode service / install scripts (#3882) 2020-01-29 11:28:12 +01:00
uninstall_seednode_debian.sh Additional tweaks to seednode installation script for new use cases (#3944) 2020-02-07 14:41:35 +01:00

Bisq Seed Node

Hardware

Highly recommended to use SSD! Minimum specs:

  • CPU: 4 cores
  • RAM: 8 GB
  • SSD: 512 GB (HDD is too slow)

Software

The following OS are known to work well:

  • Ubuntu 18
  • FreeBSD 12

Installation

Start with a clean Ubuntu 18.04 LTS server installation, and run the script

curl -s https://raw.githubusercontent.com/bisq-network/bisq/master/seednode/install_seednode_debian.sh | sudo bash

This will install and configure Tor, Bitcoin, and Bisq-Seednode services to start on boot.

Firewall

Next, configure your OS firewall to only allow SSH and Bitcoin P2P

ufw allow 22/tcp
ufw allow 8333/tcp
ufw enable

Syncing

After installation, watch the Bitcoin blockchain sync progress

sudo tail -f /bitcoin/debug.log

After Bitcoin is fully synced, start the bisq service

sudo systemctl start bisq
sudo journalctl --unit bisq --follow

After Bisq is fully synced, check your Bitcoin and Bisq onion hostnames:

sudo -H -u bitcoin bitcoin-cli getnetworkinfo|grep address
sudo cat /bisq/bisq-seednode/btc_mainnet/tor/hiddenservice/hostname

Testing

After your Bisq seednode is ready, test it by connecting to your new btcnode and bisq!

macOS:

/Applications/Bisq.app/Contents/MacOS/Bisq --seedNodes=foo.onion:8000 --btcNodes=foo.onion:8333

Monitoring

If you run a main seednode, you also are obliged to activate the monitoring feed by running

bash <(curl -s https://raw.githubusercontent.com/bisq-network/bisq/master/monitor/install_collectd_debian.sh)

Follow the instruction given by the script and report your certificate to the seednode group!

Upgrading

To upgrade your seednode to a new tag, for example v1.2.5

sudo -u bisq -s
cd bisq
git fetch origin
git checkout v1.2.5 # new tag
./gradlew clean
./gradlew build -x test
exit
sudo service bisq restart
sudo journalctl --unit bisq --follow

Uninstall

If you need to start over, you can run the uninstall script in this repo

sudo ./delete_seednode_debian.sh

WARNING: this script will delete all data!