> For the complete documentation index, see [llms.txt](https://doc.tryethernal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.tryethernal.com/getting-started/quickstart.md).

# Quickstart

To signup, just head to <https://app.tryethernal.com>. You will just need an email address.

On your first login, you will be asked to create a workspace.\
Workspaces consist of a name & a server address.

Each workspace has its own dashboard, with its own data. It's useful if you are working with different chains.

The dashboard will be accessible even if your server is not running. However, it needs to be at the time of the workspace creation.

Once the connection to the server has been established you'll be asked to install the CLI. To do so, just run the following command:

```bash
npm install ethernal -g
```

Then, log in with your credentials and start listening to transactions:

```bash
ethernal login
```

```bash
ethernal listen
```

You can also skip the login command and use env variables:

```bash
ETHERNAL_EMAIL=your@email.com ETHERNAL_PASSWORD=yourpwd ethernal listen
```

To complete your onboarding, you will need to generate one transaction. You can run a migration for example.

After that, go back to your dashboard, and should see a confirmation that the transaction has been received. Your dashboard is now ready!

As a next step, we recommend that you set up data synchronization for contracts.

{% content-ref url="/pages/-MU0XHUqKpa8aio9dVR9" %}
[Hardhat Project Setup](/getting-started/hardhat-project-setup.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MU0XS8YM1GEGUJ1WKrH" %}
[Truffle Project Setup](/getting-started/truffle-project-setup.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://doc.tryethernal.com/getting-started/quickstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.