Install DAppNode

Think of DAppNode as an operating system. In fact, it is; our savvy team has taken an Ubuntu distribution and super-powered it to be your gateway to access the decentralized web.

While you can run DAppNode on a Virtual Private Server (VPS), we highly encourage you to run DAppNode on your own physical server. The intention of DAppNode is to create a strong network of decentralized servers. Running DAppNode on centralized virtual servers defeats the purpose. 😉That being said, we realize it may be easiest to get started and test the system on a VPS.


⚠️ DAppNode is intended to use in a server. Do not install DAppNode on your laptop

⚠️ If you do so the installation will erase all its content. See details below


Minimum requirements

You will need a dedicated machine to install it.

Ethereum is big! To cope with that, you’ll need to have a powerful enough machine to keep up with Ethereum's rapidly splitting blocks.

That is why we recommend having at least 8gbs RAM and an SSD hard drive with at least 160 GBs (add capacity as you like, keep in mind that Ethereum is 130GBs at press time).

In the client side you just need an OpenVPN client installed in the device with which you want to connect to your DAppNode, see info on recommended clients and installation instructions below.

How to install DAppNode on your machine

Okay, so you’re ready to join the real DAppers. Let us show you how to make that hardware sing the hardware decentralization song!

How to install DAppNode from an ISO

Download the image from DAppNode-ubuntu-18.04-server-amd64_v0.1.18.iso or build it from source

Burn the ISO in a USB (~8 min)

Burn the ISO to an USB stick, please follow the official Ubuntu instructions for MacOS, Windows or Ubuntu.

Please note that these instructions are intended to generate the ISO image in a bootable USB from a Mac, Windows or Linux device, and then install it in a server. IF YOU EXECUTE THE BOOTABLE USB IN A MACHINE CONTAINING DATA IT WILL BE ERASED. DAppNode is intended to run 24/7 so if you install it in a laptop or desktop machine and you turn it off it will lose the sync

Install an Ubuntu distribution (~15 min)

Insert the USB into your Server and prepare to install an Ubuntu distribution. You will have to make sure that your Server boots from the USB. If you succeed at booting up from your USB, you will be greeted with this screen or a similar one:

Follow the Ubuntu installation steps; various screens will guide you through the process. You can follow this standard option for a default installation:

Note by following these instructions you will erase your Server's disk contents.

  1. Select a language - Language: [English]
  2. Select your location - Country, territory or area: [United States]
  3. Configure the keyboard - Detect keyboard layout? [Yes] Follow the instructions to detect your keyboard
  4. Configure the network - Hostname: [DAppNode]
  5. Set up users and passwords - Full name for the new user: [DAppNode]
  6. Set up users and passwords - Username for your account: [dappnode]
  7. Set up users and passwords Choose a password for the new user: [YOUR_PASSWORD]
  8. Set up users and passwords - Re-enter password to verify: [YOUR_PASSWORD]
  9. Set up users and passwords - Encrypt your home directory? [No]
  10. Configure the clock - Is this time zone correct? [Yes]
  11. Partition disk - Partitioning method: [Guided - use entire disk and set up LVM]
  12. Partition disk - Select disk to partition: [SCSI33 (0,0,0) (sda) - ...]
  13. Partition disk - Write the changes to disks and configure LVM? [Yes]
  14. Partition disk - Amount of volume group to use for guided partitioning: [Continue]
  15. Partition disk - Write the changes to disks? [Yes]
  16. Configure the package manager - HTTP proxy information (black for none): [Continue]
  17. Configuring tasksel - How do you want to manage upgrades on this system? [Install security updates automatically]
  18. Software selection - Choose software to install [OpenSSH server] Use the arrows to navigate to the option, and the spacebar to select it.
  19. Install the GRUB boot loader on a hard disk - Install the GRUB boot loader to the master boot record? [Yes]
  20. Finish the installation - Installation complete [continue]

If the installation succeeded, your system will reboot, you will have to log in with the user and password provided in the installation, and it should finish with this screen:

Installation via script

WARNING

This software is not meant to be run in a remote machine hosted by any remote provider. What DAppNode specifically wants to avoid is centralization of the machines that our digital lives rely on; nevertheless, we understand that before buying a dedicated machine to run your DAppNode you might want to test it and see how easy it is to use….

And… only for that reason will we look aside when someone installs a DAppNode in a virtual provider. We want it to be clear that kind of use is not the recommended use, but for testing purposes only.

Remember Your hardware, your coins, your privacy, your freedom.

Script installation guide

For this example, we'll be installing DAppNode on a Digital Ocean droplet, but the process should work for any other Ubuntu Server 18.04.

We strongly recommend using 8GB+ of RAM and a <= 200 Gbs SSD hard drive.

Install DAppNode and its dependencies

Install the prerequisites (docker and docker-compose) running this command in the terminal of the machine you want to install the DAppNode server, if using a Virtual Service Provider, you have first to connect you via SSH to that machine.

sudo wget -O - https://github.com/dappnode/DAppNode/releases/download/v0.1.18/dappnode_install_pre.sh | sudo bash

Install DAppNode

sudo wget -O - https://github.com/dappnode/DAppNode/releases/download/v0.1.18/dappnode_install.sh | sudo bash

If you have a static IP and want to set it up right from the connection, then run the command with the following variable including your static IP

sudo wget -O - https://github.com/dappnode/DAppNode/releases/download/v0.1.18/dappnode_install.sh | sudo STATIC_IP="your static IP" bash

When the installation is done and is successful, you will be given credentials to connect to your DAppNode.

Take into account that the chain will take some time to synchronize and you will not be able to perform most of the actions before that.

How to restore an installed DAppNode to the latest version:

If you are experiencing any problem or just want to make sure you are running the latest DAppNode versions, execute this command in the DAppNode terminal. This will update the core packages to the latest versions without erasing any data from your volumes.

sudo wget -O - https://github.com/dappnode/DAppNode/releases/download/v0.1.18/dappnode_install.sh | sudo UPDATE=true bash