Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity License Server

Get Started

Quick start setup

Advanced setup

Administration

Troubleshooting

Unity License Server

​
​
Unity Licensing Server
  • Introduction
  • What's new
  • Requirements
  • Getting started
  • Server setup (quick start)
  • Server setup (advanced)
  • Server administration
  • Server migration
  • Client configuration
  • License checkout to work offline
  • Troubleshooting (server)
  • Troubleshooting (client)
  1. Unity Licensing Server

Troubleshooting the client

Learn how to troubleshoot the client computers that connect to your Unity Licensing Server.
Read time 2 minutes
Last updated 10 months ago

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

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Logs

      • Log paths on Windows

      • Log paths on macOS

      • Log paths on Linux

    • Licensing client exit codes

  • Additional resources
  • Troubleshooting the server

Report a problem with this page