DAppNode Installation Guide

Eduardo Antuña Díez edited this page Jan 16, 2019 · 64 revisions

DAppNode is an infrastructure to run dapps

  1. How to install DAppNode from an ISO (clean installation)
  2. How to install DAppNode on your Ubuntu Server 18.04
  3. How to restore an installed DAppNode to the latest version

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 severs. 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.


:warning: Do not install DAppNode on your laptop


1. How to install DAppNode from an ISO:

1.1. Download the image

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

1.2. Burn the ISO in a USB (~8 min)

Burn the ISO in a 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.

1.3. 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. I you succeed at booting up from your usb, you will be greeted with this screen or a similar one:

DAppNode installation welcome screen

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

Suggested options for Ubuntu server installation

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

DAppNode installation ending screen

1.4. Connect to your DAppNode's VPN.

To connect use the credentials or navigate to the link shown in the screen. Following this link you will get the instructions to configure your VPN on several platforms

How To Connect Your Device To DAppNode

1.5. Enter your DAppNode!

Navigate to my.admin.dnp.dappnode.eth to access DAppNode's administrative page. Bare in mind that DAppNode's functionality will be limited until the Ethereum mainnet chain is synced (should take around 2~3 hours to get and snapshot)


2. How to install DAppNode on your Ubuntu Server 18.04:

For this example we'll be installing DAppNode on a Digital Ocean droplet, but the process should work in any other Ubuntu Server 18.04. We strongly recommend use 8GB+ and a 160Gb+ SSD hard drive.

2.1. Install DAppNode and its dependencies

Install the prerequisites (docker and docker-compose): (If you already have docker and docker compose in your server or you want to install it by any other mean , you can skip this step

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

Install DAppNode

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

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

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

When the installation is done and succeeded, 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 do most of the actions before that.

Following this link you will get the instructions to configure your VPN on several platforms How To Connect Your Device To DAppNode

2.2. Enter your DAppNode!

Navigate to my.admin.dnp.dappnode.eth to access DAppNode's administrative page. Bare in mind that DAppNode's functionality will be limited until the Ethereum mainnet chain is synced (should take around 2~3 hours to get and snapshot)

2.3. Now you can do things like for example:

The first time you access to it will ask you for your “Custom API address”, just fill the field with this address and you will be connected to your IPFS node, this is the input you have to enter in the field "Is your API in aa port other than 5001?

/ip4/172.33.1.5/tcp/5001

You can download the Hardware decentralization user guide here


3. How to restore an installed DAppNode to the latest version:

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.13/dappnode_install.sh | sudo UPDATE=true bash

Even if it's just a message to confirm that everything is running successfully, we need your feedback to provide the best decentralized server network infrastructure possible. Please message us with questions, suggestions, or just to confirm you got your DAppNode set up:

You can’t perform that action at this time.
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.
Press h to open a hovercard with more details.