E3DS Documents & Tutorials

Setup the Linux Cross-Compile Toolchain

In this guide, we will show how to set up the Linux Cross-Compile Toolchain on Windows OS to enable Linux packaging in Unreal Engine.

After completing this setup, Unreal Engine will be able to package your project as a Linux build from a Windows machine.










Follow the steps below:


Step 1. Open Unreal Engine Library in Epic Games Launcher

Open the Epic Games Launcher.

Go to: Unreal Engine → Library

Here, you will see the installed Unreal Engine versions.

image-20260520-064432.png
Figure 1. Unreal Engine Library in Epic Games Launcher








Step 2. Open the Engine Version Menu

Find the Unreal Engine version you want to use for Linux packaging.

Click the three-dot / more icon beside that engine version.

image-20260520-064604.png
Figure 2. Opening the Unreal Engine Version Menu









Step 3. Select Options

From the menu, click Options.

This will open the installation options for the selected Unreal Engine version.

image-20260520-064619.png
Figure 3. Selecting Options for the Unreal Engine Version









Step 4. Enable Linux Target Platform

In the options window, go to the Target Platforms section.

Enable Linux, then click Apply.

Epic Games Launcher will begin downloading the required Linux platform files.

image-20260520-064810.png
Figure 4. Enabling Linux Target Platform Support



After clicking Apply, the download will start.

image-20260520-064845.png
Figure 5. Linux Platform Support Download in Progress



Wait until the installation is complete before continuing to the next step.














Step 5. Download the Linux Cross-Compile Toolchain

Go to the Epic Official Doc for Linux development requirements. Find the Cross-Compile Toolchain section and download the toolchain that matches your Unreal Engine version.

Make sure you select the correct toolchain version for your installed Unreal Engine version.

image-20260520-065111.png
Figure 6. Downloading the Linux Cross-Compile Toolchain from Epic Documentation












Step 6. Run the Downloaded Toolchain Installer

After the download is complete, locate the downloaded toolchain installer.

Double-click the installer to start the installation process.

image-20260520-065246.png
Figure 7. Launching the Linux Cross-Compile Toolchain Installer








Step 7. Complete the Toolchain Installation

Follow the installer instructions.

Click Yes, Next, and OK where required to complete the installation.

Keep the default installation path unless you have a specific location you want to use.

image-20260520-065345.png
Figure 8. Confirming Toolchain Installer Permission




image-20260520-065433.png
Figure 9. Completing the Toolchain Installation








Step 8. Open Environment Variables

Open the Windows search menu and search for:

Edit the system environment variables

Then open it and click Environment Variables.

image-20260520-065530.png
Figure 10. Opening Windows Environment Variables











Step 9. Edit LINUX_MULTIARCH_ROOT

Under the environment variables list, find:

LINUX_MULTIARCH_ROOT

Select it and click Edit.

This variable tells Unreal Engine where the Linux Cross-Compile Toolchain is installed.

image-20260520-065756.png
Figure 11. Editing the LINUX_MULTIARCH_ROOT Environment Variable










Step 10. Select the Toolchain Installation Path

Browse to the toolchain installation directory.

Example path:

C:\UnrealToolchains\v26_clang-20.1.8-rockylinux8

Select the folder and click OK.

Make sure the selected path points to the correct installed toolchain folder.

image-20260520-065944.png
Figure 12. Selecting the Linux Cross-Compile Toolchain Directory










Step 11. Save the Environment Variable Changes

Click OK on all open windows to save the environment variable changes.

This will apply the updated LINUX_MULTIARCH_ROOT path.

image-20260520-070253.png
Figure 13. Saving the Environment Variable Configuration









Step 12. Restart the Machine

Restart your computer to make sure the environment variable changes are fully applied.

After restarting, Unreal Engine should be able to detect the Linux Cross-Compile Toolchain.

image-20260520-070358.png
Figure 14. Restarting the Machine to Apply Changes








Video Guidance

For a complete visual walkthrough, you can watch the video tutorial below.








Important Note

Make sure the Linux Cross-Compile Toolchain version matches your Unreal Engine version.

For example, if you are using Unreal Engine 5.7, download the toolchain supported for Unreal Engine 5.7.

Using the wrong toolchain version may cause packaging errors.




 


Need help?

If you need any assistance, feel free to reach out through any of the following channels:

🛠️ Support Portal: Contact Our Support Team

💬 Discord Community (Faster Support): Join Our Discord Community

📧 Email Support: support@eagle3dstreaming.com

 

🆓 Get Started for free

 

 

Follow us on:

Facebook | GitHub | LinkedIn | YouTube