A complete beginners guide to installing a Bitcoin Full Node on Linux (2018 Edition)

How to compile a Bitcoin Full Node on a fresh installation of Kubuntu 18.04 without any Linux experience whatsoever. Preface I recently installed a new SSD so I wouldn’t have to prune on my laptop and figured I’d give creating a tutorial a shot. Never used Linux? Don’t know what “prune” means? This one’s for you. I want you to learn Linux, and I want Bitcoin to motivate you to switch. This will be as much a “Linux for Dummies” guide as it is a guide to setting up a Bitcoin node. Perfect. If you already know a thing or two and want to skip all the useless words: Just copy and paste the commands at the bottom of this article. Most tutorials just give you the steps, and while some are actually pretty good at elaborating a bit this one is going to spoon feed you all the questions you might have, down to what each command does. The only precursor knowledge I’ll assume you have is the ability to how to download & mount the I link below, , and follow the default install instructions. I’ll be making no major changes to the default install configuration except for encrypting my entire drive and importing my desktop preferences and theme. We want to avoid complications, which is why I won’t be installing anything else first, just Bitcoin and the screen capturing software, so any issues along the way we should both have. If you run into any other issues, got confused somewhere, or think I should include something, just comment below or reach out to me on and I’ll try to assist or amend the article. literally figure out ISO image boot it dependency Twitter This tutorial was semi-inspired by . Grubles Lightning Network tutorial Part I — Setting Up Skip this section entirely if you’re already on Linux. Download Kubuntu ISO image is , The most recent release is . Kubuntu Ubuntu but shiny . LTS 18.04 Install ISO image to USB or CD Follow Ubuntu’s official tutorial for or . Windows macOS Install the OS You’ll set up a computer name, user, and password. My username for this tutorial will be , and the computer name will be . satoshi nakamoto Log In After installation and a successful login, your desktop should look like the screenshot below. Feel free to play around and get accustomed, but at some point navigate to the Application Launcher and run Terminal . (Konsole) We’re going to be working within this single window for the majority of this tutorial until we get to the end, but I’m going to open up the File Manager, called Dolphin, as well as import my theme and desktop preferences. Before we enter anything into the terminal let’s take a look at what we already see. At the top of the terminal window it says “Konsole”. That’s just the name of the software specific to this desktop environment. Sometimes you’ll see it referred to as Terminal, Command Line, or just the shell. is the username. is the computer’s and will show up on whatever network you may be connected to. Yours will be whatever you selected during the installation. **satoshi** **nakamoto** hostname In between the and you’ll see a . This is an abbreviation for your directory. is like “My Documents” in Windows. **:** **$** **~** /home/ /home/ These two mean the same thing, but you’ll always just see when in there: **~** **satoshi@nakamoto:~$** **satoshi@nakamoto:/home/satoshi$** Part II — Prerequisites & Dependencies Skim this section for the commands if you’re already on Linux. I’ll even condense them all at the bottom of this article for those who don’t need the explanations. The first thing we’re going to do in the terminal is check for updates. Type the following and hit enter : (along the way you’ll be prompted to type “y” for yes, and your password) **satoshi@nakamoto:~$** sudo apt-get update is sometimes called “superuser do”. It’s kind of like using “Run as administrator” in Windows, but better. It’s necessary throughout this tutorial because the commands that follow it will try to do things that require superuser privileges. sudo lets you interface with available software libraries so you can download software straight from the terminal. apt-get is one of a few commands that must follow the use of , and it will check for updates to any packages you have installed and install them. update apt-get Next we’re going to install . It’s widely used open designed for handling other open-source projects. We’ll be using Git to access the Bitcoin repository and download its code. Git source-software (and closed) **satoshi@nakamoto:~$** sudo apt-get install git should be self explanatory, it’s like , but for when you’re installing a specific package for the first time. It requires a package name. install update is the name of the Git package, and is recognized as such by the list of the command refers to. It will also function as a command after it is installed. git sources apt-get — — — — Now we’re going to make a folder within our home directory and then change to that directory so we can copy the files we need right into it. We clone this into any folder we want, this is just the path I chose to create within the home folder. could First, enter the following line: **satoshi@nakamoto:~$** mkdir -p bitcoin-source && cd bitcoin-source Now it should look like: **satoshi@nakamoto:/home/satoshi/bitcoin-source$** makes a directory. This is like right clicking on the desktop or in a window and selecting “New > Folder”. mkdir is a flag. Flags are and will start with a . Each command has their own set of options, so may do something else for another command. In this case overrides some errors you might get when trying to create a directory, and actually does what you’d probably want to do in the first place. If you wanted to create the directory , without , it thinks you just want and you would get saying and don’t exist. With those errors are ignored and both parent directories that “don’t exist” are created as well. -p command-line options **—** (like mkdir ) -p -p mkdir /test1/abc123/haha -p /haha an error /test1 /abc123 -p is just the directory/folder name we’re going to create. bitcoin-source allows you to execute another command on the same line, but will only execute the second command if the first command doesn’t fail with an error. && will change the current directory to the one you specify. In this case it will change to the directory we just created. cd /bitcoin-source Then enter: **$** git clone [https://github.com/bitcoin/bitcoin.git](https://github.com/bitcoin/bitcoin.git) will copy the Bitcoin repository from Github.com into the directory you’re in when you enter the command. Since were in , this will create the directory and place all the necessary files in there. git clone ~/bitcoin-source ~/bitcoin-source/bitcoin — — — — You can check to see if the files installed by using the command, or you can browse to that directory in the File Manager. ls **$** ls bitcoin will output all the non-hidden folders in the directory you’re currently in. ls will look for a folder within the directory you’re in, and then output all the non-hidden folders in that directory. ls bitcoin /bitcoin will output all folders, including hidden folders if any exist. Hidden folders begin with a and will look like this: /home/satoshi**/.abc123** ls -a **.** Navigate to this folder and stay here, you’ll see files get created later when we run some other commands. — — — — Now we need to install some , along with the . When installing libraries you can sometimes list many in a single command and separate them with a single space. In this tutorial I’ve split them into groups per the on Github for Ubuntu, as I’ve tried to combine them before and have gotten errors: libraries Berkeley Database build documentation Libraries: $ sudo apt-get install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils python3 $ sudo apt-get install libboost-all-dev Videos I took longer than 60’s are getting cut by the host site, not much of an issue here though. — — — — This will download and verify the Berkeley Database is legitimate: $ wget http://download.oracle.com/berkeley-db/db-4.8.30.NC.tar.gz$ echo '12edc0df75bf9abd7f82f821795bcee50f42cb2e5f76a6a281b85732798364ef db-4.8.30.NC.tar.gz' | sha256sum -c After entering the echo command you should get this response back: db-4.8.30.NC.tar.gz: O`K I cut the video during the download here, it took about 6 minutes for me. — — — — The following commands will extract ( )the Berkley Database we just downloaded and checked, then build and install it. It will also set a path shortcut so only needs to be typed when referencing the dependency. Normally when entering a command, if you’re already halfway into the path you only need to reference to the remaining path, but when you’re compiling you want to ensure the full path gets referenced: tar -xvf BDB_PREFIX $ tar -xvf db-4.8.30.NC.tar.gz$ cd db-4.8.30.NC/build_unix$ mkdir -p build$ BDB_PREFIX=$(pwd)/build$ ../dist/configure --disable-shared --enable-cxx --with-pic --prefix=$BDB_PREFIX$ sudo make install$ cd ../.. The database took about 2 minutes during . I cut that out. sudo make install — — — — More Libraries: $ sudo apt-get install libminiupnpc-dev$ sudo apt-get install libzmq3-dev$ sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler$ sudo apt-get install libqrencode-dev That concludes the prerequisites, now onto actually installing Bitcoin. Part III — Compiling Bitcoin Core 0.16.3 (This was originally written for 0.16.0, but a critical bug was detected and patched in 0.16.3. There should be no installation complications otherwise.) We’re still in so let’s move into the directory, compile, and install: /home/satoshi/bitcoin-source /bitcoin $ cd bitcoin$ git checkout tags/v0.16.3$ ./autogen.sh$ ./configure CPPFLAGS="-I${BDB_PREFIX}/include/ -O2" LDFLAGS="-L${BDB_PREFIX}/lib/" --with-gui make sudo make install $ $ will reference the specific “commit” from the git history. “Branches” can change as updates occur so referencing a branch may make the command not work in the future. git checkout tags/v0.16.3 will, simply put, prepare the build files for install. ./autgen.sh The video cut short before the & commands, but it took about 25 minutes to complete. make sudo make install Once that completes you have Bitcoin Core installed. Part IV — Configuring and familiarizing yourself with your new node Much of this section isn’t required to run the software. In the future you’ll likely just run it in the background and let it be. Again, this just to help you get a feel for what’s going on behind the scenes, not just trusting a background process to work. The first thing I want you to do is set up a few windows before we run Bitcoin for the first time. We’re going to run the GUI version first, called , then we’ll exit it and run the non-GUI version called , and then back to with some steps and configuration in between so you can understand what’s really happening and feel comfortable starting and stopping the software when you need to. bitcoin-qt bitcoind bitcoin-qt, Close all open windows, and open two brand new terminal windows and the file manager. In the file manager navigate to You only have to click on the sidebar. Then from the menu bar at the top select and check the box for . In one of the terminal windows enter the following: /home/satoshi/. Home Control Hidden Files mkdir ~/.bitcoin**$** $ cd ~/.bitcoin You should now see a folder named appear in the file manager as well. Navigate into that folder, and we’re now redundantly in this directory both in the terminal and file manager, but for a reason. .bitcoin — — — — Now we’re going to create a file called . When you first launch Bitcoin, both this hidden folder, and the debug.log file are automatically created, but you’ll see why I want to do this ahead of time in a moment: debug.log **$** touch ~/.bitcoin/debug.log Now we’re going to the file. Log files get updated continuously with new lines of information as the program takes a log of it’s actions. The command shows you the most recent entries into that file, but only once. Using the flag will give you a continuously running stream of those updates. When you enter the following command you’ll see nothing because Bitcoin isn’t running yet, but we’ll leave it like this for now: tail debug.log tail -f **$** tail -f ~/.bitcoin/debug.log In the terminal window we opened, run Bitcoin by entering the following: other **$** bitcoin-qt You’ll see the loading image and then the GUI with a message that shows the syncing status. If we never created that folder you also see the setup screen where you’d select the location you want to store the blockchain data and other files. The default location is the folder we just created so it won’t ask and just assume. .bitcoin (/home/satoshi/.bitcoin) You’ll start to see activity in the terminal where you tailed the file. All of the above should look like this on your screen: debug.log I had to record over the recording here to block out my IP address, so you’ll see another taskbar pop up. You can watch this for however long you want because it will take a long time to sync, but at some point, in the terminal window you entered on, press . You’ll see the GUI close down, and the log file will stop. You can read the exit messages in the log, and you can scroll up and read all the different events that occurred. Now that it’s stopped, in the same terminal you ran in, type the following: bitcoin-qt CONTROL+C bitcoin-qt **$** bitcoind You should see the log tail going again, but this time you won’t see the GUI. Bitcoin is running in the background. Hit again and let it stop. CONTROL+C — — — — We need to create a configuration file now so n the file explorer create a file called bitcoin.conf . Open it, type the following and save the file: debug=net By default, not all the debug information is included in the log file. Setting it to will include all of it, but there’s way too much to that all the info flies by too fast. All the options you can set are: net, tor, mempool, http, bench, zmq, db, rpc, estimatefee, addrman, selectcoins, reindex, cmpctblock, rand, prune, proxy, mempoolrej, libevent, coindb, qt, leveldb. **1** Disclaimer: Do not leave debug set to 1 indefinitely or your log file will grow larger than the entire blockchain and fill up your hard drive. This is also where you can optionally set your node to the blockchain as it goes along. Right now the entire blockchain is about 160 GB in size. If you don’t have enough storage space, you could prune the data down to under 5 GB at the moment. I don’t recommend doing that unless you to, but this is what you would enter on it’s own line to bring it down to 10 GB: prune need debug=net prune=10000 Your config file can have many options set, and it doesn’t matter what order they’re in, so it could also look like this if you hypothetically want to restrict your nodes mempool to 100 MB worth of transactions: maxmempool=100prune=10000debug=net For now just save the bitcoin.conf file with set to and pruned if you need it. Originally when I recorded this for the tutorial, I made some mistakes and set it to 1, but the steps are the same: debug net — — — — Open a terminal and enter the following: third **$** tail -f ~/.bitcoin/debug.log | grep "UpdateTip:" Again because it’s a tail, you’ll see nothing until you re-run or bitcoin-qt bitcoind. is a command that has a few functions, but in this context, it will take the output from the first command and filter it so it only shows lines that include the text within the quotes. is specific verbiage that only appears when a new block is added. The is commonly called a “pipe”, and all it really means is “take the output of the first command and send it through the second command”. You’ll hear people say terms like “pipe it to ” or “pipe it to ”, and this is what they mean. grep UpdateTip: | grep more In the other terminal enter the following: **$** tail -f ~/.bitcoin/debug.log | grep -v "UpdateTip:\|Requesting block\|sending getdata\|recieved block\|received: block" This is the same command but with the flag, and will do the opposite of the previous command and filter out any line with the text we specify. -v is included first, because we’re already pulling that specific information into a different window. What you’ll see next are the two symbols and what these do is tell the command “filter out x y z …” UpdateTip: **\|** grep and and and So now we’ve effectively split a single log file up into two outputs so we can more accurately watch what’s going on, and filter out some redundant info I’ve chosen so you have a slower scrolling output. This way you can keep direct track of the blocks coming in with the second tail command without it forcing the other information out of the way. Feel free to play around with what you want to include and exclude until you’re comfortable using the command. Now that you have two terminals with tail commands “waiting”, go ahead and run again, and this time let it run so it actually starts making sync progress: bitcoin-qt That’s it! Just let it sync. Depending on your hardware/bandwidth it could take anywhere from a handful of hours to multiple weeks (unlikely). When it’s finally synced, blocks will start coming in once every ~10 minutes on average and the the debug.log file will start showing a lot more activity, including transaction relaying information which doesn’t begin until after the IBD period. (Initial Block Download) Part 0 — For those here who just need the commands: sudo apt-get update;sudo apt-get install git; git clone ;sudo apt-get install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils python3;sudo apt-get install libboost-all-dev;wget ;echo '12edc0df75bf9abd7f82f821795bcee50f42cb2e5f76a6a281b85732798364ef db-4.8.30.NC.tar.gz' | sha256sum -c;tar -xvf db-4.8.30.NC.tar.gz;cd db-4.8.30.NC/build_unix;mkdir -p build;BDB_PREFIX=$(pwd)/build;../dist/configure --disable-shared --enable-cxx --with-pic --prefix=$BDB_PREFIX;sudo make install;cd ../..;sudo apt-get install libminiupnpc-dev;sudo apt-get install libzmq3-dev;sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler;sudo apt-get install libqrencode-dev;cd bitcoin; ./autogen.sh;./configure CPPFLAGS="-I${BDB_PREFIX}/include/ -O2" LDFLAGS="-L${BDB_PREFIX}/lib/" --with-gui;make;sudo make install; mkdir -p bitcoin-source && cd bitcoin-source https://github.com/bitcoin/bitcoin.git http://download.oracle.com/berkeley-db/db-4.8.30.NC.tar.gz git checkout tags/v0.16.3; bitcoin-qt UPDATE: Upgrading from 0.16.0 to 0.16.3 If you installed Bitcoin via this tutorial, the following will explain how to go about upgrading to 0.16.3. If you’re looking to install 0.16.3 from scratch, follow the tutorial above from the beginning and don’t worry about these steps, which will be as follows: Make sure Bitcoin Core is no longer running Renaming the installation folder Downloading and installing the new client There are some specific details you will need to pay attention too, but otherwise it will be pretty straightforward. First… /home/[user]/.bitcoin Do Not Delete: Let’s make this clear in case you’re reviewing this and need a refresher. There are two directories: — Which is the hidden folder in your home directory that and configuration files, along with other data that you want to . /home/[user]/.bitcoin (the period before the b) holds your wallet keep — Which is the normal folder where 0.16.0 is installed. so we can install 0.16.3 in its place. /home/[user]/bitcoin-source/bitcoin This is the one we want to rename You can either do this in the file manager: Or you can run the following commands in the shell, which I recommend doing anyway because we then need redownload the Bitcoin binaries. , this will be done automatically with the clone command: Do not make a new folder named “bitcoin” cd ~/bitcoin-source mv bitcoin bitcoin-old-16.0 $ $ **$** git clone [https://github.com/bitcoin/bitcoin.git](https://github.com/bitcoin/bitcoin.git) Next we’re going to recreate a prefix that we set up in the original tutorial. This doesn’t to be done this way, but for simplicity sake we’re going to. Please note that this prefix is only temporary, if you close out the shell after this, you will have to follow this step again: (directory shortcut) have cd ~/bitcoin-source/db-4.8.30.NC/build_unix BDB_PREFIX=$(pwd)/build $ $ Now we’re going to proceed like normal from the beginning of Part III: $ cd ~/bitcoin-source/bitcoin$ git checkout tags/v0.16.3$ ./autogen.sh$ ./configure CPPFLAGS="-I${BDB_PREFIX}/include/ -O2" LDFLAGS="-L${BDB_PREFIX}/lib/" --with-gui make sudo make install $ $ That should be all you need to do. If you have any questions just reach out to me on Twitter or Reddit. _The latest Tweets from 🅂🅃🄾🄿 (@StopAndDecrypt). Fullstack Social Engineer: 10% FUD, 20% memes, 15% concentrated…_twitter.com 🅂🅃🄾🄿 (@StopAndDecrypt) | Twitter