> For the complete documentation index, see [llms.txt](https://docs.obol.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.obol.org/version-v1.9/obol-stack/quickstart.md).

# Quickstart

This guide walks you through installing the Obol Stack, setting up an AI agent, and optionally deploying a blockchain network.

## Prerequisites

* Docker installed and running on your machine.
* macOS or Linux operating system.
* At least 8 GB of RAM available.

{% hint style="info" %}
Ensure Docker is running before proceeding. You can verify this by running `docker info` in your terminal.
{% endhint %}

## Step 1: Install Obol Stack

Run the bootstrap installer:

```shell
bash <(curl -s https://stack.obol.org)
```

The installer will:

1. Validate that Docker is running.
2. Install the `obol` CLI binary and dependencies (kubectl, helm, k3d, helmfile, k9s).
3. Configure your PATH and add `obol.stack` to `/etc/hosts`.
4. Offer to start the cluster immediately.

{% tabs %}
{% tab title="Default installation" %}

```shell
bash <(curl -s https://stack.obol.org)
```

Files are installed to:

* Config: `~/.config/obol/`
* Data: `~/.local/share/obol/`
* Binaries: `~/.local/bin/`
  {% endtab %}

{% tab title="Specific version" %}

```shell
OBOL_RELEASE=v0.1.0 bash <(curl -s https://stack.obol.org)
```

{% endtab %}

{% tab title="Development mode" %}

```shell
git clone https://github.com/ObolNetwork/obol-stack.git
cd obol-stack
OBOL_DEVELOPMENT=true ./obolup.sh
```

Development mode uses a local `.workspace/` directory and runs `go run` instead of a compiled binary.
{% endtab %}
{% endtabs %}

## Step 2: Start the stack

```shell
obol stack init
obol stack up
```

{% hint style="info" %}
The first startup may take a few minutes as Docker pulls the required images.
{% endhint %}

## Step 3: Set up the AI agent

Initialize an OpenClaw agent instance:

```shell
obol agent init
```

This walks you through choosing a model provider:

* **Ollama** (local, free) - if Ollama is detected on your machine
* **Anthropic** or **OpenAI** - routed through the in-cluster llmspy gateway

Once complete, open the agent dashboard:

```shell
obol openclaw dashboard
```

Each agent is automatically provisioned with an Ethereum signing wallet (via the remote-signer service). The wallet address is displayed during setup.

{% hint style="success" %}
You can reconfigure the model provider at any time with `obol openclaw setup`.
{% endhint %}

## Step 4: Deploy a blockchain network (optional)

Install an Ethereum node on the Hoodi testnet:

```shell
obol network install ethereum --network=hoodi
```

Deploy it to the cluster (replace with your deployment ID):

```shell
obol network sync ethereum/<your-id>
```

{% hint style="warning" %}
Replace the ID with the actual deployment ID shown in your terminal output (e.g., `knowing-wahoo`).
{% endhint %}

Check the deployment:

```shell
obol kubectl get pods -n ethereum-<your-id>
```

## Step 5: Explore

```shell
# Interactive cluster UI
obol k9s

# View all pods
obol kubectl get pods -A

# Check tunnel status (public URL)
obol tunnel status

# Configure model provider globally
obol model setup
```

## Stopping and cleaning up

```shell
# Stop the cluster (preserves data)
obol stack down

# Restart
obol stack up

# Remove everything including data
obol stack purge -f
```

{% hint style="warning" %}
`obol stack purge -f` is irreversible. It removes all cluster data and configuration.
{% endhint %}

## Next steps

* [Installing networks](/version-v1.9/obol-stack/installing-networks.md) - Deploy different blockchain networks.
* [Installing apps](/version-v1.9/obol-stack/installing-apps.md) - Deploy additional applications.
* [FAQ](/version-v1.9/obol-stack/faq.md) - Common questions and troubleshooting.


---

# 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://docs.obol.org/version-v1.9/obol-stack/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.