This guide is designed to help you resolve common issues encountered while activating the license key for a workspace. Each section includes potential causes and step-by-step solutions for identified problems.

​
License is invalid

Error: Your license is invalid or already in use.
  • This issue usually occurs when your server has trouble connecting to ours to verify the license. Try running prime-cli restart, and it should resolve the problem.
  • If you migrated Plane to a new server without first delinking the license key from the old server, this error might happen. In that case, please reach out to the support team to have the license key delinked. For future reference, if you need to reinstall Plane or move to another server, follow this guide to ensure a smooth transition.

​
Something went wrong

Error: Something went wrong please try again later
This error usually occurs when the license validation service is unavailable. Here’s how you can troubleshoot it:
  1. Confirm that your Plane instance is running the latest version.
  2. If it’s not up-to-date, update to the latest version.
Updating typically resolves this issue. If the problem persists, double-check your network connection and any firewall rules that might block access to the license validation service.

​
Payment server is not configured

Error: Payment server is not configured
This usually occurs when the environment confiuration is incorrect. The Env variable payment_server_url is missing in the setup. In this case, follow the below steps.
  1. Backup the plane.env file. See this.
  2. Run prime-cli repair to allow Prime CLI to attempt automatic fixes to the plane.env file.
  3. Try activating your workspace with the license key.
  4. If needed, you can configure the instance in God mode or adjust the environment variables directly in the new plane.env file.