Version: 2023.2
Language : English
Submit a license request from the Hub
Submit a license request from a command line and browser (macOS, Linux)

Submit a license request from a command line and browser (Windows)

Submit a license request from the command line to manually activate your license if you’re unable to use the other activation methods.

Note: Only serial-based subscriptions support the manual activation method. This method isn’t supported if you use Unity with a Personal plan.

Before you begin

  • See Manual license activation to make sure you understand the scenario for using this procedure, its limitations, and its internet connectivity requirements.
  • Make sure you know the path where you installed the Unity Editor. Use the Unity Hub to determine the path. Open the Unity Hub and select Installs from the side menu. The list shows the path for each installed Editor. For more information, see Locate the Editor.

The default installation path for the Unity Editor is "C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe".

Procedure

To manually activate your Unity license, follow these steps:

  1. Create a license request file (.alf) from the command line. You must do this step from the computer where you installed Unity.
  2. Use that .alf file to generate a Unity license file (.ulf) from Unity. You must do this step from any computer that has internet access.
  3. Use that .ulf file to activate your license from the command line. You must do this step from the computer where you installed Unity.

1) Create a license request file from the command line

Important: You must run this command from the computer where you installed Unity, but the computer doesn’t need internet access for this step to work.

  1. Open a Command Prompt as an administrator. If you lack administrator privilege, make sure you run this procedure’s command from within your user profile folder.

  2. Make sure you’re aware which directory you’re in. The directory you run the command from is the same directory where the .alf file is output.

  3. Enter the following command, replacing <editor-installation-location> with the actual full path to Unity.exe:

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

    Note: This command doesn’t return output to the Command Prompt. When the command completes, it returns control to the command prompt.

  4. When the command completes, check the directory where you ran the command to make sure it created an activation license file, such as Unity_v2022.2.0b4.alf. If you experience issues, see Troubleshooting.

Now you are ready to generate a Unity license file.

Example

Assuming you installed a 2022.2.0b4 Editor at "C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe", the command for this step is:

"C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe" -batchmode -createManualActivationFile -logfile


2) Generate a Unity license file

The next step is to use the license activation file (.alf) that you just created to request a Unity license file (.ulf).

Important: You can generate a Unity license file from any computer; it doesn’t necessarily need to be the same computer where you installed Unity. However, the computer you use in this step must have an internet connection.

  1. Go to id.unity.com and make sure you’re signed in to your Unity ID. You need a valid login to request a Unity license file.

  2. Use the same browser session to go to license.unity3d.com/manual. The Manual activation page appears.

    Note: If you experience issues accessing this page, try pasting https://license.unity3d.com/manual into your browser’s address bar.

  3. Select the Browse button and use your computer’s file browser to select the license activation (.alf) file from the create a license request file step.

    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 check mark. If you see a red X instead, try again.

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

  5. Enter the serial key 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.

  6. Select the Next button. The Download license file page appears.

  7. Select the Download license file button. If prompted, allow downloads for the license.unity3d.com/manual page.

  8. Open your browser’s downloads location and confirm the new Unity license file, which has a .ulf extension. For example, Unity_v2017.x.ulf.

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

3) Activate your license from the command line

Important: You must run this command from the computer where you installed Unity, but the computer doesn’t need internet access for this step to work.

  1. Make sure you know the following paths:

    • <editor-installation-location> is the actual full path to Unity.exe.
    • <yourUlfFile> is the full path of the .ulf file you generated in the generate a Unity license file step.
  2. Open a Command Prompt as an administrator. If you lack administrator privilege, make sure you run this procedure’s command from within your user profile folder.

  3. Run the following command, replacing <editor-installation-location> and <yourUlfFile> with the actual full paths:

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

    Note: This command doesn’t return output to the Command Prompt. When the command completes, it returns control to the command prompt.

  4. When the command completes, you can view your active license in the Hub by opening the Preferences menu () and selecting Licenses. If you experience issues, see Troubleshooting.

Example

This example assumes that you:

  • Installed a 2022.2.0b4 Editor at "C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe"
  • Generated a .ulf file and stored it at "C:\Users\myAccount\Downloads\Unity_v2017.x.ulf"
"C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe" -batchmode -manualLicenseFile "C:\Users\myAccount\Downloads\Unity_v2017.x.ulf" -logfile

Troubleshooting

If the command line operations don’t yield the expected results, view the Editor.log file. Check the location of this file in Log Files.

Additional resources

Submit a license request from the Hub
Submit a license request from a command line and browser (macOS, Linux)