Are you seeing the error message, “Activation failed: please make sure serial number is valid. You can also check the Hub log or contact Unity support” while trying to activate your Unity license? This issue is frustrating but not uncommon, and it can stem from a variety of factors such as expired serial keys, network issues, or authorization errors.
In this article, we’ll help you troubleshoot the root cause of this error and guide you through possible solutions to activate your Unity license.
Symptoms:
- Why does the Hub say my license key is invalid?
- I see an error when I try to activate my license.
- Why won't my Unity license activate?
Cause:
There are many causes for a serial number to appear invalid; the only way to diagnose your exact problem is by examining your log files. The most common causes of this error are:
- An expired serial key.
-
Authorization issues:
- Usually signaled by the error, "Access token is expired, attempting to get a new one with refresh token" and "403 Forbidden" appearing in the logs with multiple retries.
-
Network errors:
- ETIMEDOUT appearing in the logs suggests that the Unity Hub is unable to establish a connection to certain servers.
- ENOTFOUND appearing in the logs suggests the system is unable to resolve Unity’s servers' DNS names. This could suggest a DNS misconfiguration on your machine or network.
Recommendations:
Because networks and machine configurations can vary dramatically from person to person, Unity can only provide suggestions for resolutions rather than fixes. However, below are some common troubleshooting steps to try:
Verify the serial key
First, ensure that your serial number is correct and valid. For more information, see the article 'How do I find my license serial number?'.
Authorization and network issues
- Check network connectivity: Ensure your machine has an active and stable internet connection.
- Check for firewall or antivirus settings that may block Unity Hub.
- If you use a proxy server, ensure the Unity Hub has the correct proxy settings configured.
The simplest solution is to add entire domains for the following resources in your exception list:
- unity.com
- unity3d.com
- plasticscm.com
- google.com
- googleapis.com
- microsoft.com
- aka.ms
If you want to selectively control the subdomains, add items from the table in the proxy exception manual page. See also: Using Unity through web proxies
- Flush DNS Cache and Verify DNS Settings: Run ipconfig /flushdns (on Windows) to clear the DNS cache and verify your DNS settings.
- Update the Unity Hub: Ensure that the Unity Hub is updated to the latest version.
Manual activation
If the above suggestions do not help to activate your license, we recommend manual activation instead.
Important: Manual activation is not available for Unity Personal (free) licenses. |
More information can be found in the article, How do I manually activate my Unity license?
Further information
If you continue to see errors when trying to activate your license after trying each troubleshooting step above, contact the Customer Experience team with the log files found in the file locations below for further assistance:
(Select View and tick the Hidden items checkbox if the files are hidden.)
The Hub log file (info-log.json):
- Windows:
C:\users\<yourusername>\AppData\Roaming\UnityHub\logs
-
Mac:
~/Library/Application Support/UnityHub/logs
-
Linux:
~/.config/UnityHub/logs
-
Window:
C:\users\<yourusername>\AppData\Local\Unity\Unity.Licensing.Client.log
-
Mac:
~/Library/Logs/Unity/Unity.Licensing.Client.log
-
Linux:
~/.config/unity3d/Unity/Unity.Licensing.Client.log