Linux (x64)

Since Gorilla Software became an official technology partner of Embarcadero in 2025, and with the release of Delphi 12.3, Gorilla3D can be compiled for the Linux 64-Bit platform. The graphics backend on Linux is OpenGL via Mesa / GLX through an X11 display surface.

Wayland is currently not supported. Make sure your session runs an X11 compositor (or XWayland), otherwise the framework cannot create a GL context.

Prerequisites

To build and run Gorilla3D applications on Linux you need:

  • A native Linux x64 system or Windows Subsystem for Linux (WSL2) on Windows 10 / 11.
  • An X11 display server with proper input/event handling (Wayland is not supported).
  • Mesa with GLX, providing OpenGL 4.3+.
  • A GPU that exposes OpenGL 4.3 to the user-space driver (NVIDIA proprietary, AMDGPU + Mesa, Intel + Mesa).
  • FMXLinux by Embarcadero — required for FireMonkey on Linux.
  • PAServer (Platform Assistant) installed on the Linux machine and reachable from your Delphi IDE.
  • The SKIA4Delphi library (libsk4d.so) — modern FireMonkey applications require it.
  • Gorilla3D package paths registered in the IDE for the Linux64 target.

Setting up Linux / WSL2

Native Linux

We test against current Ubuntu LTS and Debian releases. Other distributions (Red Hat / Fedora, openSUSE, Arch) are expected to work as long as the package set below is satisfied — the package names and the package manager differ.

Install the X11 development headers and runtime:

sudo apt update
sudo apt install -y x11-apps libx11-dev libxext-dev libxrandr-dev libxi-dev libxcursor-dev libxfixes-dev

Install Mesa with up-to-date OpenGL support. On older Ubuntu releases the default Mesa is too old for OpenGL 4.3 — add the kisak-mesa PPA to upgrade:

sudo add-apt-repository ppa:kisak/kisak-mesa
sudo apt update
sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev mesa-utils

Verify the OpenGL version after installation:

glxinfo | grep "OpenGL version"

You should see something like OpenGL version string: 4.6 (Compatibility Profile) Mesa 24.x.x. If the version is below 4.3, the GPU driver, the Mesa version or the active GLX renderer is the bottleneck.

WSL2

WSL2 ships with a software renderer (d3d12) by default, which advertises only OpenGL 3.3 and is too slow for any non-trivial 3D content. Switch to the GPU exposed by your Windows host:

# Pick the physical GPU instead of the software adapter
export MESA_D3D12_DEFAULT_ADAPTER_NAME=NVIDIA   # or "AMD", "Intel"

Make this permanent by adding it to your ~/.bashrc / ~/.profile. Inside Gorilla3D you can also set this from Pascal code before context creation:

uses
  Gorilla.Context.Linux;

begin
  TGorillaContextLinux.AUTO_SELECT_GPU := 'NVIDIA';
  Application.Initialize;
  // ...
end.

After switching the adapter, run glxinfo | grep "OpenGL version" again — the version must be 4.3 or higher.

Embarcadero FMXLinux

FireMonkey on Linux requires Embarcadero's FMXLinux library. It is distributed via GetIt:

  1. Download the FMXLinux zip from your Embarcadero account.
  2. In the IDE open Tools > GetIt Package Manager.
  3. Click Load Local Package and select the FMXLinux zip.
  4. Restart the IDE after installation.

Without FMXLinux the Linux64 platform will be available, but FireMonkey forms cannot be created and Gorilla3D will not link.

SKIA4Delphi

Modern FireMonkey applications use SKIA4Delphi as their 2D graphics renderer. Install the library and deploy libsk4d.so next to your binary on the Linux target:

  1. Get the latest release from the official SKIA4Delphi GitHub releases.
  2. Pick the linux-x64 archive and extract libsk4d.so.
  3. Add the .so as a deployment file for the Linux64 / Release configuration so PAServer copies it next to your executable. Alternatively install it system-wide into /usr/local/lib/ and run sudo ldconfig.

PAServer

