SoxAIDocs
Guides

White-Label Deployment

Deploy SoxAI under your own brand with a custom domain and design

White-Label Deployment

SoxAI supports full white-label deployments. Your customers see your brand — your logo, your colors, your domain — with no SoxAI branding visible.

What You Can Customize

ElementDescription
Domainconsole.yourcompany.com, api.yourcompany.com
LogoUploaded image displayed in the console header
Brand colorPrimary accent color (hex code)
FaviconBrowser tab icon
Email senderFrom address for invitation and notification emails
Product nameShown in page titles and email subjects

Setup Overview

  1. Configure DNS records
  2. Configure the tenant brand settings
  3. Verify SSL certificate provisioning
  4. Test the custom domain

DNS Configuration

You need two DNS records pointing to SoxAI's infrastructure:

Type  Name                        Value
CNAME console.yourcompany.com    console.soxai.io
CNAME api.yourcompany.com        api.soxai.io

If you want email sending from your domain, also add:

TXT   yourcompany.com            v=spf1 include:mail.soxai.io ~all
CNAME mail._domainkey            mail._domainkey.soxai.io

DNS propagation typically takes 5–60 minutes.

Brand Configuration

In the Console, navigate to Admin → Tenants → [Your Tenant] → Branding:

{
  "brand_name": "Acme AI Platform",
  "brand_logo_url": "https://assets.yourcompany.com/logo.png",
  "brand_color": "#0066cc",
  "brand_favicon": "https://assets.yourcompany.com/favicon.ico",
  "custom_domain": "console.yourcompany.com"
}

Logo requirements:

  • Format: PNG or SVG
  • Background: Transparent preferred
  • Recommended size: 200×40px or similar horizontal format
  • Hosted at a publicly accessible HTTPS URL

SSL Certificate

SoxAI automatically provisions a Let's Encrypt certificate for your custom domain once the CNAME record is live. The provisioning happens within minutes of saving the custom domain configuration.

You can verify the certificate is active by visiting https://console.yourcompany.com — it should load with a valid SSL certificate.

Color Customization

The brand color is applied to:

  • Primary buttons
  • Active navigation items
  • Accent borders and highlights
  • Progress bars

Use a hex color with sufficient contrast against white (#ffffff) and dark (#1a1a1a) backgrounds.

Email Templates

Transactional emails (invitations, password resets, usage alerts) use your brand name and logo automatically once branding is configured.

For custom email templates or a fully custom sender domain, contact the SoxAI team.

Multiple Tenants, Multiple Brands

Each tenant can have its own custom domain and brand configuration. This is useful for managed service providers or SaaS companies reselling SoxAI capacity under different brands.