Skip to main content

Admin Dashboard

The admin dashboard is available in kuploy-cloud (Cloud edition only) at /admin. It provides platform-wide configuration for Stripe billing, SMTP, theme/branding, admin management, and email templates.

Accessing the Admin Dashboard​

The admin dashboard is available to users with the platform admin role.

Bootstrap Admin​

The first admin is established through one of two methods:

  1. PLATFORM_ADMIN_EMAIL environment variable — Set this during deployment. When a user signs up with this email, they are automatically promoted to platform admin.
  2. First-user auto-promotion — If PLATFORM_ADMIN_EMAIL is not set, the first user to sign up becomes the platform admin.

After the initial admin is established, additional admins can be added through the admin dashboard.

Once logged in as an admin, click Admin in the sidebar to access:

  • Stripe Configuration (/admin/stripe)
  • SMTP Configuration (/admin/smtp)
  • Theme & Branding (/admin/theme)
  • Admin Management (/admin/admins)
  • Email Templates (/admin/templates)

Stripe Configuration​

Configure your Stripe integration directly from the admin dashboard instead of using environment variables.

  1. Go to Admin → Stripe
  2. Enter your keys:
    • Secret Key (sk_test_... or sk_live_...)
    • Publishable Key (pk_test_... or pk_live_...)
    • Webhook Secret (whsec_...)
  3. Click Save
Configuration Priority

Settings saved in the admin dashboard (stored encrypted in the database) take priority over environment variables. This means you can override .env values without restarting the application.

SMTP Configuration​

Configure email delivery for verification emails, billing alerts, and notifications.

  1. Go to Admin → SMTP
  2. Enter your SMTP settings:
    • Host — SMTP server hostname
    • Port — SMTP port (typically 587 for TLS)
    • Username — SMTP authentication username
    • Password — SMTP authentication password
    • From Address — Sender email address
    • From Name — Sender display name
  3. Click Test to send a test email
  4. Click Save

For detailed SMTP setup guidance, see SMTP Setup.

Theme & Branding​

Customize the look of your kuploy-cloud instance:

  1. Go to Admin → Theme
  2. Configure:
    • Platform Name — Display name shown in the UI
    • Logo — Upload your logo
    • Primary Color — Brand color for buttons and accents
    • Favicon — Browser tab icon
  3. Click Save
White-Label

Full white-label branding (removing all Kuploy references) requires an Enterprise platform plan. See Licensing & Platform Plans for details.

Custom Docs Domain​

You can point a custom domain (e.g., docs.mycompany.com) at the Kuploy documentation site so your users see branded docs under your own hostname.

  1. Go to Admin → Theme
  2. Scroll to Docs Hostname
  3. Enter your custom docs domain (e.g., docs.mycompany.com)
  4. Click Save
  5. Create a DNS CNAME record: docs.mycompany.com → cname.vercel-dns.com

After saving, the domain is automatically provisioned on the next license sync (~60 seconds). The docs site detects the custom hostname and applies your instance's theme (colors, logo, site name, favicon).

For full setup instructions, DNS options, verification steps, and troubleshooting, see Custom Docs Domain.

Landing Page Templates​

Enterprise license holders can choose from 6 landing page templates:

TemplateDescriptionBest For
Standard (default)Hero + Features + PricingGeneral-purpose
MinimalSingle-screen hero with CTAInternal tools, developer platforms
MarketingFull funnel: Hero, How It Works, Features, Pricing, FAQ, Support, CTAConversion-focused products
Use CasesTabbed 2-column use case showcase + Pricing + FAQMulti-audience platforms
ShowcaseFullscreen animated hero with workflow overlayPremium, app-like feel
MapSplit hero with interactive 3D globe + Features + PricingGlobal/infrastructure platforms

To change the template:

  1. Go to Admin -> Theme
  2. Scroll to Landing Page Template
  3. Click a template to preview its sections and description
  4. Click Save Template
Enterprise Only

Changing the landing page template requires an Enterprise license with the landingPageTemplates feature. Non-enterprise instances use the Standard template.

All templates automatically include the domain search bar in the hero section when a registrar is configured. See Landing Page Templates for detailed descriptions of each template.

Admin Management​

Add or remove platform administrators:

  1. Go to Admin → Admins
  2. To add an admin:
    • Enter the user's email address (they must already have an account)
    • Click Add Admin
  3. To remove an admin:
    • Click Remove next to the admin
    • Confirm the action

Email Templates​

Customize the email templates sent by your platform:

  1. Go to Admin → Templates
  2. Select a template to edit:
    • Welcome Email — Sent when a user signs up
    • Email Verification — Email address verification
    • Password Reset — Password reset link
    • Billing Alert — Usage and payment notifications
  3. Edit the template content
  4. Click Preview to see the rendered email
  5. Click Save