# 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 Etherea&#x6C;**-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 Etherea&#x6C;**-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 Etherea&#x6C;**-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
