# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ethereals-blockchain.gitbook.io/ethereal-chain-documentation/command-line/install-the-ethereal-tool-suite.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
