You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Menu navigation
The guide navigation now uses generic descriptions instead of specific
software names. The chapter explaining the installation of the Bitcoin
client is now called "Bitcoin client" instead of "Bitcoin Core".
See discussion in raspibolt#930
Pull-request: raspibolt#938
# File structure
With the guide accumulating more technical support files, the guide
content itself got buried. Storing all core guide files in the root
directory became confusing with increasing scope. Moving all markdown
files into the /guide directory makes it human-readable again.
Images are kept in /images to keep it tidy.
Pull-request: raspibolt#941
@@ -47,7 +47,7 @@ This was the original goal of the RaspiBolt guide back in 2017: simply buying a
47
47
I used the [Eclair](https://github.com/ACINQ/eclair){:target="_blank"} Lighting implementation back then, on Lightning testnet, as mainnet was not even running yet.
48
48
Oh, how time flies...
49
49
50
-
[](https://vimeo.com/252693058){:target="_blank"}
50
+
[](https://vimeo.com/252693058){:target="_blank"}
51
51
52
52
Watch the [original screencast](https://vimeo.com/252693058){:target="_blank"} from back then.
53
53
@@ -64,4 +64,4 @@ Thanks to everyone who cares about Bitcoin and feels that running your own Bitco
* [**Learning Bitcoin from the Command Line**](https://github.com/ChristopherA/Learning-Bitcoin-from-the-Command-Line/blob/master/README.md){:target="_blank"} by Christopher Allen gives a thorough deep dive into understanding the technical aspects of Bitcoin.
418
418
@@ -457,7 +457,7 @@ When upgrading, there might be breaking changes, or changes in the data structur
457
457
* There's no need to stop the application.
458
458
Simply install the new version and restart the service.
459
459
460
-
* Download, verify, extract and install the Bitcoin Core binaries as described in the [Bitcoin section](bitcoin-core.md) of this guide.
460
+
* Download, verify, extract and install the Bitcoin Core binaries as described in the [Bitcoin section](bitcoin-client.md#installation) of this guide.
461
461
462
462
* Restart the Bitcoin Core systemd unit
463
463
@@ -469,4 +469,4 @@ When upgrading, there might be breaking changes, or changes in the data structur
Run your own private blockchain explorer with [BTC RPC Explorer](https://github.com/janoside/btc-rpc-explorer){:target="_blank"}. Trust your node, not some external services.
13
13
14
-
14
+
15
15
16
16
---
17
17
@@ -42,7 +42,7 @@ For the BTC RPC Explorer to work, you need your full node to index all transacti
42
42
43
43
* If you followed this guide, the transaction index parameter is already enabled (`txindex=1`), and you can skip to the next section.
44
44
45
-
* If this is not the case, you need to set the `txindex=1` parameter in your Bitcoin Core configuration file (`bitcoin.conf`): [Bitcoin node configuration](bitcoin-core.md#configuration).
45
+
* If this is not the case, you need to set the `txindex=1` parameter in your Bitcoin Core configuration file (`bitcoin.conf`): [Bitcoin node configuration](bitcoin-client.md#configuration).
46
46
47
47
* After adding the parameter, restart Bitcoin Core, which will now index the whole blockchain
48
48
@@ -70,7 +70,7 @@ You can follow the progress using `tail -f ~/.bitcoin/debug.log`.
70
70
71
71
### Firewall & reverse proxy
72
72
73
-
In the [Security section](security.md), we set up NGINX as a reverse proxy.
73
+
In the [Security section](../raspberry-pi/security.md#prepare-nginx-reverse-proxy), we set up NGINX as a reverse proxy.
74
74
Now we can add the BTC RPC Explorer configuration.
75
75
76
76
* Enable NGINX reverse proxy to route external encrypted HTTPS traffic internally to the BTC RPC Explorer
@@ -344,5 +344,5 @@ Updating to a [new release](https://github.com/janoside/btc-rpc-explorer/release
Copy file name to clipboardExpand all lines: guide/bitcoin/electrum-server.md
+7-7Lines changed: 7 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -36,7 +36,7 @@ Wallets like the [BitBoxApp](https://shiftcrypto.ch/app/){:target="_blank"}, [El
36
36
37
37
## Preparations
38
38
39
-
Make sure that you have [reduced the database cache of Bitcoin Core](bitcoin-core.html#reduce-dbcache-after-full-sync) after full sync.
39
+
Make sure that you have [reduced the database cache of Bitcoin Core](bitcoin-client.md#reduce-dbcache-after-full-sync)#prepare-nginx-reverse-proxy after full sync.
40
40
41
41
### Install dependencies
42
42
@@ -48,7 +48,7 @@ Make sure that you have [reduced the database cache of Bitcoin Core](bitcoin-cor
48
48
49
49
### Firewall & reverse proxy
50
50
51
-
In the [Security section](security.md), we already set up NGINX as a reverse proxy.
51
+
In the [Security section](../raspberry-pi/security.md), we already set up NGINX as a reverse proxy.
52
52
Now we can add the Electrs configuration.
53
53
54
54
* Enable NGINX reverse proxy to add SSL/TLS encryption to the Electrs communication.
@@ -311,7 +311,7 @@ Only proceed with the next section once Electrs is ready.
311
311
312
312
[Electrum wallet](https://electrum.org){:target="_blank"} is a well-established, feature-rich Bitcoin wallet for power-users that supports most hardware wallets.
@@ -346,14 +346,14 @@ If you start Electrum, the green LED in the bottom right indicates an active con
346
346
If you connect over Tor, make sure that Tor is installed on your regular computer.
347
347
There are two options:
348
348
349
-
* Easy: download, install and run [Tor Browser](https://www.torproject.org).
349
+
* Easy: download, install and run [Tor Browser](https://www.torproject.org){:target="_blank"}.
350
350
* The application must be started manually and run in the background whe you want to connect over Tor.
351
351
* Tor proxy available on port `9150`
352
352
353
353
* Expert: install Tor as a background service
354
354
* The background service must be installed, and is always active in the background.
355
355
* Tor proxy available on port `9050`
356
-
* See further installation instructions for [Windows](https://bitstobytes.org/tor), [macOS](https://deepdarkweb.github.io/how-to-install-tor-on-macos-tutorial/), and Linux (`sudo apt install tor`).
356
+
* See further installation instructions for [Windows](https://bitstobytes.org/tor){:target="_blank"}, [macOS](https://deepdarkweb.github.io/how-to-install-tor-on-macos-tutorial/){:target="_blank"}, and Linux (`sudo apt install tor`).
357
357
358
358
Now we need to specifiy the Tor address for Electrs and the local Tor proxy port in the Electrum configuration.
359
359
@@ -403,7 +403,7 @@ If you have Tor installed on your computer, you can access your RaspiBolt remote
403
403
* Enable it and confirm the proxy address (usually the default `127.0.0.1:9050`)
404
404
* When adding your RaspiBolt full node as described above, use your Tor address (e.g. `gwdllz5g7vky2q4gr45zGuvopjzf33czreca3a3exosftx72ekppkuqd.onion:50002`)
405
405
406
-
406
+
407
407
408
408
---
409
409
@@ -459,4 +459,4 @@ Make sure to check the [release notes](https://github.com/romanz/electrs/blob/ma
Copy file name to clipboardExpand all lines: guide/bonus/bitcoin/electrum-personal-server.md
+11-11Lines changed: 11 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -28,15 +28,15 @@ Status: Not tested v3
28
28
29
29
### Introduction
30
30
31
-
The best way to safekeep your bitcoin (meaning the best combination of security and usability) is to use a hardware wallet (like [Ledger](https://www.ledgerwallet.com/) or [Trezor](https://trezor.io/)) in combination with your own Bitcoin node. This gives you security, privacy and eliminates the need to trust a third party to verify transactions.
31
+
The best way to safekeep your bitcoin (meaning the best combination of security and usability) is to use a hardware wallet (like [Ledger](https://www.ledgerwallet.com/){:target="_blank"} or [Trezor](https://trezor.io/)){:target="_blank"} in combination with your own Bitcoin node. This gives you security, privacy and eliminates the need to trust a third party to verify transactions.
32
32
33
33
With the RaspiBolt setup, the Bitcoin Core wallet on the node can only be used from the command line as no graphical user interface is installed. As Bitcoin Core does not offer support for hardware wallets, only a "hot wallet" (exposed to the internet) can be realized.
34
34
35
-
One possibility to use Bitcoin Core with more functionality is to set up an additional [ElectrumX](https://github.com/kyuupichan/electrumx) server and then use the great [Electrum wallet](https://electrum.org/) (on your regular computer) that integrates with hardware wallets. But this setup is not easy, and the overhead is more than a Raspberry Pi can handle.
35
+
One possibility to use Bitcoin Core with more functionality is to set up an additional [ElectrumX](https://github.com/kyuupichan/electrumx){:target="_blank"} server and then use the great [Electrum wallet](https://electrum.org/){:target="_blank"} (on your regular computer) that integrates with hardware wallets. But this setup is not easy, and the overhead is more than a Raspberry Pi can handle.
36
36
37
-
The new [Electrum Personal Server](https://github.com/chris-belcher/electrum-personal-server) makes it possible to connect Electrum (using your hardware wallet) directly to your RaspiBolt. In contrast to ElectrumX, this is not a full server that serves multiple users, but your own dedicated backend.
37
+
The new [Electrum Personal Server](https://github.com/chris-belcher/electrum-personal-server){:target="_blank"} makes it possible to connect Electrum (using your hardware wallet) directly to your RaspiBolt. In contrast to ElectrumX, this is not a full server that serves multiple users, but your own dedicated backend.
38
38
39
-
Before using this setup, please familiarize yourself with all components by setting up your own Electrum wallet, visiting the linked project websites and reading [The Electrum Personal Server Will Give Users the Full Node Security They Need](https://bitcoinmagazine.com/articles/electrum-personal-server-will-give-users-full-node-security-they-need/) in Bitcoin Magazine.
39
+
Before using this setup, please familiarize yourself with all components by setting up your own Electrum wallet, visiting the linked project websites and reading [The Electrum Personal Server Will Give Users the Full Node Security They Need](https://bitcoinmagazine.com/articles/electrum-personal-server-will-give-users-full-node-security-they-need/){:target="_blank"} in Bitcoin Magazine.
40
40
41
41
### Preparations
42
42
@@ -46,7 +46,7 @@ Before using this setup, please familiarize yourself with all components by sett
46
46
$ sudo pip3 install setuptools
47
47
```
48
48
49
-
* Configure firewall to allow incoming requests (please check if you need to adjust the subnet mask as [described in original setup](raspibolt_20_pi.md#enabling-the-uncomplicated-firewall))
49
+
* Configure firewall to allow incoming requests (please check if you need to adjust the subnet mask as [described in original setup](../../raspberry-pi/security.md#enabling-the-uncomplicated-firewall))
50
50
```sh
51
51
$ sudo ufw allow from 192.168.0.0/24 to any port 50002 comment 'allow EPS from local network'
52
52
$ sudo ufw enable
@@ -66,7 +66,7 @@ Electrum Personal Server uses the Bitcoin Core wallet with "watch-only" addresse
66
66
* Open a "bitcoin" user session and change into the home directory
67
67
`$ sudo su - bitcoin`
68
68
69
-
* Download, verify and extract the latest release (check the [Releases page](https://github.com/chris-belcher/electrum-personal-server/releases) on Github for the correct links)
69
+
* Download, verify and extract the latest release (check the [Releases page](https://github.com/chris-belcher/electrum-personal-server/releases){:target="_blank"} on Github for the correct links)
70
70
71
71
```sh
72
72
# create new directory on external hdd
@@ -118,10 +118,10 @@ Electrum Personal Server uses the Bitcoin Core wallet with "watch-only" addresse
118
118
$ pip3 install --user .
119
119
```
120
120
121
-
121
+
122
122
123
123
### First start
124
-
The Electrum Personal Server scripts are installed in the directory `/home/bitcoin/.local/bin/`. Unfortunately, in Raspberry Pi OS this directory is not in the system path, so the full path needs to be specified when calling these scripts. Alternatively, just [add this directory to your $PATH environment variable](https://unix.stackexchange.com/questions/26047/how-to-correctly-add-a-path-to-path), but it's not necessary in this guide.
124
+
The Electrum Personal Server scripts are installed in the directory `/home/bitcoin/.local/bin/`. Unfortunately, in Raspberry Pi OS this directory is not in the system path, so the full path needs to be specified when calling these scripts. Alternatively, just [add this directory to your $PATH environment variable](https://unix.stackexchange.com/questions/26047/how-to-correctly-add-a-path-to-path){:target="_blank"}, but it's not necessary in this guide.
125
125
126
126
* The first time the server is run it will import all configured addresses as watch-only into the Bitcoin node. This can take up to 10 minutes, after that the program will exit.
127
127
```sh
@@ -143,7 +143,7 @@ The Electrum Personal Server scripts are installed in the directory `/home/bitco
Copy file name to clipboardExpand all lines: guide/bonus/bitcoin/mempool.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ Difficulty: Medium
21
21
Status: Tested v3
22
22
{: .label .label-green }
23
23
24
-
24
+
25
25
26
26
---
27
27
@@ -56,7 +56,7 @@ To run Mempool, we need to run Node.js v16 or above.
56
56
> v16.13.1
57
57
```
58
58
59
-
* If Node.js is not installed, follow [this guide](https://raspibolt.org/btcrpcexplorer.html#install-nodejs) to install it. If the version is v14 or older, update it following [this tutorial](https://phoenixnap.com/kb/update-node-js-version){:target="_blank"}.
59
+
* If Node.js is not installed, follow [this guide](../../bitcoin/blockchain-explorer.md#install-nodejs) to install it. If the version is v14 or older, update it following [this tutorial](https://phoenixnap.com/kb/update-node-js-version){:target="_blank"}.
0 commit comments