mirror of
https://github.com/bisq-network/bisq.git
synced 2024-11-19 09:52:23 +01:00
96 lines
2.1 KiB
Markdown
96 lines
2.1 KiB
Markdown
# 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's are known to work well:
|
|
|
|
* Ubuntu 18.04
|
|
* Ubuntu 20.04
|
|
* FreeBSD 12
|
|
|
|
### Installation
|
|
|
|
Start with a clean Ubuntu server installation, and run the script
|
|
```bash
|
|
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
|
|
```bash
|
|
ufw allow 22/tcp
|
|
ufw allow 8333/tcp
|
|
ufw enable
|
|
```
|
|
|
|
### Syncing
|
|
|
|
After installation, watch the Bitcoin blockchain sync progress
|
|
```bash
|
|
sudo tail -f /bitcoin/debug.log
|
|
```
|
|
|
|
After Bitcoin is fully synced, start the bisq service
|
|
```bash
|
|
sudo systemctl start bisq
|
|
sudo journalctl --unit bisq --follow
|
|
```
|
|
|
|
After Bisq is fully synced, check your Bitcoin and Bisq onion hostnames:
|
|
```bash
|
|
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:
|
|
```bash
|
|
/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
|
|
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
|
|
```bash
|
|
sudo -u bisq -s
|
|
cd bisq
|
|
git fetch origin
|
|
git checkout v1.2.5 # new tag
|
|
./gradlew clean 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
|
|
```bash
|
|
sudo ./delete_seednode_debian.sh
|
|
```
|
|
WARNING: this script will delete all data!
|
|
|