ICONLOOP (loopchain) Publisher
  • ICONLOOP (loopchain) Publisher
  • Finance

Install latest/stable of loopchain

Ubuntu 16.04 or later?

Make sure snap support is enabled in your Desktop store.

Install using the command line

Don't have snapd? Get set up for snaps.

Channel Version Published


Quick Start Guide for Citizen Node

install https://docs.snapcraft.io/installing-snapd

  • ubuntu is pre-installed on 16.04.4 LTS (Xenial Xerus) or later.

     $ snap version
     snap    2.36.1
     snapd   2.36.1
     series  16
     ubuntu  18.04
     kernel  4.15.0-39-generic
  • centos https://docs.snapcraft.io/installing-snap-on-centos

     $ sudo yum install epel-release
     $ sudo yum install snapd
     $ sudo systemctl enable --now snapd.socket
     $ sudo ln -s /var/lib/snapd/snap /snap

    Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.

loopchain installation

  • install for the first time

    $ sudo snap install loopchain
    $ loopchain --help
  • upgrade to new revision

    $ sudo snap refresh loopchain

RabbitMQ Installation

  • ubuntu

    Install RabbitMQ

     $ sudo apt install rabbitmq-server -y

    Run RabbitMQ

     $ sudo service rabbitmq-server start
  • centos

    Install erlang

      $ wget https://github.com/rabbitmq/erlang-rpm/releases/download/v21.3.7/erlang-21.3.7-1.el7.x86_64.rpm
      $ sudo rpm -ivh erlang-21.3.7-1.el7.x86_64.rpm

    Install RabbitMQ

      $ sudo rpm --import https://www.rabbitmq.com/rabbitmq-release-signing-key.asc
      $ wget https://dl.bintray.com/rabbitmq/all/rabbitmq-server/3.7.7/rabbitmq-server-3.7.7-1.el7.noarch.rpm
      $ sudo yum install rabbitmq-server-3.7.7-1.el7.noarch.rpm -y

    Run RabbitMQ

      $ sudo systemctl enable rabbitmq-server
      $ sudo systemctl start rabbitmq-server

Mount exteral storage

When you want to store data in an external storage, you can use /media or /mnt.

  • First, you have to mount exteral storage to /media or /mnt using fstab or manually.
  • Second, create directory for store your data. For example /media/data. If you run with normal user, you must change owner and group of /media/data.

    $ sudo mkdir /media/data
    $ sudo chown userid.userid /media/data
  • Third, mount your storage data directory to your home data directory.

    $ sudo mount -obind /media/data $HOME/data
  • Finally copy configure files manually

    $ cp -a /snap/loopchain/[rev]/conf /snap/loopchain/[rev]/scripts/* $HOME/data
    • skip Copy default configure files section. And you have to run loopchian in $HOME/data

Copy default configure files

  • When loopchain is installed for the first time, loopchain.init should be executed.

    $ loopchain.init [TARGET_DIR]

    If not specified TARGET_DIR, default TARGET_DIR is $HOME/snap/loopchain/common

  • When upgrading to a new revision, make sure that $HOME/snap/loopchain/current points to upgraded revision. Otherwise, loopchain or loopchain.init command should be executed to update link.

    $ sudo snap refresh loopchain
    $ loopchain

Make key file with pass phrase.

$ cd $HOME/snap/loopchain/common
$ mkdir keys
$ openssl ecparam -genkey -name secp256k1 | openssl ec -aes-256-cbc -out ./keys/my_private.pem      # generate private key

Default loopchain configurations

  • sample configurations and documents

     installed loopchain location : /snap/loopchain/current/
     guides : /snap/loopchain/current/docs/
     configurations : /snap/loopchain/current/conf/
     scripts : /snap/loopchain/current/scripts/

Change configuration. (password for your key file)

  • In the conf/citizen_{testnet or mainnet}.json configuration file, change the following configuration value.


Run Citizen Node to Testnet ICON Network

$ ./run_citizen_testnet.sh

Run Citizen Node to Testnet ICON Network

$ ./run_citizen_mainnet.sh

Stop all

$ ./stop_all.sh

Clean up (delete log, delete db)

$ rm -rf log
$ rm -rf .storage*

Developer website


Details for loopchain

Last updated
1 April 2020

Share this snap

Generate an embeddable card to be shared on external websites.

Related blog posts

Where people are using loopchain

Users by distribution (log)

Ubuntu 18.04
Ubuntu 20.04
Ubuntu 16.04
Ubuntu 19.10
CentOS 7

Install loopchain on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the installing snapd documentation.

Is there a problem with loopchain? Report this app