seednode: remove some files, add dockerfile and readme with instructions

This commit is contained in:
erciccione 2022-07-08 09:33:14 +02:00 committed by woodser
parent 1512ed9db3
commit 1498423b4e
10 changed files with 41 additions and 240 deletions

View file

@ -1,95 +1,23 @@
# Bisq Seed Node
# Haveno Seednode
## Hardware
Currently a seednode can be deployed using the Dockerfile in the `docker/` folder.
Highly recommended to use SSD! Minimum specs:
Make sure you have Tor installed in your host environment (`apt install tor`), then navigate to the `docker` folder and from there build the Docker image:
* 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
```
docker build -t haveno-seednode .
```
This will install and configure Tor, Bitcoin, and Bisq-Seednode services to start on boot.
Then create a container from it:
### Firewall
Next, configure your OS firewall to only allow SSH and Bitcoin P2P
```bash
ufw allow 22/tcp
ufw allow 8333/tcp
ufw enable
```
docker run -it -p 9050 -p 2002 --restart unless-stopped --name haveno-seednode haveno-seednode
```
### Syncing
After the seednode is deployed, you'll see a message similar to this in the log:
After installation, watch the Bitcoin blockchain sync progress
```bash
sudo tail -f /bitcoin/debug.log
```
[TorControlParser] INFO o.b.n.tor.Tor: Hidden Service 3jrnfkgkoh463zic54csvntz5w62dm2zno54c3c6jgvusafosqrgmnqd.onion has been announced to the Tor network.
```
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!
Note the onion address. It will be needed by the Haveno instances wanting to connect to your seednode.