Sparrow Server - GUIDE.md

2026-01-27 00:43:45 +00:00 · 2023-04-29 02:15:34 +00:00 · 2023-04-29 02:15:34 +00:00 · bc3320f85d
commit bc3320f85d
parent d29b373056
2 changed files with 113 additions and 5 deletions
--- a/headless-bisq/GUIDE.md
+++ b/headless-bisq/GUIDE.md
@ -42,11 +42,12 @@ sudo apt update && sudo apt upgrade
 ### Install GUI utility
 sudo apt install xdg-utils
 ### Download, verify and install Bisq
-wget https://bisq.network/downloads/v1.9.9/Bisq-64bit-1.9.9.deb
-wget https://bisq.network/downloads/v1.9.9/Bisq-64bit-1.9.9.deb.asc
-curl https://bisq.network/downloads/v1.9.9/E222AA02.asc | gpg --import
-gpg --verify Bisq-64bit-1.9.9.deb.asc
-sudo dpkg -i Bisq-64bit-1.9.9.deb
+VERSION="1.9.9"
+wget https://bisq.network/downloads/v$VERSION/Bisq-64bit-$VERSION.deb
+wget https://bisq.network/downloads/v$VERSION/Bisq-64bit-$VERSION.deb.asc
+curl https://bisq.network/downloads/v$VERSION/E222AA02.asc | gpg --import
+gpg --verify Bisq-64bit-$VERSION.deb.asc
+sudo dpkg -i Bisq-64bit-$VERSION.deb
 ### Often the location of the Bisq binary won't be in your $PATH
 ### Edit your .bashrc (Also install vim because it kicks ass):
 sudo apt install vim
--- a/sparrow-server/GUIDE.md
+++ b/sparrow-server/GUIDE.md
@ -0,0 +1,107 @@
+# Sparrow Server - 24/7 Mixing
+
+### Introduction
+In this guide I will walk you through how to use [Sparrow Server](https://www.sparrowwallet.com) on your headless Bitcoin node to allow you to mix 24/7 without leaving your laptop running all night.
+
+I used [RaspiBolt's Guide](https://raspibolt.org/guide/bonus/bitcoin/sparrow-terminal.html) as the basis for this guide but modified it for a Intel/AMD Debian/Ubuntu based server.
+
+### Pre-requisites
+Technically you can do this without a private Electrum server and opt to use the public Electrum servers that Sparrow offers in it's server preferences. If you want to use your own node I used @k3tan's [Ministry of Nodes Guide](https://youtube.com/playlist?list=PLCRbH-IWlcW2A_kpx2XwAMgT0rcZEZ2Cg) 01 to 05 as the basis of my home Electrum server.
+
+Setup a Local machine with +1TB SSD:
+- [UNB22 - 01 - Overview](https://youtu.be/9Kb7TobTNPI)
+- [UNB22 - 02 - Planning Preparation and Installation of Ubuntu](https://youtu.be/siCQvYD6pro)
+- [UNB22 - 03 - Ubuntu Familiarisation](https://youtu.be/YpRuP_X1D2s)
+
+Setup Bitcoin Core on Local machine:
+- [UNB22 - 04 - Bitcoin Core](https://youtu.be/fx_mLXISrfM)
+
+Setup Fulcrum Server OR ElectrumX Server on Local machine:
+- [UNB22 - 05 - Fulcrum Server](https://youtu.be/SpQRrbJt7cg) OR
+- [Running an ElectrumX Server](https://youtu.be/QiX0rR_o_fI)
+
+This guide also assumes you already have Sparrow Wallet files that are setup to use [Whirlpool](https://www.sparrowwallet.com/docs/mixing-whirlpool.html).
+
+### Installing Sparrow Server
+
+SSH into your headless server:
+```bash
+ssh username@{headless-ip}
+sudo apt update && sudo apt upgrade
+### Download, verify and install Sparrow Server
+VERSION="1.7.6"
+wget https://github.com/sparrowwallet/sparrow/releases/download/$VERSION/sparrow-server_$VERSION-1_amd64.deb
+wget https://github.com/sparrowwallet/sparrow/releases/download/$VERSION/sparrow-$VERSION-manifest.txt.asc
+wget https://github.com/sparrowwallet/sparrow/releases/download/$VERSION/sparrow-$VERSION-manifest.txt
+curl https://keybase.io/craigraw/pgp_keys.asc | gpg --import
+gpg --verify sparrow-$VERSION-manifest.txt.asc
+sha256sum --check sparrow-$VERSION-manifest.txt --ignore-missing
+sudo dpkg -i sparrow-server_$VERSION-1_amd64.deb
+### Often the location of the Sparrow binary won't be in your $PATH
+### Edit your .bashrc (Also install vim because it kicks ass):
+sudo apt install vim
+sudo vim ~/.bashrc
+### Add the end of the .bashrc include this:
+export PATH="/opt/sparrow/bin:$PATH"
+### exit with :wq
+### reload your bash script:
+source ~/.bashrc
+```
+
+### Keeping Sparrow Server Running 24/7
+
+If you open `Sparrow` from your ssh session you will get a nice blue colored terminal UI. Familiarise yourself with the interface it varies in a few ways from the regular desktop GUI. Exit `Sparrow` in your ssh session.
+
+#### Optional: Connect to your local Electrum Server
+
+If you are running your own Electrum Server on the same headless server then while within `Sparrow` go to `Preferences > Server` and select `Private Electrum` and `Continue`. Set values according to your Electrum Server implementation and test connection.
+
+```bash
+# For Electrs (default)
+URL: 127.0.0.1:50001
+Use SSL?: No
+  
+# For Fulcrum 
+URL: 127.0.0.1:50002
+Use SSL?: Yes 
+```
+
+You are now connected to your own Electrum Server
+
+#### Copy existing Wallet files to server
+
+Install [rsync](https://www.digitalocean.com/community/tutorials/how-to-use-rsync-to-sync-local-and-remote-directories) on both your laptop and your headless server:
+```bash
+sudo apt install rsync
+ssh username@{headless-ip}
+sudo apt install rsync
+exit
+### copy wallet files to server
+rsync -aP .sparrow/wallets/* username@{headless-ip}:.sparrow/wallets/
+```
+
+### Keeping Sparrow Server Running 24/7 - ctd.
+
+Sparrow server doesn't come with a way to run as a `system daemon`, so you will have use something like [tmux](https://linuxhandbook.com/tmux/) to allow you to run Sparrow server and keep it running in the background on your server.
+
+While still in your ssh session install tmux:
+```bash
+sudo apt install tmux
+```
+
+Now start a new tmux session for your Sparrow Server
+```bash
+tmux new -s sparrowserver
+### This will open a tmux terminal instance
+### Run Sparrow
+Sparrow
+```
+
+Using Sparrow Server open the wallet files you copied across. Enter passwords and passphrases (if needed). Go to `Postmix > UTXOs > Mix To...` and set `Postmix index range` to Odd. Now lock your wallet files and exit the tmux session by using `ctrl+b` then `d`.
+
+#### Accessing your tmux session
+When you want to access the tmux session again use this command:
+```bash
+tmux a -t sparrowserver
+```
+This will bring up your Sparrow Server instance as you left it.