02e7448bda
* Split seednode systemd service ExecStart command into multiple lines * Add setting in seednode configuration to specify btcnode host/port * Tweak seednode torrc configuration options to improve P2P connectivity * Require bitcoin.service from bisq-seednode.service via systemd binding * Make seednode installer run from master and build bisq from release tag * Seednode must be shutdown using `kill -9` until #3884 is fixed * Fix seednode uninstall script to use correct service names * Disable CircuitBuildTimeout in seednode Tor configuration * Disable seednode torrc advanced configuration options for now |
||
---|---|---|
.. | ||
docker | ||
src | ||
.dockerignore | ||
bisq-seednode.env | ||
bisq-seednode.service | ||
bitcoin.conf | ||
bitcoin.service | ||
blocknotify.sh | ||
create_jar.sh | ||
create_jaronly_archive.sh | ||
docker-compose.yml | ||
install_seednode_debian.sh | ||
README.md | ||
torrc | ||
uninstall_seednode_debian.sh |
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-seednode service
sudo systemctl start bisq-seednode
sudo journalctl --unit bisq-seednode --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-seednode!
macOS:
/Applications/Bisq.app/Contents/MacOS/Bisq --seedNodes=foo.onion:8000 --btcNodes=foo.onion:8333
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-seednode restart
sudo journalctl --unit bisq-seednode --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!