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