Custom Domains

Serve your imgbt assets from a custom domain instead of the default *.imgbt.com subdomain.

Setup

1. Add Domain in Dashboard

Navigate to your vault's Domains settings and add your custom hostname (e.g., cdn.example.com).

2. Create CNAME Record

Add a CNAME record in your DNS provider pointing to your vault's imgbt subdomain:

cdn.example.com  CNAME  your-vault.imgbt.com

3. Verify

imgbt will automatically verify the domain and provision a TLS certificate via Cloudflare. This typically takes a few minutes.

Domain Rules

• Must be a valid fully qualified domain name (FQDN)
• Cannot use *.imgbt.com subdomains
• Cannot use localhost or IP addresses
• Each domain can only be bound to one vault
• TLS certificates are automatically provisioned and renewed

API

List Domains

GET /api/v1/vaults/{vaultId}/domains

Add Domain

POST /api/v1/vaults/{vaultId}/domains
Content-Type: application/json

{ "hostname": "cdn.example.com" }

Remove Domain

DELETE /api/v1/vaults/{vaultId}/domains/{domainId}

Domain Status