> ## Documentation Index
> Fetch the complete documentation index at: https://glide-9da73dea.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hosted vs self-hosted

> 100% code-parity commitment between Glide Cloud and self-hosted instances, with three documented exceptions (Chainalysis ToS, Privy Multi-tenant, mobile App Store distribution).

The OSS Cathedral plan commits to **100% code parity** between Glide Cloud and self-hosted instances — with explicit documented exceptions. This file is the source of truth for what's the same, what's different, and why.

## Code parity

The web app, mobile app, MCP gateway, all 21 connectors, all 6 hero skills, the policy engine, the grant wrapper, the schemas, the secrets-manager, the CLI, and the create-glide-app scaffolder all ship under MIT in this repo. There is **no `packages/enterprise/`** edition. No feature in code is gated by license, tenant tier, or feature flag based on whether you're on Glide Cloud or self-hosted.

The full list of code surfaces:

* `apps/web/` — Next.js 16 origin app (consumer + admin + agent skill catalog at `/skills`)
* `apps/mcp/` — MCP gateway (22 tools across read/write/treasury endpoints)
* `apps/mobile/` — Expo / React Native mobile app
* `packages/connectors/<slug>/` × 21 — vendor adapters
* `packages/skills/<id>/` × 6 — agent skill packages
* `@glideco/policy-engine`, `@glideco/schemas`, `@glideco/grant-wrapper`, `@glideco/secrets-scan` — Headless platform
* `@repo/secrets`, `@repo/cli`, `create-glide-app` — self-host quickstart

If a code path runs in Glide Cloud, it runs in your self-hosted deploy too. If a UI screen renders in Glide Cloud, you can render it locally with `GLIDE_USE_MOCK_CONNECTORS=true pnpm --filter web dev`.

## What Glide Cloud runs that you operate yourself

The differences are **operational**, not code-level.

| Layer | Glide Cloud | Self-Hosted |
| - | - | - |
| **Vendor seats** | Glide configures provider integrations. Access depends on account eligibility, partner terms and enabled services. | You bring your own Privy Multi-tenant tenant + each individual vendor contract you want to use. |
| **Managed ops** | We run upgrades, security patches, Postgres backups, Redis failover, Inngest scaling, multi-region failover. | You own uptime + backups + scaling. |
| **Compliance packaging** | Audit-log exports and available vendor compliance artifacts. Request evidence for any certification claim. | You assemble your own compliance bundle from per-connector COMPLIANCE.md + your audit-log retention. |
| **Support + SLAs** | Support and escalation under the terms agreed for your account. | GitHub issues + best-effort. Discord / Slack lands with M5.5+. |
| **Mobile distribution** | Glide Cloud's App Store / Play Store binaries point at our backend. | Self-host = self-build. EAS bakes `EXPO_PUBLIC_API_URL` at build time; you do your own EAS build pointing at your backend. |
| **Trusted Partner program** | The Trusted Partner Agreement has no default participation fee; separately agreed commercial terms may apply. Connector code remains MIT. | Promotion ladder is identical (community → verified → core), but you administer it for your own tenant. |

## Documented parity exceptions

Per the OSS plan §M2 §"Foundational Decisions" + Codex review fix #10, three honest exceptions to "100% code parity":

### 1. Chainalysis live adapter (counsel-blocked redistribution)

**Status:** ⚠️ Conditional. As of M2 ship, the Chainalysis adapter ships in OSS at `packages/connectors/chainalysis/` with a prominent `DISCLAIMER.md` stating users must hold their own Chainalysis contract.

**Risk:** If Chainalysis counsel objects to OSS-distributed adapters that call their API even with the disclaimer, Glide Cloud would continue shipping the live adapter while OSS would ship a skeleton interface + the existing `chainalysis-mock` only. We have not received that objection as of this writing; the live adapter is in OSS today.

**Mitigation if blocked:** OSS users would set `SCREENING_PROVIDER=chainalysis-mock` (deterministic fixtures) or `SCREENING_PROVIDER=permissive` (no-op + red banner) until they implement an alternative `screening` capability (TRM Labs, Elliptic, etc.).

### 2. Privy Multi-tenant requirement (vendor-only OSS)

OSS is Privy-only in v1. There is no `auth-local` / Better-Auth fallback. Self-hosters without a Privy Multi-tenant account cannot run Glide today.

**Why:** Per the M2 OSS plan §11, agent banking's programmable-signing-policy is Privy-specific. The alternative (Turnkey sub-org per entity) forces regulatory re-analysis the OSS plan doesn't want to inherit.

**Future:** If Privy's Multi-tenant product changes pricing or availability, OSS users are exposed. Acceptable trade-off per the ceremony review; documented prominently in `docs/SELF_HOSTING.md`.

### 3. Mobile App Store distribution (platform-controlled)

iOS `DCAppAttestService` + Android Play Integrity require Apple / Google developer accounts AND attestation service setup. Glide Cloud's mobile binaries are signed with our developer accounts; self-hosters need their own.

**Posture:** The `AttestationProvider` capability ships with three implementations: iOS (Apple PKI), Android (Play Integrity), and `none` (red admin banner saying attestation is disabled). Self-hosters who don't run their own EAS build set `ATTESTATION=none`.

**Future:** Once App Store / Play Store policies mature for OSS-flavored fork distribution, this exception narrows. Today the platform-attestation requirement IS the gap.

## What's NOT a parity exception

These are sometimes assumed to be exceptions but are NOT:

* **The Trust Console UI**: the admin activity view is present at `apps/web/src/app/(admin)/admin/agents/activity/`. Access to the source repository is separate from code availability in your checkout.
* **Agent skills marketplace** — already shipped at `apps/web/src/app/(public)/skills/` (PR153). Identical render in Glide Cloud + self-hosted.
* **The MCP gateway** — `apps/mcp/` ships in OSS. Identical wire format (MCP spec 2025-11-25). Identical 22-tool surface.
* **Per-connector trust tiers** — promotion ladder works identically. The promotion *administration* differs (we approve verified-tier on Glide Cloud; you approve verified-tier in your own deployment).

## Versioning + upgrade contract

Self-hosters should track the `main` branch tags. Major-version bumps that change schema or break connector contracts will be called out in `CHANGELOG.md` with explicit migration steps. Migration files under `apps/web/drizzle/*.sql` are the source of truth (NOT `_journal.json`); apply via `bash scripts/run-agent-platform-migrations.sh` per `CLAUDE.md`.

## How we keep this file honest

This file is reviewed every quarter (Glide Cloud release-train) AND on every milestone PR that touches `apps/web` or `packages/connectors/<vendor>/`. If you ever discover a Glide Cloud feature that isn't in OSS, file an issue — the parity commitment is real.

## Reference

* `docs/SELF_HOSTING.md` — operator runbook
* `docs/agents/SELF_HOSTING.md` — agent platform self-host
* `apps/mcp/COMPLIANCE.md` — MCP gateway compliance posture
* `CONTRIBUTING.md` — partner-PR flow + trust tiers


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.