Skip to content

TUTORIAL: Run an æternity Node on Ubuntu 18.04

1. Install libssl and libsodium

1.1. Install libssl by runningsudo apt-get install libssl1.0.0 inside the terminal 1.2. Install libsodium using sudo apt-get install libsodium23

For further information visit our documentation:

2. Download and unpack the latest æternity Ubuntu Release:

2.1. Download: latest Ubuntu release under 2.2. Make a new directory and enter it. In your terminal type: mkdir node then cd node 2.3. Unpack epoch release inside directory. In your terminal type: tar xf ~/Downloads/epoch-1.0.1-ubuntu-x86_64.tar.gz

3. Configure the node

3.1. Inside your node directory create anaeternity.yaml file 3.2. Go to or and create an AE keypair 3.3. Copy paste the below provided code to epoch.yaml

    port: 3015

    dir: keys
    peer_password: "secret"

        port: 3013
        port: 3113

        port: 3014

    beneficiary: "beneficiary_pubkey_to_be_replaced"
    autostart: false

    persist: true
    db_path: ./my_db

    network_id: ae_mainnet

3.4. Replace peer_password: “secret” with your own password. 3.5. Replace beneficiary: “beneficiary_pubkey_to_be_replaced” with your AE public key. 3.6. Check if your aeternity.yaml configuration is OK. In your terminal type: ./bin/aeternity check_config aeternity.yaml You should get an “OK” back, if not go through your config and check for mistakes.

4. Make sure your node is connectable

5. Run the node

4.1. Start the node inside your node directory using ./bin/aeternity start inside the terminal. 4.2. Inspect the current top of the blockchain as seen by the roma network. In your terminal type: curl 4.3. Inspect the current top of the blockchain as seen by your node. In your terminal type: curl


General note If you are stuck, post your question in the Forum, look into the documentation on or check the logs inside the logs folder in your node directory.