docs(l1): move install instructions to new section and embed script one-liner (#3505)

**Motivation**

Since the install script just builds from source using a `cargo install`
one-liner, it's preferable to show that instead of having to download
and run an install script.

**Description**

This PR removes the install script, embedding the one-liner inside the
docs. It also moves the installation instructions to the book, linking
to it in the readme, and expands them with instructions on how to build
from source or download the pre-built binaries.

---------

Co-authored-by: Manuel Iñaki Bilbao <manuel.bilbao@lambdaclass.com>

Author: MegaRedHand

README.md

@@ -8,30 +8,9 @@ Minimalist, stable, modular and fast implementation of the Ethereum protocol in
 [tg-badge]: https://img.shields.io/endpoint?url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Fethrex_client%2F&logo=telegram&label=chat&color=neon
 [tg-url]: https://t.me/ethrex_client
 
-## Quick-start
+## Getting started
 
-To install the client, [first install Rust](https://www.rust-lang.org/tools/install) and run:
-
-```sh
-curl -sSL https://raw.githubusercontent.com/lambdaclass/ethrex/refs/heads/main/install.sh | sh
-```
-
-This installs the `ethrex` binary.
-
-### Starting the L1
-
-After running the install script, you can start the L1 by running:
-
-```sh
-ethrex --dev
-```
-
-> [!TIP]
-> In case you want to start a new L1, you can remove the data of the old one by executing:
->
-> ```sh
-> ethrex removedb
-> ```
+For instructions on how to get started using ethrex L1 and/or L2, please refer to the ["Getting started" section of the docs](https://docs.ethrex.xyz/getting-started/index.html).
 
 ## L1 and L2 support
 

docs/SUMMARY.md

@@ -1,9 +1,8 @@
 # Summary
 
 - [Getting started](./getting-started/README.md)
-  - [Installing ethrex]()
-    - [Build from source]()
-  - [Running a node]()
+  - [Installing ethrex](./getting-started/installing.md)
+  - [Running a node](./getting-started/running.md)
   - [Migrating from another client]()
 
 - [Roadmap](./getting-started/roadmap.md)

docs/getting-started/README.md

@@ -1,11 +1,15 @@
 # Getting started
 
-## L1 and L2 support
-
-This client supports running in two different modes:
+Ethrex is a minimalist, stable, modular and fast implementation of the Ethereum protocol in [Rust](https://www.rust-lang.org/).
+The client supports running in two different modes:
 
 - As a regular Ethereum execution client
 - As a multi-prover ZK-Rollup (supporting SP1, RISC Zero and TEEs), where block execution is proven and the proof sent to an L1 network for verification, thus inheriting the L1's security. Support for based sequencing is currently in the works.
 
 We call the first one "ethrex L1" and the second one "ethrex L2".
 You can find more information on our [L1](../l1) or [L2](../l2) docs, respectively.
+
+## Where to start
+
+To get started with ethrex, you can follow the [installation guide](./installing.md) to set up the client on your machine.
+Then, a good next step would be to [run a local node](./running.md) and see ethrex in action.

docs/getting-started/installing.md

@@ -0,0 +1,112 @@
+# Installing ethrex
+
+Before [running the ethrex client](./running.md), you need to install it.
+We have multiple ways to install, depending on your needs.
+
+Pre-built binaries for Linux and macOS are available for each release.
+See [Installing from pre-built binaries](#installing-from-pre-built-binaries) for installation instructions.
+
+You can also [install through cargo install](#installing-through-cargo-install), or [build the client from source](#building-from-source).
+
+## Installing from pre-built binaries
+
+To install ethrex from pre-built binaries, first download the binaries for your platform from the [release page](https://github.com/lambdaclass/ethrex/releases).
+You can also download it from the command line using `curl` or `wget`:
+
+```sh
+# For Linux x86_64
+curl -L https://github.com/lambdaclass/ethrex/releases/latest/download/ethrex-linux_x86_64 -o ethrex
+wget https://github.com/lambdaclass/ethrex/releases/latest/download/ethrex-linux_x86_64 -O ethrex
+
+# For Linux ARM
+curl -L https://github.com/lambdaclass/ethrex/releases/latest/download/ethrex-linux_aarch64 -o ethrex
+wget https://github.com/lambdaclass/ethrex/releases/latest/download/ethrex-linux_aarch64 -O ethrex
+
+# For MacOS
+curl -L https://github.com/lambdaclass/ethrex/releases/latest/download/ethrex-macos_aarch64 -o ethrex
+wget https://github.com/lambdaclass/ethrex/releases/latest/download/ethrex-macos_aarch64 -O ethrex
+```
+
+And set the execution bit:
+
+```sh
+chmod +x ethrex
+```
+
+After that, you can verify the program is working by running:
+
+```sh
+./ethrex --version
+```
+
+This should output something like:
+
+```text
+ethrex ethrex/v0.1.0-HEAD-23191af/aarch64-apple-darwin/rustc-v1.87.0
+```
+
+> [!TIP]
+> For convenience, you can move the `ethrex` binary to a directory in your `PATH`, so you can run it from anywhere.
+
+After installing the client, see ["Running the client"](./running.md) for instructions on how to use it to run L1 and/or L2 networks.
+
+## Installing through `cargo install`
+
+To install the client, [first install Rust](https://www.rust-lang.org/tools/install) and then run:
+
+```sh
+cargo install --locked ethrex \
+    --git https://github.com/lambdaclass/ethrex.git \
+    --tag v0.0.2-rc.1 \
+    --features dev
+```
+
+This installs the `ethrex` binary.
+For more information on how it is built and installed, see [the cargo-install documentation](https://doc.rust-lang.org/cargo/commands/cargo-install.html).
+
+After that, you can verify the program is working by running:
+
+```sh
+ethrex --version
+```
+
+This should output something like:
+
+```text
+ethrex ethrex/v0.1.0-HEAD-23191af/aarch64-apple-darwin/rustc-v1.87.0
+```
+
+After installing the client, see ["Running the client"](./running.md) for instructions on how to use it to run L1 and/or L2 networks.
+
+## Building from source
+
+This section assumes you already have [Rust's `cargo`](https://www.rust-lang.org/tools/install) and [`git`](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) installed.
+
+You can download the source code of a release from the [GitHub releases page](https://github.com/lambdaclass/ethrex/releases), or by cloning the repository at that version:
+
+```sh
+git clone --branch <LATEST_VERSION_HERE> --depth 1 https://github.com/lambdaclass/ethrex.git
+```
+
+After that, you can run the following command inside the cloned repo to build the client:
+
+```sh
+cargo build --bin ethrex --release --features dev
+```
+
+You can find the built binary inside `target/release` directory:
+
+```sh
+./target/release/ethrex --version
+```
+
+This should output something like:
+
+```text
+ethrex ethrex/v0.1.0-HEAD-23191af/aarch64-apple-darwin/rustc-v1.87.0
+```
+
+> [!TIP]
+> For convenience, you can move the `ethrex` binary to a directory in your `PATH`, so you can run it from anywhere.
+
+After installing the client, see ["Running the client"](./running.md) for instructions on how to use it to run L1 and/or L2 networks.

docs/getting-started/running.md

@@ -0,0 +1,21 @@
+# Running a node
+
+This guide will help you start a local L1+L2 stack using ethrex.
+It is assumed that you have already [installed ethrex](./installing.md).
+
+Running `ethrex --help` will display the help message.
+
+## Running an L1 dev environment
+
+After [installing ethrex](./installing.md), you can start a local L1 by running:
+
+```sh
+ethrex --dev
+```
+
+> [!TIP]
+> In case you want to start a new L1, you can remove the data of the old one by executing:
+>
+> ```sh
+> ethrex removedb
+> ```