Ethereal Chain Documentation
  • Introduction
  • Industry use cases
    • Decentralized applications
    • NFT Marketplaces
    • Decentralized finance
  • Wallets
    • Ethereal Wallet Guide
    • App Wallets
      • Ethereal Wallets
  • Web Wallets
    • Web Wallets
  • Command-Line Wallets
    • Command-Line Wallets
    • Paper Wallet
    • File System Wallet
  • Support/ Troubleshooting
  • Staking
    • Staking on Ethereal
    • Stake Account Structure
  • Grants
    • Ethereal's $100 Thousand Grants Program
    • Ethereal's Grants Process
  • Command Line
    • Command-line Guide
    • Install the Ethereal Tool Suite
    • Using Ethereal CLI
    • Connecting to a Cluster
    • Send and Receive Tokens
    • Offline Transaction Signing
    • Durable Transaction Nonces
  • Developing on native Ethereal
    • Programming Model
      • Overview
      • Transactions
      • Accounts
      • Runtime
      • Calling Between Programs
  • Clients
    • JSON RPC API
    • JavaScript API
  • Runtime Facilities
    • Native Programs
    • Sysvar Cluster Data
  • On-chain Programs
    • Overview
    • Developing with Rust
    • Developing with C
    • Deploying
    • Debugging
  • Ethereal Test Validator
  • EVM Integration
    • EVM in Ethereal
    • Legacy Address convention
    • EVM Bridge
  • Integrating
    • Add Ethereal to Your Exchange
  • Validating
    • Running a Validator
    • Validator Requirements
    • Starting a Validator
    • Vote Account Management
    • Staking
    • Monitoring a Validator
    • Publishing Validator Info
  • Clusters
    • Ethereal Clusters
    • Benchmark a Cluster
    • Performance Metrics
  • Architecture
    • Cluster
      • Ethereal Cluster
      • Synchronization
      • Leader Rotation
      • Fork Generation
    • Validator
      • Anatomy of a Validator
      • Blockstore
      • Gossip Service
  • Software
    • Vision Documentation
    • Quick Start
    • Specifications
    • Technical Perspective
  • Tutorials
    • Solidity Tutorials
      • Deploy a NFT (ERC-721) Tutorial
      • Deploy a Smart Contract
      • Deploy a ERC-20 Token
      • How To Build an NFT Marketplace
  • Set up MetaMask (Mainnet)
  • Set up MetaMask (Testnet)
Powered by GitBook
On this page
  • Install the Ethereal Tool Suite
  • Use Ethereal Install Tool
  • Download Prebuilt Binaries
  • Build From Source
  1. Command Line

Install the Ethereal Tool Suite

Install the Ethereal Tool Suite

There are multiple ways to install the Ethereal tools on your computer depending on your preferred workflow:

  • Use Ethereal Install Tool

    • MacOS & Linux

    • Windows

  • Download Prebuilt Binaries

    • Linux

    • MacOS

    • Windows

  • Build From Source

Use Ethereal Install Tool

MacOS & Linux

· Open your favorite Terminal application

· Install the Ethereal release LATEST_Ethereal_RELEASE on your machine by running:

curl -sSf https://raw.githubusercontent.com/Ethereal/Ethereal-chain/develop/install/Ethereal-install-init.sh | sh -s - Ethereal

· If you are connecting to a different testnet, you can replace Etherealwith the release tag matching the software version of your desired testnet, or replace it with the named channel stable, beta, or edge.

· The following output indicates a successful update:

looking for latest release

downloading Etherealinstaller

Configuration: /home/Ethereal/.config/Ethereal/install/config.yml

Active release directory: /home/Ethereal/.local/share/Ethereal/install/active_release

* Release version: Ethereal

* Release URL: https://github.com/Ethereal/Ethereal-chain/releases/download/Ethereal/Ethereal-release-x86_64-unknown-linux-gnu.tar.bz2

Update successful

  • Depending on your system, the end of the installer messaging may prompt you to

Please update your PATH environment variable to include the Ethereal programs:

  • If you get the above message, copy and paste the recommended command below it to update PATH

export PATH="/root/.local/share/Ethereal/install/active_release/bin:$PATH" to bashrc

  • Confirm you have the desired version of Ethereal installed by running:

Ethereal--version

  • After a successful install, Ethereal-install update may be used to easily update the Ethereal software to a newer version at any time.


Windows

· Open a Command Prompt (cmd.exe) as an Administrator

    • Search for Command Prompt in the Windows search bar. When the Command Prompt app appears, right-click and select “Open as Administrator”. If you are prompted by a pop-up window asking “Do you want to allow this app to make changes to your device?”, click Yes.

· Copy and paste the following command, then press Enter to download the Ethereal installer into a temporary directory:

curl -L https://github.com/Ethereal/Ethereal-chain/releases/download/v0.5.1/Ethereal-install-init-x86_64-pc-windows-msvc.exe --output C:\Ethereal-install-tmp\Ethereal-install-init.exe --create-dirs

  • Copy and paste the following command, then press Enter to install the latest stable version of Ethereal. If you see a security pop-up by your system, please select to allow the program to run.

C:\Ethereal-install-tmp\Ethereal-install-init.exe stable

· When the installer is finished, press Enter.

· Close the command prompt window and re-open a new command prompt window as a normal user

    • Search for "Command Prompt" in the search bar, then left click on the Command Prompt app icon, no need to run as Administrator)

· Confirm you have the desired version of Ethereal installed by entering:

Ethereal--version

  • After a successful install, Ethereal-install update may be used to easily update the Ethereal software to a newer version at any time.

Download Prebuilt Binaries

If you would rather not use Ethereal-install to manage the install, you can manually download and install the binaries.

Linux

Download the binaries by navigating to https://github.com/Ethereal/Ethereal-chain/releases/latest, download Ethereal-release-x86_64-unknown-linux-msvc.tar.bz2, then extract the archive:

tar jxf Ethereal-release-x86_64-unknown-linux-gnu.tar.bz2

cd Ethereal-release/

export PATH=$PWD/bin:$PATH

MacOS

Download the binaries by navigating to https://github.com/Ethereal/Ethereal-chain/releases/latest, download Ethereal-release-x86_64-apple-darwin.tar.bz2, then extract the archive:

tar jxf Ethereal-release-x86_64-apple-darwin.tar.bz2

cd Ethereal-release/

export PATH=$PWD/bin:$PATH

Windows

· Download the binaries by navigating to https://github.com/Ethereal/Ethereal-chain/releases/latest, download Ethereal-release-x86_64-pc-windows-msvc.tar.bz2, then extract the archive using WinZip or similar.

· Open a Command Prompt and navigate to the directory into which you extracted the binaries and run:

cd Ethereal-release/

set PATH=%cd%/bin;%PATH%

Build From Source

If you are unable to use the prebuilt binaries or prefer to build it yourself from source, navigate to https://github.com/Ethereal/Ethereal-chain/releases/latest, and download the Source Code archive. Extract the code and build the binaries with:

./scripts/cargo-install-all.sh .

export PATH=$PWD/bin:$PATH

PreviousCommand-line GuideNextUsing Ethereal CLI

Last updated 1 year ago