morphyDocs

Morphy on Linux

Install Morphy on Linux as an AppImage or a .deb, sign in to your AIs from your own terminal, and where your files go.

Morphy runs on Linux too. It's the same app as on Windows, with a few Linux-specific differences, which this page covers. If something doesn't work, tell us in the Discord.

What you need

  • A 64-bit Intel or AMD PC (x86-64) with Ubuntu 20.04, Debian 11, Fedora 36 or newer, or another distribution of the same age. ARM computers aren't supported yet.
  • A desktop, like GNOME, KDE Plasma, Xfce or Cinnamon, on X11 or Wayland. Or WSL on Windows: see In WSL on Windows.
  • The same AI accounts as on Windows. See Connect your AI.

Install

There are two downloads. Pick one:

  • AppImage: one file that runs on any distribution and updates itself. Morphy-linux-x86_64.AppImage
  • .deb: for Ubuntu, Debian, Linux Mint and Pop!_OS. It installs like any other app and keeps Chromium's full sandbox on Ubuntu (see below). Morphy-linux-amd64.deb
  1. Make the file executable. In your file manager, open its Properties and turn on Allow executing file as program. Or run:

    chmod +x Morphy-linux-x86_64.AppImage
  2. Double-click it to open Morphy.

If nothing happens on Ubuntu 22.04 or newer, your system is missing FUSE 2, which AppImages need. Install it, then try again:

sudo apt install libfuse2t64   # Ubuntu 24.04 and newer
sudo apt install libfuse2      # Ubuntu 22.04

Then sign in with Google or GitHub and connect your AIs, the same as on Windows: see Install Morphy.

The AppImage and Ubuntu's sandbox setting

Ubuntu 23.10 and newer block a feature that Chromium's extra sandbox needs. AppImages, Morphy's included, then run without that sandbox. The .deb sets it up properly, so on Ubuntu we recommend the .deb.

In WSL on Windows

Morphy also runs in WSL, the Linux that comes with Windows. It needs WSLg, the part of WSL that shows Linux windows on your Windows desktop. On Windows, the Windows app is the simpler choice; use WSL when you want your agents working with your Linux files and tools.

Install the .deb as above, then:

  • Start Morphy with setsid, so it keeps running when you close the terminal:

    setsid morphy >/dev/null 2>&1 &

    Started with a plain morphy &, Morphy stops when that terminal closes and can leave a frozen white window behind. If that happens, run pkill -f /opt/Morphy and start it again.

  • Grey X's over the toolbar, the chat box or the minimap? WSL's graphics draw some see-through parts of Morphy wrong. Versions after 0.1.13 fix this by themselves. On 0.1.13, start Morphy like this:

    setsid morphy --disable-gpu-compositing >/dev/null 2>&1 &

Signing in to Grok, Copilot and Antigravity

Claude signs in in your browser, with no terminal window. These sign-ins open a terminal window, like on Windows. Morphy opens your desktop's own terminal (GNOME Terminal, Konsole, Xfce Terminal, Ptyxis and others). When the sign-in is done, the window says so and closes after a few seconds.

If Morphy can't find a terminal app, Settings → Account shows the command to run instead. Run it in any terminal; Morphy notices when you're signed in.

Command-line tools

Some AIs need a command-line tool: Codex, Grok, Copilot, Antigravity, OpenCode, Hermes Agent and Junie. Install them the way their makers describe for Linux, for example npm install -g @openai/codex or curl -fsSL https://opencode.ai/install | bash. Claude is built into Morphy.

When Morphy starts, it reads the same PATH your terminal has (bash, zsh or fish), so tools installed through nvm, npm or into ~/.local/bin are found. If you install one while Morphy is open, click Check again in Settings → Account.

The terminal in the dock opens your own login shell.

Blank pages when Morphy starts

When Morphy starts, it asks your desktop's keyring (KDE Wallet or GNOME Keyring) to unlock, to keep your sign-ins encrypted. Every app built on Chromium does this, like Chrome and VS Code. If the keyring is locked and its password window opened behind your other windows, Morphy waits for it and shows blank pages. Find that window (look in your taskbar) and type your password.

This happens most with automatic login, where nothing unlocks the keyring for you. To stop it:

  • Unlock the keyring when you log in. Your distribution's guide for KDE Wallet or GNOME Keyring explains how.
  • Or start Morphy without the keyring, with --password-store=basic: for example ./Morphy-linux-x86_64.AppImage --password-store=basic, or morphy --password-store=basic for the .deb. To keep it for the app menu, copy /usr/share/applications/morphy.desktop to ~/.local/share/applications/ and add the option to the end of its Exec= line. Morphy then keeps the sign-ins it stores in a file in ~/.config/Morphy that only your user can read, without the keyring's encryption.

Updates

  • AppImage: updates itself, like on Windows. New versions download in the background; Restart to update at the bottom of the sidebar replaces the file and opens the new one, or it happens the next time you quit Morphy.
  • .deb: Morphy tells you when a new version is out (Update available at the bottom of the sidebar). Click it, or Download in Settings → General, then install the new .deb the same way. Your canvases and chats stay.
  • NixOS, or another package manager: a Morphy installed in /nix/store doesn't look for updates; your package manager updates it. Packagers can turn the update check off anywhere by setting MORPHY_DISABLE_UPDATES=1.

Your files

Where these docs say %APPDATA%\Morphy, on Linux it's ~/.config/Morphy: your canvases, cards, chats, notes, skills and keys. The log file is ~/.config/Morphy/logs/morphy.log. See Your files.

Uninstall

  • AppImage: delete the file.
  • .deb: run sudo apt remove morphy.

Both keep ~/.config/Morphy, so a reinstall brings everything back. Delete that folder to remove it all.

On this page