Version: 2019.4
Manage your License through the command line
License Troubleshooting

Offline (manual) license activation

If Unity can’t contact the license server, you can’t activate your license using the Unity Hub or the command line. Typical reasons for failing to connect to the license server include: you don’t have access to the internet; your firewall or proxy settings are blocking the connection; or the Unity license servers are down. For more information, see Activation issues.

When online activation fails, you can try to manually activate Unity on your machine. You still need access to a machine with internet access, but it does not have to be the machine on which you are trying to activate Unity.

To manually activate your Unity license, follow this process:

  1. Generate a license activation file (.alf) from the command line. For example, Unity_v2021.1.0a7.alf.
  2. Use that .alf file to request a Unity license file (.ulf) from Unity’s license server.
  3. Use that .ulf file to activate your license in Unity from the command line.

Generate a license activation file (.alf) from the command line

On macOS, enter the following into the Terminal (replacing <editor-installation-location> with the actual installation location, such as /Applications/Unity/Unity.app/Contents/MacOS/Unity):

<editor-installation-location> -batchmode -createManualActivationFile -logfile

On Windows, enter the following into the Command Prompt (replacing <editor-installation-location> with the actual installation location, such as C:\Program Files\Unity\Editor\Unity.exe):

"<editor-installation-location>" -batchmode -createManualActivationFile -logfile

Now you are ready to request a Unity license (.ulf) file.

Request a Unity license file (.ulf) file

After you generate a license activation (.alf) file, the next step is to request your Unity license (.ulf) file from the license server:

  1. Open the license.unity3d.com/manual webpage.

  2. If prompted, sign into your Unity ID. This is necessary in order to request a Unity license file.

    The Manual activation webpage appears.

  3. Select the Browse button to locate the license activation (.alf) file you already generated using your system’s file browser.

    If the upload was successful and Unity detected that the file you chose was a license activation file, the filename appears in the text box with a green checkmark. If you see a red X instead, try again.

  4. Select the Next button. The Activate your license webpage appears.

  5. Select which license type you are activating:

    • If you select the Unity Plus or Pro option, enter the Serial Number you received in an email when you purchased a single license. You need to enter the key in the exact format that it appears in the email. For example, PS/SC/E3-XXXX-XXXX-XXXX-XXXX.
    • If you select the Unity Personal option, you must select the option which best describes your current situation.
  6. Select the Next button. The Download license file webpage appears.

  7. Select the Download license file button.

  8. Allow downloads for the license.unity3d.com/manual webpage if your system prompts you.

  9. Open your browser’s downloads location and look for the new Unity license file with the .ulf extension.

Now you are ready to activate your Unity license from the command line.

Finish your Unity license activation from the command line

On macOS, enter the following into the Terminal (replacing <editor-installation-location> with the actual installation location, such as /Applications/Unity/Unity.app/Contents/MacOS/Unity):

<editor-installation-location> -batchmode -manualLicenseFile <yourulffile> -logfile

On Windows, enter the following into the Command Prompt (replacing <editor-installation-location> with the actual installation location, such as C:\Program Files\Unity\Editor\Unity.exe):

"<editor-installation-location>" -batchmode -manualLicenseFile <yourulffile> -logfile

If Unity displays an error message that the license activation was not successful, check Activation issues to find a solution for your issue.


  • License activation updated in Unity 2017.2
Manage your License through the command line
License Troubleshooting