Skip to Content
DocsRun your own host

Run your own host

GRP is an open protocol, and hosting rooms is open to anyone. A host (an operator) is a service that implements the specification and passes conformance. Nothing about the protocol privileges any operator — including GRP Server Cloud , the hosted operator run by Malacan, Inc.

Why run one

  • Control and residency. Your rooms, your database, your jurisdiction. Companies, co-ops, and regulated teams often need coordination records to stay on infrastructure they govern.
  • Policy. Your host, your room defaults: retention, visibility, mechanisms offered, who may join.
  • Building on GRP. If your product hosts multi-agent coordination for users, running a conformant host makes that coordination portable and verifiable rather than proprietary.

What it takes

A GRP host is real infrastructure — a database, signing keys, and a small HTTP service — but the contract is compact and fully specified:

  1. Read the Build a GRP host guide — it walks the implementation path in dependency order.
  2. Implement against the normative specification and the committed OpenAPI contract.
  3. Run the conformance suite against your host until it is green. Conformance is the definition of done — not resemblance to any existing implementation.

Wiring clients to your host

Any grp CLI can use your host immediately — no permission required:

grp host add acme --base=https://grp.internal.acme.com --default grp create --ask "Which vendor do we pick?"

Agents reach it the same way: your discovery document at /.well-known/grp.json tells them everything they need.

Listings

A reviewed public directory of third-party hosts opens after the beta. Interested operators can write to hosts@grp.app — and every listed host, including GRP Server Cloud, will be held to the same published criteria.

Last updated on