Installing Ternoa

We have made an installer script automates the installation process of the Ternoa Node software on Debian/Ubuntu-based systems. It downloads the Ternoa Node binary, creates a systemd service, and sets up necessary configurations.


  • Debian/Ubuntu-based Linux distribution

  • Internet connection to download the Ternoa Node binary

  • Sudo privileges


  1. Download the installer script:

    curl -sSL -o && chmod +x && sudo ./
  2. Make the script executable:

    chmod +x
  3. Run the script with sudo privileges:

    sudo ./
  4. Follow the on-screen prompts to provide necessary inputs like Node Name, Chain Name, Validator option, etc.

  5. Once the installation is complete, the Ternoa Node service will be started automatically.


  • Verion: Required. Ternoa Binary version default is v1.3.2.

  • Node Name: Required. Name of the Ternoa Node.

  • Chain Name: Choose from alphanet, mainnet, or betanet. Default is mainnet.

  • Archive Mode: Choose true or false. Default is true.

  • Enable Prometheus: Choose true or false. Default is false.

  • Prometheus Port: Optional. Port for Prometheus metrics. Default is 9615.

  • Validator: Choose true or false. Default is false.

How it Works

  1. The installer script detects the operating system (Debian or Ubuntu) and sets up necessary dependencies.

  2. It prompts the user for required inputs such as Node Name, Chain Name, and other configurations.

  3. The script downloads the Ternoa Node binary from the official repository.

  4. It creates a systemd service for the Ternoa Node, ensuring it starts automatically on system boot.

  5. Additional configurations like Prometheus metrics, archive mode, and validator option are applied based on user inputs.

  6. Once the installation is complete, the Ternoa Node service is started automatically.

  7. Logs of the Ternoa Node service are displayed for 10 seconds to verify successful installation.


Once Ternoa is installed, let’s check to make sure that it’s working correctly:

ternoa --version

You can also restart the Ternoa service using.

systemctl restart ternoa 

or if you would like to stop it, you should run :

systemctl stop ternoa

to troubleshoot, and check the logs in real-time, you can run the following command:

journalctl -f -u ternoa.service

For more detailed instructions, view our workshop on setting up a validator node here.

Last updated