Morphy on Linux (beta)

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

What you needCopy Anchor Link

• 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.
• The same AI accounts as on Windows. See Connect your AI.

InstallCopy Anchor Link

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

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

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

Signing in to Claude, Grok, Copilot and AntigravityCopy Anchor Link

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 toolsCopy Anchor Link

Some AIs need a command-line tool: Codex, Grok, Copilot and Antigravity. Install them the way their makers describe for Linux, for example npm install -g @openai/codex. 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.

UpdatesCopy Anchor Link

• AppImage: updates itself, like on Windows. New versions download in the background and replace the file the next time you quit Morphy.
• .deb: Morphy tells you when a new version is out. Click Download in Settings → General, then install the new .deb the same way. Your canvases and chats stay.

Your filesCopy Anchor Link

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.

UninstallCopy Anchor Link

• 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.