Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

Moltis is distributed as a single self-contained binary. Choose the installation method that works best for your setup.

The fastest way to get started on macOS or Linux:

curl -fsSL https://www.moltis.org/install.sh | sh

This downloads the latest release for your platform and installs it to ~/.local/bin.

Package Managers

Homebrew (macOS / Linux)

brew install moltis-org/tap/moltis

Linux Packages

Package filenames are versioned on every release. Use the installer script below instead of hardcoding GitHub release asset names.

Debian / Ubuntu (.deb)

# Install the latest .deb package
curl -fsSL https://www.moltis.org/install.sh | sh -s -- --method=deb

Fedora / RHEL (.rpm)

# Install the latest .rpm package
curl -fsSL https://www.moltis.org/install.sh | sh -s -- --method=rpm

Arch Linux (.pkg.tar.zst)

# Install the latest package
curl -fsSL https://www.moltis.org/install.sh | sh -s -- --method=arch

Snap

sudo snap install moltis

AppImage

# Install the latest AppImage
curl -fsSL https://www.moltis.org/install.sh | sh -s -- --method=appimage

Docker

Multi-architecture images (amd64/arm64) are published to GitHub Container Registry:

docker pull ghcr.io/moltis-org/moltis:latest

See Docker Deployment for full instructions on running Moltis in a container.

Build from Source

Prerequisites

  • Rust 1.91 or later
  • A C compiler (for some dependencies)
  • just (command runner)
  • Node.js (for building Tailwind CSS)

Clone and Build

git clone https://github.com/moltis-org/moltis.git
cd moltis
just build-css           # Build Tailwind CSS for the web UI
just build-release       # Build in release mode

For a full release build including WASM sandbox tools:

just build-release-with-wasm

The binary will be at target/release/moltis.

Install via Cargo

cargo install moltis --git https://github.com/moltis-org/moltis

First Run

After installation, start Moltis:

moltis

On first launch:

  1. Open http://localhost:<port> in your browser (the port is shown in the terminal output)
  2. Configure your LLM provider (API key)
  3. Start chatting!

Tip

Moltis picks a random available port on first install to avoid conflicts. The port is saved in your config and reused on subsequent runs.

Note

Authentication is only required when accessing Moltis from a non-localhost address (e.g., over the network). When this happens, a one-time setup code is printed to the terminal for initial authentication setup.

Verify Installation

moltis --version

Updating

Homebrew

brew upgrade moltis

From Source

cd moltis
git pull
just build-css
just build-release

Uninstalling

Homebrew

brew uninstall moltis

Remove Data

Moltis stores data in two directories:

# Configuration
rm -rf ~/.config/moltis

# Data (sessions, databases, memory)
rm -rf ~/.moltis

Warning

Removing these directories deletes all your conversations, memory, and settings permanently.