Running On Linux

From Epic Wiki
Jump to: navigation, search

Template:Rating Once you have successfully compiled the Editor in Linux, this page will provide you with additional information on running it. The main page is Linux support.

Open Source (Mesa) Drivers

If you use Mesa drivers use at least version >= 10.4.x . Better use newer ones.

Ubuntu 14.04.1/2 LTS

The standard Mesa drivers in Ubuntu 14.04.1/2 LTS has the version 10.1.3 and will not be sufficient for UE4Editor. You can use the Oibaf ppa which updates your mesa drivers almost everyday to the newest version. Read Oibaf PPA for more information. In the following are the steps how to use Oibaf to get the newest and "Up to Date" Mesa drivers.

  1. sudo apt-add-repository ppa:oibaf/graphics-drivers
  2. sudo apt-get update
  3. sudo apt-get dist-upgrade

Restart your system just in case.


The Mesa drivers come in a set of packages named "mesa-"; so e.g. from a terminal,

 rpm -qa | grep ^mesa-

… yields the version numbers currently installed.

These are typically updated with the rest of the system, and as of Fedora 21 in Feb 2014, are version 10.4 (note that mesa-libGLU uses its own version numbering scheme). The lower-level drivers are in mesa-dri-drivers.

From the desktop (in a Terminal) you can run

 pkcon update mesa-dri-drivers

(which uses the Gnome authentication; you usually must be an administrator, i.e. a member of group "wheel") Or on current Fedora

 sudo dnf upgrade mesa-dri-drivers

On Fedora 19 or 20 perhaps

 sudo yum upgrade mesa-dri-drivers

(Again, just running Software Update will normally do this along with every other package)

