---
title: Installation
description: Install and run the Agent Receipts Dashboard.
---

## Homebrew (macOS, Linux)

```sh
brew install agent-receipts/tap/dashboard
```

## Prebuilt binaries

Binaries for darwin/linux (amd64, arm64) are attached to each [GitHub release](https://github.com/agent-receipts/dashboard/releases).

## Install with Go

```sh
go install github.com/agent-receipts/dashboard/cmd/dashboard@latest
```

## Build from source

```sh
git clone https://github.com/agent-receipts/dashboard.git
cd dashboard
make build
```

## Usage

If you use the standard per-user path (`~/.local/share/agent-receipts/receipts.db`), no flags are needed:

```sh
dashboard
```

Then open [http://localhost:8080](http://localhost:8080) in your browser.

### Options

| Flag | Default | Description |
|------|---------|-------------|
| `-db` | `~/.local/share/agent-receipts/receipts.db` | Path to a receipt SQLite database |
| `-port` | `8080` | Port to serve on |

### Example

```sh
# Standard local install — no flags required
dashboard

# Point at a custom database
dashboard -db ./receipts.db

# Use a custom port
dashboard -port 9090
```
