Getting Started Quickly

You can skip most of the information in this tutorial should you wish to do so and go straight ahead to install the full node.

If you haven’t already, just make sure your server matches the The Requirements.

Note

Your server’s installation of Ubuntu or CentOS must be a clean one, i.e. no pre-installed cpanel, whcms, plesk and so on.

Run the Installer!

For CentOS users: you may need to install curl. You can do that by running: sudo yum install curl -y.

This command will pull the installer script and kick off the installation:

bash <(curl -s https://raw.githubusercontent.com/nuriel77/iri-playbook/master/fullnode_install.sh)

Note

If during the installation you are requested to reboot the node, just do so and re-run the commands above once the node is back.

  • A successful installation will display some information when it is done, e.g. the URLs where you can access the graphs and IOTA Peer Manager.

By default you can access the graphs at:

http://your-ip:5555/dashboard/db/iota?refresh=30s&orgId=1

and Peer Manager via:

http://your-ip:8811
  • You can use the user iotapm and the password you’ve configured during the installation.
  • You should be redirected to a HTTPS URL (this has been added recently). This is a self-signed certificate: you will get a warning from the browser. You can add the certificate as an exception and proceed. In the ‘appendix’ chapter there’s some information how to install valid certificates (certbot).
  • Please consider hardening the security of your node. Any server is a target for attacks/brute forcing. Even more so if you are going to list your node publicly. See Security Hardening.
  • You can proceed to the Post Installation for additional information on managing your node.
  • To configure an email for alerts see Sending Alert Notifications.

Note

Checkout the new addition to the playbook: a handy tool to help manage the full node’s services:

iric01

DONATIONS

Making this installer happen, supporting and maintaing it takes much effort and time. Nevertheless, it is done happily in order to contribute and help the community.

If you want to leave a donation you can use this address:

CSSFHHDBUQDGAUGYUHTENLBJ9JMTUFFLYLJZKTLRZVLLDCZZOQHOUXJOVDKXOLXGCJEMXJOULDIKADBHWMGVALMAUW

And star the repository: iri-playbook

Thanks!

Connection Lost

If you lost connection to your server during the installation, don’t worry. It is running in the background because we are running it inside a “screen” session .

You can always “reattach” back that session when you re-connect to your server:

screen -r -d iota

Note

Pressing arrow up on the keyboard will scroll up the command history you’ve been running. This saves some typing when you need to run the same command again!

Warning

Some VPS providers might be depending on Network Block Devices (for example Scaleway). If using Ubuntu, you need to configure ufw prior to running the installer. See: https://gist.github.com/georgkreimer/7a02af49604da91c5e3605b08b2872ec

Accessing Peer Manager

You can access the peer manager using the user ‘iotapm’ and the password you’ve configured during installation:

http://your-ip:8811

Accessing Monitoring Graphs

You can access the Grafana IOTA graphs using ‘iotapm’ and the password you’ve configured during the installaton

http://your-ip:5555

Big thanks to Chris Holliday’s amazing tool for node monitoring