License errors

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

• 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

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

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.
   1. Navigate to the /opt/plane folder on your machine or server where Plane is installed..
   2. Locate the plane.env file.
   3. Copy this file to a different location as a backup, so you can restore it if needed.
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.