Troubleshooting the client
This section outlines steps you can take to investigate issues with your licensing client.
Scan your log files and exit codes for information. You can also view the Floating Licenses and Build Servers category in Unity Support, to check if the issue you're experiencing is covered in an existing article.
If you can't resolve the issue on your own, submit a support request by using the Unity Support portal.
Logs
A client computer generates several log files that you can use to diagnose floating licensing problems. The following tables list the locations of different types of logs.
Log paths on Windows
| Log type | File path |
|---|---|
| Unity Editor | %LOCALAPPDATA%\Unity\Editor\Editor.log |
| Licensing Client | %LOCALAPPDATA%\Unity\Unity.Licensing.Client.log |
| Licensing Audits | %LOCALAPPDATA%\Unity\Unity.Entitlements.Audit.log |
| Unity Hub | %APPDATA%\UnityHub\logs\info-log.json |
Log paths on macOS
| Log type | File path |
|---|---|
| Unity Editor | ~/Library/Logs/Unity/Editor.log |
| Licensing Client | ~/Library/Logs/Unity/Unity.Licensing.Client.log |
| Licensing Audits | ~/Library/Logs/Unity/Unity.Entitlements.Audit.log |
| Unity Hub | ~/Library/Application\ Support/UnityHub/logs/info-log.json |
Log paths on Linux
| Log type | File path |
|---|---|
| Unity Editor | ~/.config/unity3d/Editor.log |
| Licensing Client | ~/.config/unity3d/Unity/Unity.Licensing.Client.log |
| Licensing Audits | ~/.config/unity3d/Unity/Unity.Entitlements.Audit.log |
| Unity Hub | ~/.config/UnityHub/logs/info-log.json |
Licensing client exit codes
The Licensing Client exit codes indicate successful or failed execution of a command. You can use these exit codes in CLI scripts to control execution flow.
| Exit code | Status |
|---|---|
0 | OK |
1 | Invalid arguments |
2 | Invalid credentials |
3 | Organization ID is missing |
4 | Package Access Control List file download failed |
5 | Context initialization failed |
6 | Replication service initialization failed |
7 | Orchestrator initialization failed |
8 | Floating service initialization failed |
9 | Package service initialization failed |
10 | Access token initialization failed |
11 | Multi client pipe server start failed |
12 | License activation generation failed |
13 | Syncing entitlements failed |
14 | No valid entitlement found |
15 | License update failed |
16 | Unable to get list of user seats |
17 | Seat activation or deactivation failed |
18 | Getting entitlements failed |
19 | Acquiring license failed |
20 | Renewing floating lease failed |
21 | Returning floating lease failed |
1000 | Unknown error |