Build Tezos from source for alphanet on Debian 9

This explains how to build a Tezos node from source on Debian 9 such that it runs on the alphanet. Building from source is more complicated than just running the docker image but it allows us to easily place the Tezos data in a filesystem that is tuned for the purpose and makes better use of the available disk space.

Build instructions also appear at This document just gives some specifics for Debian 9 and optimizes the file space as above.

(If you are not concerned about disk space, just ignore the steps below that refer to the “home” partition or “/dev/sdc”. Similarly, this uses Debian 9 as the base since that distro is fairly lightweight, easily available on, and has the necessary dependent packages for building tezos. Other distros will work but you may have issues getting the right version of libsodium / libsodium-dev.)

At [1], create a new 1024 Linode instance ($5/month).

  1. Deploy the Debian 9 image on it allocating 2000 MB.
  2. Create a new disk labeled as “home”, raw/unformatted, using all remaining available space.
  3. Assign that “home” disk to /dev/sdc in the configuration profile.
  4. Boot the linode.

Login to the server and update it.

$ ssh
$ apt-get update
$ apt-get upgrade -y

Create the filesystem that will hold the Tezos blockchain and other meta-data. This data comprises many small files so we override ext4 defaults to use small blocks, more inodes, and the minimal inode size.

$ mkfs.ext4 -b 1024 -i 1024 -I 128 /dev/sdc
$ mount /dev/sdc /home

Create the user [2] where we will finish the installation and run Tezos:

$ adduser tezos
$ adduser tezos sudo
$ su - tezos

Install the base packages needed:

$ sudo apt-get install -y patch unzip make gcc m4 git g++

Install the necessary OPAM (Ocaml) tools. (These steps can take five or so minutes apiece):

$ wget -O - | sh -s /usr/local/bin
$ opam switch "tezos" --alias-of 4.04.2
$ eval `opam config env`

Get tezos code:

$ git clone -b alphanet
$ cd tezos

Build (takes a long time; there are several user-prompts requiring responses early on; this will install some additional packages as needed such as leveldb[3]):

$ make build-deps
$ make

Note: The above two build steps fail as of 2017/12/06. See a workaround at GitHub issues.

See for the steps to run your alphanet node.

Here is one way to start the node service so that the RPC port (8732) is available remotely and CORS support is enabled:

$ ./tezos-node run --rpc-addr='*' --connections=16 --cors-header='content-type' --cors-origin='*'

I run it inside a screen session so that it hangs around after I log out.

Another option is to run it in the background this way (with no CORS support, arbitrarily):

$ nohup ./tezos-node run --rpc-addr='*' --connections=16 >node.log 2>&1 &

That runs tezos-node in the background (because of the final &), writes its output to a node.log file, and continues after you log out (because of the initial nohup command wrapper).


  1. Linode only because that’s the VPS host I know best. If you should happen to create an account at linode, my referral code is da62f5a3a544121428ed41f357c3056c1f51091a — I’d get $20 credit and you’d get my gratitude.

  2. It’s not strictly necessary to create a new user (tezos in the above) to build and run tezos — you can do it as the default root user — but it’s good security practice to do as little as possible as root.

  3. Version 1.18 of the leveldb libraries is required. Newer versions may compile but are prone to runtime errors when used with tezos. Building on Debian 9 currently gets the correct version; if you build on the latest Ubuntu you’ll have to force-install leveldb 1.18 somehow before running make build-deps.