> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qumo-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Relay Network

> Run the full relay network locally — control plane, peer-discovery, Nomad, Consul, and a relay node.

# Local Relay Network

The local relay network stands up the **same stack as production** on your development machine:
the Qumo control plane (`qumo-deploy`), the `peer-discovery` service, a single-node
**Nomad** scheduler, **Consul** for service discovery, and a relay node submitted as a
real Nomad job.

## Quickstart

Run one command from the repository root:

```bash theme={null}
infisical run -- mage relay:up
```

This starts all control plane services and brings up local relay nodes.

## Architecture

```text theme={null}
Your machine
┌────────────────────────────────────────────────────────────┐
│  mage relay:up                                              │
│                                                            │
│  qumo-deploy :8080  ◀── credentials/usage ────────────── │
│  (control plane)       │                                   │
│                        │   QUMO_RELAY_TOKEN                │
│  peer-discovery :8081  │                                   │
│  (hubs registry)     ▲ │   REMOTE_RESOLVER_URL /peers      │
│            Consul :8500│                                   │
│            Nomad  :4646│                                   │
│                       │                                     │
│                 ┌─────┴───────┐                            │
│                 │ qumo-relay  │  (Nomad job, exec driver)  │
│                 │ :4433 QUIC  │                            │
│                 └─────────────┘                            │
└────────────────────────────────────────────────────────────┘
```

## Prerequisites

* **CockroachDB**: Reachable via `DATABASE_URL` (run `mage integ:setup` to write credentials).
* **Nomad & Consul**: Available on your PATH in dev mode.
* **Qumo Relay binary**: Built from `github.com/qumo-dev/qumo`.