Skip to main content

ISO Installation

When you want to perform a clean installation by installing the base operating system and DAppNode. Installing from an ISO will wipe the machine data and install Debian + DAppNode.

Get the ISO#

You can get the image downloading directly from DAppNodeISO or if you prefer you can build it from the source.

Burn the ISO in a USB#

Burn the ISO to an USB stick. To do so we recommend using Etcher for the OS with which you will prepare the USB to boot from your server and install DAppNode

⚠️ Please note that Etcher is intended to generate the ISO image in a bootable USB from your desktop device, and then install it in a server

IF YOU EXECUTE THE BOOTABLE USB IN A MACHINE CONTAINING DATA, ALL EXISTING DATA WILL BE ERASED.

Also, DAppNode is intended to run 24/7 so if you install it on a laptop or desktop machine and you turn it off, it will not stay synced.

Boot from ISO#

Insert the USB into your Server and prepare to install a Debian 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:

Select a language.

Select a location.

Select a keyboard configuration.

Type a hostname. This is the name your machine will have on the network. It's not important.

Define a password for the user root.

⚠️ Write down this password, you will need it in case you need to access as root to the command line interface (cli) of DAppNode.

Select a username for your DAppNode and set a password.

⚠️ Write down this DAppNode username and password.

Set up your time zone.

Partition disk configuration. On this guide we will use the second option Partitioning method: [Guided - use entire disk and set up LVM].

After choosing the disk, we need to define the partioning scheme. We will select All files in one partition (recommended for new users).

Confirm we will write the disk.

We want to use all the disk ont he partioning process. So we dont modificate the value.

Confirm we want to write the changes to disks.

The next decision depends on you. We recommend you choose 'Yes' because you don't have to confirm all the operations.

Install the grub.

Select the disk.

If you have an IP you should define here. Otherwise, leave the field blank.

You will see this message indicating you have finished this installation.

The machine will restart and you will see this screen.

Log in into the machine with the DAppNode username and password you chose earlier.

Post-Installation#

Once the installation process has finished, DAppNode will try to automatically prepare the first access to your DAppNode on the next order:

  1. Local Proxy
  2. Wifi
  3. Wireguard
  4. OpenVPN