Ubuntu notes

Murage has an Ubuntu desktop beta for Ubuntu 24.04 LTS on 64-bit Intel and AMD computers (x86_64). The installed app includes everything it needs, so you don't need Node, pnpm or a terminal to run it.

Pick a package#

• Debian package (Murage-amd64.deb): recommended. APT installs its desktop dependencies for you.
• AppImage (Murage.AppImage): portable, doesn't install system files. It doesn't need the old libfuse2 package.

Both are on the releases page, with a checksum file, SHA256SUMS-ubuntu-x64.txt.

Check the download#

Ubuntu packages aren't signed like the Mac and Windows builds. They come with SHA-256 checksums instead. In the folder where you downloaded them:

sha256sum --check --ignore-missing SHA256SUMS-ubuntu-x64.txt

Each file you downloaded should say OK.

Install#

For the .deb, install it with APT so dependencies are handled:

sudo apt install ./Murage-amd64.deb

Then open Murage from the app launcher.

For the AppImage:

chmod +x Murage.AppImage
./Murage.AppImage

ARM computers aren't supported in this release.

Letting a bot use your screen: Xorg only#

A bot can control your Ubuntu desktop, but only on an Ubuntu on Xorg session. Ubuntu 24.04 starts a Wayland session by default, and on Wayland, screen control is switched off until its input checks pass.

To switch:

1. Sign out.
2. On the sign-in screen, choose your name, then the gear icon at the bottom right.
3. Pick Ubuntu on Xorg, and sign in.

Then turn on local control in Murage and choose This computer for the bot. Both are needed. Every action still goes through approvals, and a bot asks before it first touches your screen. On Linux, automatic approval never covers your own desktop.

A view-only screen preview works on both Xorg and Wayland. On Wayland, Ubuntu asks you which screen or window to share. Preview never gives a bot control.

What works on Ubuntu#

• Chat, teams, approvals, routines, memory and everything else in the main app.
• Engines such as Claude Code, Codex and others you install.
• Connected apps, and the Box cloud computer.
• The built-in browser (switch it on in Settings → Experimental).
• Local VM desktops with Docker or Podman.
• Calls. Murage hears you through Flux Router, or your own Groq or OpenAI key, about 1.5 to 3 seconds after you stop speaking.
• The local model for smart memory search.

What's not available on Ubuntu

• On-device dictation. Hold-to-talk dictation through Flux Router transcription is the alternative.
• Built-in system voices. Use Flux Router voices or your own voice key.
• Screen control on a Wayland session (use Xorg, above).

Updating the .deb

Murage never installs a system package itself, so it never asks for your password. When an update is ready it downloads and checks the package, copies the install command, and opens a terminal. Paste the command and press Enter, then reopen Murage. Use apt-get, not dpkg -i, so dependencies are handled. See Troubleshooting updates.

The AppImage tells you when an update is ready. Choose Download, then Restart to update when you're ready.

Where Murage keeps things

• Your data: ~/.murage.
• Browser data and window state: ~/.config/murage, unless your environment sets a different configuration folder.
• Your encrypted keys: protected by your desktop's secret storage.

Uninstall

sudo apt remove murage

For the AppImage, delete the file. Your data stays until you delete it. See Uninstall and reset.