You could also use a program like "yumex" in the GUI to explore the package system. (The default "Software" program doesn't provide visibility to system libraries like this.)

Newer releases go to the Testing repository before going to Updates, which is normally disabled, but you can activate it for one transaction with a line like

 sudo dnf --enablerepo=updates-testing upgrade mesa-dri-drivers

(or the same using Yum on ƒ20)

NB "dnf update" will do approximately the same thing as "dnf upgrade," but is more conservative about removing old packages and such.


sudo pacman -S mesa

If you are still experiencing crashes on Static Mesh generation or going through CacheOptimizeIndexBuffer function, see the following Answer Hub page for a possible resolution:

Nvidia drivers

You should get the newest drivers for Nvidia based gfx cards. Don't use the 331.x drivers because they might cause problems.

Ubuntu 16.04 / KDE Neon

  1. sudo add-apt-repository ppa:graphics-drivers/ppa
  2. sudo apt-get update
  3. sudo apt-get install <package name>

Ubuntu 14.04.1/2 LTS

  1. sudo add-apt-repository ppa:graphics-drivers/ppa
  2. sudo apt-get update
  3. sudo apt-get install <package name>

<package name> can be like nvidia-370. Check the list which drivers are supported. See here [1] for more information.

"Building static mesh...", various malloc crashes, and mangled gizmo (XYZ axes)

As reported here:

Generally this happens with Mesa drivers.

Edit ConsoleVariables.ini and add r.TriangleOrderOptimization=2, if there's no such parameter, else change the value to 2 if the parameter is already there.

Font Corruption

As outlined in the following Answer Hub reports:

Font Corruption Linux.png

If you are experiencing screen/font corruption that looks like the image above, please update your graphics drivers.

OpenGL versions

If you have a graphics card and drivers that supports at least OpenGL 4.3 you can start the editor with the -opengl4 flag which will start the editor in OpenGL4 mode. This mode causes some issues in the editor's viewport, though. Here are some hints to make it work:

  1. Set the Anti-Alias level to "Medium"
  2. Switch off the Reflection Environment (r.ReflectionEnvironment=0) while using Reflection cubes or spheres (Sometimes necessary).

Nvidia Optimus

If you're running on an computer with Nvidia Optimus (Intel and Nvidia on a laptop), run the Editor through optirun or primusrun, otherwise you will run into OpenGL context issues and the editor will not run.


If your lighting is failing or stuck at 0%, make sure that your firewall is not blocking port 6666 and/or network. It uses those for multicast operation, and is safe to open/enable in your firewall.

 sudo iptables -A INPUT -p UDP -d --destination-port 6666 -j ACCEPT

Of if you have Ubuntu and/or Uncomplicated firewall (ufw) you can run this command.

 sudo ufw allow to port 6666 proto udp


Multi Desktop not supported

Do not try to use UE4Editor on separate "virtual" desktops. That means if you try for example to put a Blueprint, Matinee or the Cascade Editor window etc. into another virtual desktop, it will not work. You can use UE4Editor on multiple monitors.

Pan, Orbit, Zoom and Copy

The Unreal Editor supports Maya-style pan, orbit, and zoom viewport controls. Unfortunately it's using the ALT key on Windows which can be troublesome because that key is usually assigned to do other stuff in the world of X11/WM. To get the same behaviour like on Window change the assignment of the ALT key in you Window Manager.


Go to Settings menu, select Window Manager Tweaks and select the Accessibility tab. Change the field: Key used to grab and move windows. Select one which does not use the ALT key.


Install Compiz Config Settings Manager (sudo apt-get install compizconfig-settings-manager in a terminal) and open it. Select "Window Management" and then the "Window Movement". Click on the button which is on the right side of the "Initiate Window Move" label. Select the "Enable" checkbox to disable or change it so that it does not conflict with other key combinations in UE4. Maybe "SHIFT" could be used.


Gnome 3 defaults to using the Super (Windows) key instead of Alt, which should work fine. If you need to change it, install Gnome Tweak Tool (sudo apt-get install gnome-tweak-tool) and open it. Select "Windows" on the left side, then change the "Window Action Key" setting.

Building C++ scripts from terminal

If you prefer working without an IDE, and the built-in compiler tool is not feeding back useful compiler errors, it's possible to invoke C++ script compilation from the terminal, and make using the toolset easier. Inspired by this forum post, below is a set of .bashrc functions which can be used to build, generate and launch C++ projects.

Add these to your ~/.bashrc: (Replacing the /opt/UnrealEngine with your own path)

   function unrealbuild {
            PROJ_NAME=$(basename ${1%.uproject});
            $UE_HOME/Engine/Build/BatchFiles/Linux/ $PROJ_NAME Linux Development -editorrecompile "${CURR_DIR}/${PROJ_NAME}.uproject" -progress -editor -game -NoHotReloadFromIDE
   complete -f -X '!*.@(uproject)' unrealbuild
   function unrealeditor {
       DIR="$( cd "$( dirname "$i" )" && pwd )"
       $UE_HOME/Engine/Binaries/Linux/UE4Editor $DIR/$1
   complete -f -X '!*.@(uproject)' unrealeditor
   function unrealgen {
       DIR="$( cd "$( dirname "$i" )" && pwd )"
       pushd $UE_HOME
       ./ -project="$DIR/$1" -game -engine -editor
   complete -f -X '!*.@(uproject)' unrealgen
   # For automation tests, if used
   function unrealtest {
       DIR="$( cd "$( dirname "$i" )" && pwd )"
           $UE_HOME/Engine/Binaries/Linux/UE4Editor $DIR/$1 -Game -ExecCmds="Automation RunTests $2" -log
   complete -f -X '!*.@(uproject)' unrealtest

Run it like this:

     cd /path/to/ProjectName
     unrealgen ProjectName.uproject
     unrealbuild ProjectName.uproject
     unrealeditor ProjectName.uproject

Source Code Accessors

If you get a message: Unable to create C++ template based projects because "an IDE is not installed", it means you did not setup a code acessor

To use a specific IDE SourceCodeAccessor see the list below.


Modify your Engine/Config/Linux/LinuxEngine.ini:


If you are using Unreal Engine 4.9 >= you don't have to clone the accessor because CodeLite is fully integrated.

 cd Engine/Plugins/Developer && git clone



  • Allow only a single instance to open the editor
 Select YourProjectName Target.
 Right click -> Settings -> Preferences -> Misc -> Allow only single instance running  
  • Change the default run to launch the game with the editor (like in VisualStudio)
 Select YourProjectName Target.
 Right click -> Settings -> General
 In the Execution section, remove the -game from the Program Arguments


Modify your Engine/Config/Linux/LinuxEngine.ini:


If you are running an engine version that does not have this code accessor built in, run:

 cd Engine/Plugins/Developer && git clone

Some official documentation on how to setup Qt Creator can be found at How to Set up Qt Creator for UE4


  • Additionally, you may wish to watch this video (NOTE fairly outdated) UE4Editor/UProject inside Qt Creator debugger, which shows you how to create a kit in Qt Creator capable of compiling your project for in-IDE debugging and editor debugging.


Modify your Engine/Config/Linux/LinuxEngine.ini:


For KDevelop there is a plugin that comes with the engine source code that is automatically built with UE4Editor.


Modify your Engine/Config/Linux/LinuxEngine.ini:


If you are running an engine version that does not have this code accessor built in, run:

 cd Engine/Plugins/Developer && git clone

Sublime Text

Modify your Engine/Config/Linux/LinuxEngine.ini:


If you are running an engine version that does not have this code accessor built in, run:

 cd Engine/Plugins/Developer && git clone

Eclipse CDT

Modify your Engine/Config/Linux/LinuxEngine.ini:


If you are running an engine version that does not have this code accessor built in, run:

 cd Engine/Plugins/Developer && git clone


<-- Back to the main Linux Support page.