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:

infisical run -- mage relay:up

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

Architecture

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.

​Local Relay Network

​Quickstart

​Architecture

​Prerequisites

Local Relay Network

Quickstart

Architecture

Prerequisites