# Linux install

Source: https://nodedocs.mor.org/consumers/install/linux

The Linux release is a single **AppImage**. On first launch, the app downloads and manages its own services — proxy-router, `llama.cpp` AI runtime with the `tinyllama` demo model, and an IPFS node. For a source-build walk-through, see [macOS install (from source)](/consumers/install/macos) — the steps are nearly identical on Linux.

## Steps

<Steps>
  <Step title="Download">
    Grab the **latest** AppImage from [Releases](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/releases). The asset is named like `linux-x86_64-morpheus-app-<version>.AppImage` (use `linux-arm64-...` on ARM64, e.g. Raspberry Pi). Mainnet builds have no suffix; testnet builds end in `-test`.
  </Step>
  <Step title="Make executable and launch">
    Adjust the filename to the version you downloaded:
    ```bash
    chmod +x linux-x86_64-morpheus-app-*.AppImage
    ./linux-x86_64-morpheus-app-*.AppImage
    ```
  </Step>
  <Step title="Let the app fetch its services">
    The first launch (and the first after each update) shows a **Starting services** screen: the app downloads the proxy-router, AI runtime, demo model, and IPFS node, then starts and probes each one. **Container Runtime** (Docker) is only detected, never installed — it is needed only for containerized agent features. Click **Skip** to continue without it; **Retry** re-runs failed steps.
  </Step>
  <Step title="Onboard">
    Accept terms, set a UI password, create or recover a wallet. Save the mnemonic somewhere safe.
  </Step>
  <Step title="Validate">
    Open `http://localhost:8082/swagger/index.html`. Use **Local Model** in Chat to verify the pipeline.
  </Step>
</Steps>

## Cleanup

<Warning>
**Save your wallet mnemonic / private key first.** This deletes the local key store along with the downloaded services.
</Warning>

```bash
rm -rf ~/.config/morpheus-app
# Older builds may have used:
rm -rf ~/.config/MorpheusUI
```

(`morpheus-app` is the Electron package / `userData` folder name; the product name in the UI is **MorpheusUI**.)

See also: [Troubleshooting](/reference/troubleshooting).