Version: 2021.3
Language : English
Get started with Embedded Linux
Embedded Linux Player settings reference

Install the Unity Editor for Embedded Linux

Install and set up the Unity Editor for Embedded Linux on your Windows, Linux, and macOS systems.

Note: Unity Editor for Embedded Linux is available under separate terms. For licensing and download information, contact your Account Manager or the Unity Sales team.

System requirements

The system requirements for the Unity Editor, Player, and Server are outlined in the System requirements.

Windows

  1. Double-click UnitySetup64.exe to install Unity setup for Embedded Linux in your chosen folder.
  2. Double-click UnitySetup-Embedded-Linux-Support-for-Editor.exe to install the Unity Editor for Embedded Linux in the same folder.

Linux

  1. Unpack Unity.xzto install Unity setup for Embedded Linux in your chosen folder.
  2. Unpack UnitySetup-Embedded-Linux-Support-for-Editor.xz in the same folder.

macOS

  1. Double-click the Unity.pkg and install Unity setup for Embedded Linux in your chosen folder.
  2. Install UnitySetup-Embedded-Linux-Support-for-Editor.pkg in the same folder.

Project setup

After you create a new project with the newly installed Unity, you must install the relevant toolchain and SDK packages for your operating system and target architecture. To install a Unity package for Embedded Linux toolchain and SDK, refer to Install a UPM package by name.

Toolchain packages for your operating system:

Operating system Package
Windows com.unity.toolchain.win-x86_64-embeddedlinux
MacOS com.unity.toolchain.macos-x86_64-embeddedlinux
Linux com.unity.toolchain.linux-x86_64-embeddedlinux

SDK packages for your target architecture:

Target architecture Package
aarch64 com.unity.sdk.embeddedlinux-aarch64
x86_64 com.unity.sdk.embeddedlinux-x86_64
arm32 com.unity.sdk.embeddedlinux-arm32
x86 com.unity.sdk.embeddedlinux-x86

After you’ve installed the packages, the Package Manager window displays the toolchain and SDK packages that are installed for Embedded Linux.

Package Manager window with Embedded Linux toolchain package
Package Manager window with Embedded Linux toolchain package

Automated packages installation

You can also install the required Embedded Linux packages automatically from the Build Settings window.

To initiate the automatic installation of packages:

  1. Go to File > Build Settings from Unity’s main menu.
  2. In the Platform list, select Embedded Linux and then click Switch Platform.
  3. Open the Project Settings window by clicking Edit > Project Settings window.

If your Editor has the Install toolchain packages automatically option enabled by default, then the required packages such as the toolchain and SDKs for installed architectures are installed automatically. After the package installation process is complete, you can check which packages are installed in the Toolchain Management (Embedded Linux) tab in Project SettingsA broad collection of settings which allow you to configure how Physics, Audio, Networking, Graphics, Input and many other areas of your project behave. More info
See in Glossary
.

Installed packages in Toolchain Management (Embedded Linux)
Installed packages in Toolchain Management (Embedded Linux)

If the option to automatically install packages is disabled, you can switch to the Toolchain Management (Embedded Linux) tab and click Install sdk and toolchain packages.

After you’ve installed the packages, the Package Manager window displays the list of all the toolchain packages that are installed for Embedded Linux.

Install sdk and toolchain packages button in Toolchain Management (Embedded Linux)
Install sdk and toolchain packages button in Toolchain Management (Embedded Linux)

Additional resources

Get started with Embedded Linux
Embedded Linux Player settings reference