Step-by-step user guide

Run UmamiEdge as a global distributed AI compute pilot.

This guide explains the practical workflow for founders, operators, site owners, enterprise customers, customer-success teams, and launch owners.

Quick links

Operator shortcuts.

User workflow

Eight steps from sign-in to go-live acceptance.

Each step tells the user what to do, who owns it, and what evidence confirms it is complete.

01

Sign in

Owner: Owner or operator

You enter the platform with a valid Supabase session.

  • Open /login.
  • Choose Google, GitHub, or magic link.
  • After sign-in, confirm your email appears in the header.
  • If login behaves strangely, use Clear stale session and retry on the login page.
Acceptance evidence: Header shows your email and Sign out.
02

Create the organization

Owner: Account owner

A tenant is created for your team, customer, or pilot network.

  • Open /onboarding.
  • Choose Create organization.
  • Enter organization name and intended use case.
  • Confirm you can see the organization in the header switcher.
Acceptance evidence: Organization appears in the switcher and onboarding proceeds to site setup.
03

Add the first site

Owner: Operations lead

A physical or commercial host location is registered.

  • Open /onboarding/site.
  • Enter site name, city, country, power capacity, site type, and connectivity tier.
  • Use commercial sites first: telecom rooms, universities, banks, hospitals, industrial parks, or edge rooms.
  • Confirm the site appears in node setup.
Acceptance evidence: Site is available for node registration.
04

Register the first node

Owner: Operator + infrastructure engineer

A GPU or inference node exists in the registry with a secure telemetry key.

  • Open /onboarding/node.
  • Enter node name, external ID, accelerator type, GPU count, power draw, and latency estimate.
  • Generate the node API key.
  • Copy the secret immediately because the platform only stores a secure hash and prefix.
  • Store the secret in your node-agent config or secret manager.
Acceptance evidence: Node appears under /nodes and the key prefix appears under /nodes/keys.
05

Monitor daily operations

Owner: Operator

The team can understand health, incidents, usage, and readiness from dashboards.

  • Open /operator for mission control.
  • Open /status for system status.
  • Open /observability for operational monitoring.
  • Open /incidents for degraded or critical events.
  • Open /usage and /billing-control for commercial metrics.
Acceptance evidence: Operators can identify online nodes, degraded nodes, critical incidents, and usage trends.
06

Run customer and partner workflows

Owner: Customer-success lead

Pilot customers, site owners, and partners have clear workflows.

  • Use /pilot-room to track pilot accounts.
  • Use /partner-onboarding and /partners/pipeline for partner progress.
  • Use /site-owner to explain host-site economics.
  • Use /training to prepare customer enablement.
  • Use /contracts and /legal for readiness evidence.
Acceptance evidence: Each customer or partner has owner, milestone, risk, and next action.
07

Prepare customer API access

Owner: Admin + customer engineer

A customer can test the OpenAI-compatible gateway safely.

  • Open /gateway to review available endpoints.
  • Open /customers/keys to review customer access model.
  • Confirm quota, SLA, region, and data residency expectations.
  • Test /api/v1/models before giving the customer chat or embedding endpoints.
  • Document expected model IDs and support escalation path.
Acceptance evidence: Customer can run a model-list request and understands limits and support process.
08

Complete go-live acceptance

Owner: Launch owner

A pilot can move from demo to controlled production readiness.

  • Open /go-live and /acceptance.
  • Review readiness, security, legal, training, and implementation gates.
  • Open /risk-register and close or assign all high-risk launch items.
  • Open /support and confirm escalation owners.
  • Use /executive and /board-metrics for final stakeholder review.
Acceptance evidence: All critical gates have an owner, status, due date, and evidence link before launch.
How to read the product

Dashboard concepts.

Node health

Online, degraded, offline, and retired node states show operational availability and maintenance risk.

Telemetry

GPU utilization, memory, temperature, latency, power draw, and heartbeat events indicate whether a node is safe for inference workloads.

Routing

The router selects nodes based on health, latency, available power, residency rules, runtime readiness, and tenant quota.

Incidents

Warnings and critical telemetry should create or update incident records for operator triage and audit visibility.

Billing

Usage events, committed capacity, node revenue, and site-owner payouts define pilot economics.

Trust evidence

Compliance packs summarize node authentication, RLS, data residency, SLA policy, and incident response posture.

Roles

Who uses what.

Owner

Create the organization, approve billing/commercial model, assign administrators, and approve go-live.

Admin

Manage sites, nodes, runtimes, customer keys, compliance evidence, organization settings, and team access.

Operator

Monitor telemetry, respond to incidents, schedule maintenance, run failover checks, and validate SLA posture.

Viewer

Read dashboards, reports, guides, executive status, and launch-readiness evidence without changing settings.

Site owner

Track site earnings, power consumption, uptime, maintenance windows, and contract status.

Customer

Use OpenAI-compatible APIs, follow quotas, review model endpoints, and escalate support through agreed channels.

Operating rhythm

Daily and weekly routine.

Morning

Open /status, /operator, /observability, and /incidents. Confirm no critical telemetry or offline production nodes.

Midday

Review /usage, /billing-control, /customer-success, and /support. Update customer or partner next actions.

Evening

Review /risk-register, /deployments, and /go-live. Close completed gates and assign blockers before the next day.

Weekly

Review /board-metrics, /executive, /finance, /partners/pipeline, and /commercial to prepare investor or leadership updates.

Acceptance gates

What must be true before a customer pilot goes live.

Auth

Google/GitHub/magic-link sign-in works and stale session recovery is documented.

Tenant

Organization, role, site, and node setup are complete for the pilot customer.

Telemetry

At least one node sends heartbeat, GPU, temperature, latency, and power metrics.

Security

Node API keys, RLS, customer access model, and compliance evidence have been reviewed.

Commercial

Pilot plan, pricing, contract pack, procurement path, and site-owner economics are documented.

Support

Escalation owner, response path, risk register, and training materials are ready.

User Guide | UmamiEdge | UmamiEdge