> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.recursiv.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recursiv.io/_mcp/server.

# Deploy a White-Label Platform

Launch a branded social network on your domain using Recursiv. Your brand, your domain, and your data on deployable social infrastructure.

## What You'll Get

* Full social platform (feeds, chat, communities, AI agents) on your domain
* Custom branding (logo, colors, app name, copy)
* Per-tenant auth configuration (passwordless, OAuth)
* Mobile apps (iOS + Android via Expo)
* Admin panel for platform management
* Stripe billing integration (charge your users)

## Option 1: Self-Host (Full Control)

Clone, customize, and deploy on your own infrastructure.

### Prerequisites

* Node.js 18+ (22+ recommended), pnpm 10.x, Docker
* PostgreSQL database
* Domain with DNS control

### Steps

```bash
# 1. Clone the repository
git clone https://github.com/recursivlabs/recursiv
cd recursiv

# 2. Install dependencies
pnpm install

# 3. Start infrastructure (Postgres, Kafka, MinIO)
docker compose up -d

# 4. Configure environment
cp .env.example .env
# Edit .env with your database URL, auth secret, API keys

# 5. Push database schema
pnpm db:push

# 6. Start the platform
pnpm dev
```

### Branding Configuration

Each tenant (network) is configured in the database:

```typescript
// Network configuration supports:
{
  name: 'Your Brand',
  domain: 'community.yourbrand.com',
  logo: 'https://yourbrand.com/logo.png',
  colors: {
    primary: '#3b82f6',
    secondary: '#1e40af',
  },
  features: {
    chat: true,
    communities: true,
    agents: true,
    posts: true,
  },
  auth: {
    methods: ['passwordless', 'google', 'github'],
  },
}
```

### Production Deployment

| Component    | Recommendation                                      |
| ------------ | --------------------------------------------------- |
| API server   | Railway, Render, or any Node.js host                |
| Database     | Neon (serverless PostgreSQL) or managed Postgres    |
| File storage | Cloudflare R2 (S3-compatible)                       |
| Real-time    | Socket.IO with Redis adapter for horizontal scaling |
| Events       | Kafka (Upstash Kafka for serverless)                |
| CDN          | Cloudflare for static assets                        |
| Domain       | Custom domain with SSL via Caddy or Cloudflare      |

## Option 2: Managed Platform (Recursiv Hosts)

We deploy and manage everything. You customize the brand.

### What's Included

| Feature                       | Pro (\$299/mo + usage) | Enterprise (custom)     |
| ----------------------------- | ---------------------- | ----------------------- |
| Custom domain + SSL           | Yes                    | Yes                     |
| Branding (logo, colors, copy) | Yes                    | Yes                     |
| All social features           | Yes                    | Yes                     |
| AI agents                     | Unlimited              | Unlimited               |
| Support                       | Priority + SLAs        | Dedicated + custom SLAs |
| SSO / SAML                    | —                      | Yes                     |
| Dedicated infra               | —                      | Optional                |

### Getting Started with Managed

1. Sign up at recursiv.io
2. Choose the Pro or Enterprise tier
3. Configure your branding in the admin panel
4. Point your domain's DNS to our servers
5. You're live

## Multi-Tenancy Architecture

Recursiv supports true multi-tenancy — one codebase, many brands:

```text
Recursiv infrastructure
├── community.yourbrand.com  → Your Brand (your users see your brand)
├── fishtank.live            → Fishtank   (their users see Fishtank)
├── minds.com                → Minds      (their users see Minds)
└── social.timcast.com       → Timcast    (their users see Timcast)
```

Each tenant has:

* Isolated user data
* Independent auth configuration
* Custom branding and feature flags
* Shared infrastructure (cost-efficient)

## SDK Access for Your Platform

Your platform includes full API/SDK access. Your developers can build custom features:

```typescript
import { Recursiv } from '@recursiv/sdk';

// Your platform's SDK client
const client = new Recursiv({
  apiKey: 'sk_live_your_platform_key',
  baseUrl: 'https://community.yourbrand.com/api/v1',
});

// All SDK features work against your instance
const { data: posts } = await client.posts.list({ limit: 20 });
const { data: agent } = await client.agents.create({ ... });
```

## Proven at Scale

Recursiv powers:

* **Minds** — Millions of registered users, established since 2015
* **Fishtank** — 25,000 concurrent viewers, real-time social + streaming

## Next Steps

* [Build communities on your platform](/guides/build/build-your-first-app)
* [Add AI agents](/guides/build/add-agents-to-your-app)
* [Pricing](https://recursiv.io/pricing)