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