PAServer is the Embarcadero Platform Assistant — the IDE talks to it over TCP to push binaries, debug and run on the target.

  1. Copy PAServer-XX.X.tar.gz from your Delphi installation (PAServer/) to the Linux machine.

  2. Extract and start it:

    tar xzf PAServer-XX.X.tar.gz
    cd PAServer-XX.X
    ./paserver
  3. In the IDE go to Tools > Options > Deployment > Connection Profile Manager and create a new profile pointing at the Linux host and the password printed by PAServer.

Building & Deploying

  1. Add Linux 64-Bit as a target platform in your project.
  2. Select your PAServer connection profile and the matching SDK (auto-imported on first connect).
  3. Add deployment entries for libsk4d.so, your assets, and any third-party .so files you depend on.
  4. Build in Release for production — Debug builds are useful for stepping through code via PAServer.

Verified Feature Matrix

Linux support is brand new with this release. We have a working build pipeline through WSL2 with the kisak-mesa PPA, but a complete feature pass is still pending. The matrix below intentionally lists most entries as ❓ — the value will be filled in as the test suite progresses.

Legend: ✅ working — ❓ partially / not verified — ❌ not working / known issue

Feature Linux x64 (WSL / native)
FMX Primitives ❓
FMX MaterialSources ❓
Gorilla3D Primitives ❓
Gorilla3D Model ❓
Gorilla3D Model — STATIC ❓
Gorilla3D Model — Uncached / Cached Animations ❓
Gorilla3D Model — Instancing ❓
Texture formats other than BGRA ❓
Default Materials (Lambert, Phong, BlinnPhong) ❓
Sharing a G3D material with multiple objects ❓
Cross-Material (FMX ↔ G3D) ❓
Pure Color / VertexColor material ❓
POM material ❓
PBR material ❓
Atlas / SplatMap material ❓
Layered materials ❓
Layer3D / Layout3D / TextLayer3D ❓
Material Behaviours — fragment & vertex shaders ❓
Depth / Blur / EmissiveBlur ❓
Global Illumination ❓
WBOIT rendering ❓
Composite rendering ❓
OutputLayers ❓
Skybox (Procedural / Blank / CubeMap) ❓
Reflection / Refraction render pass ❓
Environment mapping ❓
MSAA / FXAA ❓
PostFX (with concat) ❓
User shader via VertexShader / SurfaceShader ❓
Water surface material ❓
Particle system — untextured / textured ❓
Volume rendering ❓

If you run into specific feature failures on Linux, please file a report — Linux is the platform where community feedback shortens validation cycles the most.

Troubleshooting

  • XDG_RUNTIME_DIR not set — usually appears in fresh shells / over SSH. Either restart the desktop session or set export XDG_RUNTIME_DIR=/run/user/$(id -u) before launching.
  • GLX: OpenGL 4.3 not supported — verify the active driver with glxinfo | grep "OpenGL renderer". On WSL2 set MESA_D3D12_DEFAULT_ADAPTER_NAME (see above). On native Linux make sure the proprietary NVIDIA driver (or mesa-vulkan-drivers + GLX) is installed.
  • Application starts but no window appears — Wayland session detected. Force XWayland (export GDK_BACKEND=x11) or log in to an X11 session.
  • libsk4d.so: cannot open shared object file — deploy libsk4d.so next to the executable or install it system-wide and run sudo ldconfig.
  • Diagnose missing dependencies — ldd ./MyApp shows unresolved shared libraries; strace -e openat ./MyApp shows where the loader is searching.

For a deeper introduction to Linux deployment with Delphi, see Embarcadero's Linux Application Development documentation.

Solving Issue Example

Check if all necessary libraries used by your application are available:

ldd /mnt/c/Temp/G3DDemo/G3DLinuxDemo A classic runtime error 217 might occur, if anything is not correctly installed. You can run a check on your application with “strace”.

If you have not installed STRACE yet, run:

sudo apt-get install strace Execute with stract for detailed output about the system flow:

strace /mnt/c/Temp/G3DDemo/G3DLinuxDemo

Next Steps