849bd7c286
Note that the default value of 600 advertised in BisqExecutable's option handling was incorrect. The actual value had since become 1200 MB. This correct default is now reflected in Config's option handling. |
||
---|---|---|
.. | ||
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!