Setting up a ☁️ Bitcoin Full Node
Shia LaBeouf
In 2020 it is still hard to find quality instructions on how to run a bitcoin full node in the cloud. In this tutorial we want to share how it can be done in a somewhat time- and money-efficient way.
The tutorial steps you through the setup and some of our considerations how to achieve the initial sync in a reasonably fast way without depending pre-synced environments. We are offering recommendations, not guarantees. There is always potential to optimise - feel free to submit an improvement PR for the post 🤓
Google Cloud Setup bitcoind
For this tutorial we assume basic understanding of the Google Cloud platform. If you never used it before, but have e.g. AWS experience it should be easy to follow. If you don't have cloud platform experience at all you might have to consult the Google Cloud documentation on the way.
Setup Recommendations
Instance recommendations:
- Use a
e2-standard-4 (4 vCPUs, 16 GB memory)
instance for installation and initial sync. This machine will only be used for the first 12-24 hours with costs less than 4 AUD in total. - Use a
e2-small
instance (at least 2GB RAM) for running the node AFTER the initial sync. This costs about 33 AUD per month given 24/7 uptime.
Why do we recommend this?
We want to be economical, but we cannot wait forever. Syncing with a node < 8GB RAM takes significant time, we are talking weeks here not days. Running the strong machine for 12ish hours is actually cheaper than running a small machine for 1.5+ weeks. For more details on machine costs feel free to play with Google's pricing calculator.
More tutorial specs & quirks:
- We use
Debian
for our machine. Feel free to use a different distribution, but be aware that you might have to adapt tutorial-steps on the way. - We use an
additional HDD
that we attach to the instance instead of upping the instance's SSD because it is slightly cheaper.
Notes on costs:
Total cost point is about 33 AUD per month for the e2-small instance + 500 GB HDD when running 24/7. To give this a try for a month you should calculate with about 40 AUD of costs, assuming that you only run the e2-standard machine for the first 12-24h and then run an e2 machine. We feel these costs are not really a big deal for the sake of trying something awesome, but you should be aware that there are costs.
Instead of doing the setup yourself you can opt for using a pre-configured, pre-synced image provided on Google Cloud Marketplace. We opt for doing the setup ourselves to be in full control of what is going on.
Initial Google Instance Setup
We refer to Bitcoin Core as bitcoind, as in bitcoin daemon, throughout this tutorial.
Instance setup
- Create a
e2-standard-4 (4 vCPUs, 16 GB memory)
instance, provision it withDebian
. - Add a 500 GB harddisk to the instance (you can do this during instance setup at the bottom or later).
- Configure a static external IP address for the instance.
Configure the Google Cloud firewall
In this step we expose the port 8333 in the Google Cloud firewall so that the instance is publicly accessible on the layer-1 port.
You will have to configure a New Firewall
within the Network -> Firewall settings of the Google Comupte Engine.
- In your instance detail view you should see
Network interfaces
, click on thedefault
link underNetwork
. - Chose
Firewall
in the left hand menu - Click
Create Firewall
on the top - Define whatever name
- Change
Targets
toAll instances in the network
(or see Google Cloud docu) - Set
Source IP ranges
to0.0.0.0/0
(or see Google Cloud docu) - Specify port under
tsc
to8333
- Click
Create
The rule will automatically be applied to your instance (due to 5.).
Note: Setting up an ingress
(incoming from source to target) rule is all you need.
Getting bitcoind installed
In this tutorial we are building bitcoind from source. This can be changed to e.g. download the binary or use script like the one provided by bitnodes.io.
This tutorial is based on the latest UNIX build instructions for v0.20.1
of the docs in the bitcoin repo.
Prerequisites:
Make sure git
is installed:
Building bitcoind can take quite some time so we recommend running it using screen
:
Detach from screen with: ctrl
+ a
+ d
Re-attach to screen with: screen -r
Recommended: Run a screen session with command screen
then go on.
Install Dependencies
Install dependencies:
We need the wallet so we also have to configure Berkely DB. The latest Debian package manager does not link to the Berkley DB version that bitcoind requires, thus we opted for building Berkley DB from scratch:
Build and install bitcoind
Clone repo and checkout latest tag, in our case v0.20.1
:
Run autogen
script:
Run ./configure
script with options:
Build bitcoind:
Install bitcoind:
Mounting the harddisk as data dir for bitcoind
For details you can check the documentation.
We mount the disk to the default bitcoind data dir /var/lib/bitcoind
.
List disks:
Your disk should be named /dev/sdb
in the list. If not change the following commands accordingly.
Init disk:
Mount disk into bitcoind datadir (add to fstab
so it is automatically done upon system startup):
Starting bitcoind
As per the init instructions for adding bitcoind as service started at instance startup.
Navigate to contrib/init
dir within the bitcoin repo, you'll find the bitcoind.service
file there.
Copy said file to register the default configuration of the bitcoin service with systemd:
Enable the service in systemctl:
Bitcoind is now configured to start automatially at startup of the machine.
You can either restart the machine or just initially start the service manually:
The initial block sync will start automatically.
If you are syncing with a slow machine, and your sync seems to be stuck free to add some additional nodes to the configuration, you can find some on bitnodes.io. Some nodes have block download limits that can cause this behavior.
Example how to add this to the bitcoin.conf
in /etc/bitcoin/bitcoin.conf
(as per the bitcoin.service
definition):
You can find more configuration options in the official example config.
Configuring bitcoin-cli to pick up the right config file
In the current setup the bitcoin-cli is not able to determine the data-dir correctly.
The service file we copied earlier specifies the bitcoin config to be expected in the /etc/bitcoin
directory and the datadir as /var/lib/bitcoind
.
However, bitcoin-cli by defaults expects the config in the bitcoin user's home/.bitcoin
directory and cannot pickup the correct data-dir.
First we have to ensure that the configuration file /etc/bitcoin/bitcoin.conf
exists and specifies the data-dir:
In order to let bitcoin-cli pick up the correct config file we can create a symlink for convenience. Make sure you are in the bitcoin user's home directory:
Note: You can also opt for modifying the bitcoin.service
file if you prefer that.
Validate your setup
Once the bitcoind server is configured you can use bitnodes.io to check if your node is available. Enter your external IP and port 8333.
You should see a green xxx.xxx.xxx.xxx:8333 /Satoshi:0.yy.y
where yy.y
is the version of the node you are running.
To see the current sync status:
Should output:
In above example we are at 51.58736258855465%
sync.
⚠️ Don't forget! ⚠️
Don't forget to shutdown the Google Cloud instance after the initial sync, re-configure to an e2-small and then start it again!
If you let the e2.standard machine run for longer you will have significant costs!
Cleanup
If you want to trash everything, make sure to remove:
- The Google Cloud instance
- The Google Cloud harddisk(s)
- The static IP configuration
- Potentially remove firewall (should not cause costs though)