White-label getting started
White-label Carina lets you sell an AI agent product under your brand while Carina runs the engine, memory, tools, and deploy stack behind the scenes.
This guide is for partner operators (agencies, consultancies, MSPs) and managed customers who receive a branded workspace. It does not cover kernel development; see the Developer Guide for that.
Who does what
| Area | You (partner or customer) | Carina platform |
|---|---|---|
| Product name, logo, colors | Yes | Defaults only |
| Custom domain and TLS | You configure DNS; Carina verifies | Routing and brand resolution |
| Client workspaces | You create and hand off | Isolation and quotas |
| LLM API keys (BYOK) | Your keys in the workspace vault | Proxy and metering only |
| Skill packs and vertical bundles | You choose what to enable | Pack format and install |
| Billing to end clients | Your Stripe or contract | Partner tier limits on hosted cloud |
| Kernel updates, security patches | Receive via deploy | Carina ships and documents |
Paths
Managed cloud (fastest)
Best for agencies launching client workspaces on Carina Cloud.
- Create your operator account on app.carinaai.uk.
- Open Settings > Brand and set product name, support email, and accent color.
- Upgrade to a partner-capable plan if you need multiple client workspaces (Billing and plans).
- Add a custom domain when you are ready for a customer hostname.
- Install vertical skill packs that match your niche.
- Hand off the workspace to your client.
Self-hosted white-label
Best for operators who want their own VPS or private cloud.
- Deploy the Carina stack with Self-hosting or your operator runbook.
- Use a dedicated compose project per customer when multiple brands share one host (Docker isolation).
- Point
CARINA_CLOUD_CONTEXTat your branded app build or configure brand JSON per workspace. - Scope ops tooling with
OPS_DOCKER_PROJECTSorCARINA_WHITE_LABEL_STACKso unrelated stacks stay hidden.
First-week checklist
| Step | Where | Done when |
|---|---|---|
| Brand configured | App Settings > Brand | Login page shows your product name |
| Provider key added | Settings > API keys | Chat returns model responses |
| Vertical packs installed | Skill packs | Domain context appears in chat when relevant |
| Domain verified (optional) | Settings or ops API | Browser opens your hostname with correct brand |
| Client invited | Workspace handoff doc | Client signs in on your URL |
| Support contact set | Brand settings | Emails and help links use your address |
In-app onboarding
The cloud app shows a setup checklist on the launcher until core steps are complete. It mirrors this doc: keys, brand, packs, and handoff links. Dismiss it when your workspace is production-ready.