Version: 2023.1
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: The manual activation method isn’t supported for Unity licenses under 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.
  2. Use that .alf file to generate a Unity license file (.ulf) from Unity.
  3. Use that .ulf file to activate your license from the command line.

Create a license request file from the command line

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


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. 选择您要激活的许可证类型:

    • 如果您选择 Unity Plus or Pro 选项,输入您在购买单个许可证时收到的电子邮件中的序列号。必须严格按照电子邮件中显示的格式输入密钥。例如,PS/SC/E3-XXXX-XXXX-XXXX-XXXX
    • 如果您选择 Unity Personal 选项,您必须选择最符合您当前情况的选项。
  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.

Activate your license from the command line

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

故障排除

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.

其他资源

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