Skip to main content

License troubleshooting

"License validation failed"​

  • Verify your license key is correct
  • Check that LICENSE_HUB_URL points to https://kuploy.app (or check Admin → Domains for the effective URL)
  • If you configured the license via the admin UI, the UI values override env vars — verify the saved URL is correct
  • Ensure your instance can reach the internet

"Claim code expired"​

Claim codes expire after 15 minutes for security. Generate a new one by restarting the Setup Wizard or refreshing the setup page on your instance.

"Instance limit reached"​

Your plan has a maximum number of instances. To add more:

Instance stuck on old/expired license​

If you created a new license but your instance is still reporting against an old one, ask your platform admin to reassign it. If you set up a new instance instead, use the Claim Code flow to link it to your new license.

"Custom domains are not available on your plan"​

Your plan doesn't include the custom domains feature. Custom domains require a Starter plan or higher. Upgrade at kuploy.app/billing.

"Custom domain limit reached"​

You've used all custom domain slots for your plan. To add more:

  • Remove unused custom domains to free up slots
  • Upgrade your plan for a higher limit

"Domain purchasing requires an Enterprise plan"​

The domain purchase feature is only available on the Enterprise plan. If you need to buy and manage domains directly through your platform, upgrade at kuploy.app/billing.

"Domain purchase limit reached"​

You've used all purchasable domain slots for your plan. To add more:

  • Remove unused purchased domains to free up slots
  • Contact support for a custom limit increase

"License is suspended"​

Your license has been suspended. Contact support or check your billing status at kuploy.app. While suspended, new custom domains and resource creation are blocked.