Skip to main content

Slug and Custom Domains

Overview​

Configure how your Live Apps (Streamlit, Gradio, etc.) are publicly accessible. MINEO offers two options:

Organization Slug (Free, included in all plans)

  • Quick setup with MINEO's domain
  • URL format: b.mineo.app/your-slug/live_app/app-name
  • Perfect for internal use and getting started

Custom Domain (Available on select paid plans)

  • Use your own domain for professional branding
  • URL format: your-domain.com/live_app/app-name
  • Requires DNS configuration
  • Ideal for client-facing applications
tip

All configurations are managed in: Organization → General → Custom Domains

Organization slug​

A slug is a short, URL-safe identifier that becomes part of your Live App URLs when not using a custom domain.

URL format with slug:

https://b.mineo.app/your-slug/live_app/app-name

Example:

https://b.mineo.app/acme-corp/live_app/sales-dashboard

Requirements​

  • Only letters, numbers, and hyphens
  • No spaces or special characters
  • Short and readable
  • Unique across all MINEO organizations

How to configure​

  1. Go to Organization → General → Custom Domains
  2. Choose "Slug" option
  3. Enter your slug in the field
  4. Click Save
caution

Changing your slug will break existing URLs. Update any bookmarks or integrations before making changes.

Custom domain​

Use your own domain for professional branding and white-label deployments. Custom domains replace the MINEO domain entirely.

URL format with custom domain:

https://your-domain.com/live_app/app-name

Example:

https://apps.example.com/live_app/sales-dashboard

Requirements​

  • Available on select paid plans only
  • You must own the domain and have access to DNS settings
  • Domain must point to MINEO servers via DNS (see setup below)

How to configure​

Step 1: Configure DNS (see DNS Setup section below)

Step 2: Enable in MINEO

  1. Go to Organization → General → Custom Domains
  2. Choose "Custom Domain" option
  3. Enter your exact domain or subdomain (e.g., apps.example.com)
  4. Click Save

Step 3: Wait for DNS propagation

  • Usually takes a few minutes
  • Can take up to 24-48 hours in some cases
  • SSL certificate is automatically configured on first access

DNS setup​

Configure DNS records at your domain provider to point your domain to MINEO servers.

tip

Which option to choose?

  • Use CNAME (Option A) for subdomains like apps.example.com - Recommended and simpler
  • Use A record (Option B) for root domains like example.com - Only when CNAME is not allowed

Recommended for most cases. Use when pointing a subdomain like apps.example.com.

DNS record configuration:

  • Host: apps (or your subdomain name)
  • Type: CNAME
  • Value: b.mineo.app
  • TTL: Automatic or 300-3600 seconds

Example (DNS zone file format):

apps.example.com. 3600 IN CNAME b.mineo.app.
caution

Important DNS notes:

  • Never create both CNAME and A records for the same hostname
  • DNS propagation typically takes minutes but can take up to 48 hours
  • DNS changes must be made at your domain registrar or DNS provider (e.g., Cloudflare, GoDaddy, Route53)

Testing and troubleshooting​

Verify DNS configuration​

Check if your DNS records are correctly configured:

For CNAME records (subdomains):

dig apps.example.com CNAME
# Should return: b.mineo.app

For A records (root domains):

dig example.com A
# Should return: <platform-ip-address>

Common issues​

Domain not working after configuration:

  1. Verify the domain in MINEO matches your DNS record exactly
  2. Wait for DNS propagation (can take up to 48 hours)
  3. Clear your browser cache and try in incognito mode
  4. Use an online DNS checker tool to verify propagation

SSL certificate errors:

  • The SSL certificate is generated automatically on first access
  • Try accessing the URL after DNS has fully propagated
  • Contact MINEO Support if issues persist after 24 hours

Conflicting DNS records:

  • Ensure you don't have both A and CNAME records for the same hostname
  • Remove any old or conflicting DNS records before adding new ones

FAQs​

Do I still need the organization slug with a custom domain? No. The slug is only used when accessing Live Apps through MINEO's default domain. With a custom domain, apps are accessed directly at your-domain.com/live_app/app-name.

Can I use multiple custom domains? No. Each organization can only have one custom domain configured at a time.

What happens to existing URLs when I change my slug or domain? Old URLs will stop working immediately. Plan ahead and update all bookmarks, integrations, and links before making changes.

Who needs to configure DNS records? You or your IT team must configure DNS at your domain registrar or DNS provider (e.g., Cloudflare, GoDaddy, AWS Route53).

Best practices​

  • Prefer subdomains: Use apps.example.com instead of example.com - it simplifies DNS setup and avoids root domain constraints
  • Choose descriptive slugs: Keep slugs short, readable, and consistent with your organization name
  • Plan before changing: Changing slugs or domains breaks existing URLs - coordinate with your team first
  • Test before going live: Verify DNS propagation and SSL certificates work correctly before sharing URLs publicly