[Bug]: AppImage not working on Ubuntu 24.04 LTS

[BlueriteSoul]

Quick Check ✨

• I've taken a look at existing issues and discussions
• I've checked the hardware requirements in the docs
• This issue relates to GAIA UI (Open-WebUI)

Which version of GAIA are you using?

0.17.2

Details to help us reproduce the issue

Steps to reproduce

Download and run AppImage:

chmod +x gaia-agent-ui-.AppImage
./gaia-agent-ui-.AppImage --disable-gpu

Observe backend startup:

Starting GAIA Agent UI on http://localhost:4200
Open your browser to http://localhost:4200
App attempts to load embedded UI (Chromium/Electron shell)

UI does not appear / crashes with errors like:

qt.qpa.plugin: Could not find the Qt platform plugin "wayland"
ERROR: ui/gfx/x/connection.cc: Cannot send request of length ...
[appimagelauncher] child exited with code 5

API endpoint returns:

{
"message": "GAIA Agent UI API is running. Frontend not built yet.",
"hint": "Run 'npm run build' in src/gaia/apps/webui/ to build the frontend."
}

My CPU: https://www.amd.com/en/products/processors/laptop/ryzen/200-series/amd-ryzen-7-260.html

What actually happened?

Actual behavior
Backend starts correctly
Web UI is not built or not bundled
Electron/Chromium wrapper fails to render UI
AppImage behaves like a dev backend rather than a packaged application
User is forced to manually open http://localhost:4200

What did you expect to happen?

Expected behavior

The AppImage should:

Launch a working desktop UI out-of-the-box
Not require manual frontend build steps
Not depend on external Node.js build steps or source tree structure
Fall back gracefully to browser mode if embedded UI fails

How did you install GAIA?

Installer

Which mode are you running?

None

What's your CPU?

Other (please specify in comments)

What about your GPU setup?

Integrated GPU (iGPU) only

AMD GPU Driver Version

DRM 3.64, 6.19.11-arch1-1, Mesa 26.0.4-arch1.1, radeonsi, ACO

NPU Driver Version

No response

Lemonade Version (if applicable)

No response

What's your operating system?

Arch Linux (fully updated)

[BlueriteSoul]

This appears consistent with GAIA 0.17.2 Linux packaging behavior reported in Phoronix review (frontend not bundled, requires manual build). - https://www.phoronix.com/news/AMD-GAIA-True-Desktop-App

[itomek]

@BlueriteSoul currently GAIA has been tested on Ubuntu 24.04, macOS 26.4 and Windows 11. Although Arch Linux is not currently on the roadmap, we would welcome a tested contribution for supporting it. I'm going to close the issue for now.

[BlueriteSoul]

I installed Ubuntu 24.04 LTS (fully updated) to see if the experience is any better.
Problem #-1
I suppose this is not possible to fix at GAIA level, at least first half of the issue. To get the .AppImage to work, it needs libfuse2t64. Unfortunately, I believe this is a know .AppImage issue and can't be fixed by GAIA team (or can it?). Further, in order for GAIA to run, it needs to be launched with --no-sandbox argument. As the point of the packaging is to make it available to non-programmers, this is disappointing, but it feels like something that can be fixed by GAIA team.
Problem #0
While I understand that LTS versions are commonly understood as "stable", they come with unexpected challenges. E.g. To generate list of my HW/SW for a bug report, tool fastfetch is only available on Ubuntu 25.04 and later.
Problem #1
GAIA depends on curl (not present in Ubuntu 24.04 LTS)

\u2500\u2500\u2500\u2500 backend-installer opened (2026-04-19T06:50:41.573Z) \u2500\u2500\u2500\u2500
platform=linux arch=x64 node=v24.14.0
Running pre-checks...
Disk: ok (free=89102589952, required=5368709120)
[19915:0419/075041.676416:ERROR:dbus/object_proxy.cc:573] Failed to call method: org.freedesktop.systemd1.Manager.StartTransientUnit: object_path= /org/freedesktop/systemd1: org.freedesktop.systemd1.UnitExists: Unit app-org.chromium.Chromium-19915.scope was already loaded or has a fragment file.
Network: ok 
GAIA backend not found \u2014 installing from scratch
================================================
  Installing GAIA backend
================================================
Package: amd-gaia[ui]==0.17.2
Location: ~/.gaia/venv
state: installing (ensure-uv)
Installing uv...
$ bash -c curl -LsSf https://astral.sh/uv/install.sh | sh
  [uv-install] bash: line 1: curl: command not found
  exit code: 0
Added /home/bluebuntu/.local/bin to PATH for this process
Added /home/bluebuntu/.cargo/bin to PATH for this process
state: failed (ensure-uv)
[install-progress] window closed at stage=ensure-uv percent=2
[main] will-quit: performing async cleanup...
[main] Backend bootstrap failed: uv installed but not found on PATH. A shell restart may be required.
[main] Cleanup complete, quitting...

Problem #2
When I try to run this with --no-sandbox and curl, I get this:

# Fatal error in , line 0
# Invoke in DisallowJavascriptExecutionScope
#
#
#
#FailureMessage Object: 0x7ffc77f46630
----- Native stack trace -----```
I have limited understanding of what this means, but it seems to be the same issue I was facing on my Arch machine.
Problem #2
When I try to run this with curl and --no-sandbox and --disable-gpu, I get this:
```./gaia-agent-ui-0.17.2-x86_64.AppImage --no-sandbox -disable-gpu
[main] GAIA backend already at 0.17.2 \u2014 skipping bootstrap UI
state: ready
Starting backend: /home/bluebuntu/.gaia/venv/bin/gaia chat --ui --ui-port 4200
[main] Initializing services...
[agent-mgr] No agent manifest found \u2014 starting with empty manifest
[tray] System tray icon created
[main] Services initialized
[auto-updater] info Auto-updater initialized; first check in 10000ms
Loading app from: /tmp/.mount_gaia-aORaEL3/resources/dist/index.html
[24132:0419/081213.913379:ERROR:dbus/object_proxy.cc:573] Failed to call method: org.freedesktop.systemd1.Manager.StartTransientUnit: object_path= /org/freedesktop/systemd1: org.freedesktop.systemd1.UnitExists: Unit app-org.chromium.Chromium-24132.scope was already loaded or has a fragment file.
[backend] [2026-04-19 08:12:13] | INFO | gaia.cli._launch_agent_ui | cli.py:715 | Starting GAIA Agent UI on http://localhost:4200
[backend] Starting GAIA Agent UI on http://localhost:4200
   Open your browser to http://localhost:4200
   Press Ctrl+C to stop

   Prerequisites:
     1. Models downloaded  : gaia init --profile chat  (first time only, ~25 GB)
     2. Lemonade running   : lemonade-server serve

[2026-04-19 08:12:13] | INFO | gaia.ui.database.__init__ | database.py:103 | Chat database initialized: /home/bluebuntu/.gaia/chat/gaia_chat.db
[2026-04-19 08:12:13] | INFO | gaia.ui.server.create_app | server.py:412 | No frontend build found at /home/bluebuntu/.gaia/venv/lib/python3.12/site-packages/gaia/apps/webui/dist. Run 'npm run build' in the webui directory.
[2026-04-19 08:12:13] | INFO | gaia.agents.registry.discover | registry.py:105 | registry: Starting agent discovery
[2026-04-19 08:12:13] | INFO | gaia.agents.registry._register_builtin_agents | registry.py:169 | registry: Registered built-in agent: chat (ChatAgent)
[2026-04-19 08:12:13] | INFO | gaia.agents.registry._register_builtin_agents | registry.py:198 | registry: Registered built-in agent: builder (BuilderAgent)
[2026-04-19 08:12:13] | INFO | gaia.agents.registry.discover | registry.py:127 | registry: No custom agent directory found at /home/bluebuntu/.gaia/agents
[2026-04-19 08:12:13] | INFO | gaia.agents.registry.discover | registry.py:130 | registry: Agent discovery complete. 2 agents registered: ['chat', 'builder']
[2026-04-19 08:12:13] | INFO | gaia.ui.server.lifespan | server.py:170 | server: Agent registry initialized with 2 agents: ['chat', 'builder']
[2026-04-19 08:12:13] | INFO | gaia.ui.document_monitor.start | document_monitor.py:94 | Document monitor started (interval=30s)
[2026-04-19 08:12:13] | INFO | gaia.ui.server.lifespan | server.py:262 | Document file monitor started (30s polling interval)
[2026-04-19 08:12:13] | INFO | gaia.ui.document_monitor.stop | document_monitor.py:104 | Document monitor stopped (checked 0 times, re-indexed 0 docs)
[2026-04-19 08:12:13] | INFO | gaia.ui.server.lifespan | server.py:269 | Document file monitor stopped
[2026-04-19 08:12:13] | INFO | gaia.ui.server.lifespan | server.py:271 | Database connection closed
[2026-04-19 08:12:13] | INFO | gaia.ui.dispatch._run | dispatch.py:166 | Boot init: Loading ML libraries \u2192 running (0.0s)
[2026-04-19 08:12:13] | INFO | gaia.ui.dispatch._run | dispatch.py:166 | Boot init: Loading AI model \u2192 pending (0.0s)
[2026-04-19 08:12:13] | INFO | gaia.ui.dispatch._run | dispatch.py:166 | Boot init: Checking LLM server \u2192 running (0.0s)
[backend] INFO:     Started server process [24177]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
ERROR:    [Errno 98] error while attempting to bind on address ('127.0.0.1', 4200): address already in use
INFO:     Waiting for application shutdown.
INFO:     Application shutdown complete.
Backend exited with code 1
[auto-updater] info Checking for updates...
[auto-updater] info Checking for update
[auto-updater] info Generated new staging user ID: 30782fcd-463b-5a8b-8f80-dcff53621f27
[auto-updater] info Update for version 0.17.2 is not available (latest version: 0.17.2, downgrade is disallowed).
[auto-updater] info No update available (current 0.17.2)

I can go to my browser, to http://localhost:4200/, but I get exactly JSON:

{"message":"GAIA Agent UI API is running. Frontend not built yet.","hint":"Run 'npm run build' in src/gaia/apps/webui/ to build the frontend."}

This is what I encountered trying to run this on supported OS. The experience seems to be worse, because on my daily driver I am set up to run AppImages and I also have common tools like curl, that are missing from Ubuntu 24.04 LTS. Ultimately, I ran into the very same problem as I ran into on my Arch setup. This is unsurprising, as .AppImage is supposed to be distro agnostic.

Can this please be looked at?

[BlueriteSoul]

Also, I decided to try to generate the front-end, but I can't find src/gaia/apps/webui/, so I'm unable to replicate the workaround mentioned on Phoronix. Could the workaround please be at least documented, if the packaging doesn't work as intended?