Installation
Moltis is distributed as a single self-contained binary. Choose the installation method that works best for your setup.
Quick Install (Recommended)
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
Cargo Binstall (Pre-built Binary)
If you have cargo-binstall installed:
cargo binstall moltis
This downloads a pre-built binary without compiling from source.
Linux Packages
Debian / Ubuntu (.deb)
# Download the latest .deb package
curl -LO https://github.com/moltis-org/moltis/releases/latest/download/moltis_amd64.deb
# Install
sudo dpkg -i moltis_amd64.deb
Fedora / RHEL (.rpm)
# Download the latest .rpm package
curl -LO https://github.com/moltis-org/moltis/releases/latest/download/moltis.x86_64.rpm
# Install
sudo rpm -i moltis.x86_64.rpm
Arch Linux (.pkg.tar.zst)
# Download the latest package
curl -LO https://github.com/moltis-org/moltis/releases/latest/download/moltis.pkg.tar.zst
# Install
sudo pacman -U moltis.pkg.tar.zst
Snap
sudo snap install moltis
AppImage
# Download
curl -LO https://github.com/moltis-org/moltis/releases/latest/download/moltis.AppImage
chmod +x moltis.AppImage
# Run
./moltis.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.75 or later
- A C compiler (for some dependencies)
Clone and Build
git clone https://github.com/moltis-org/moltis.git
cd moltis
cargo build --release
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:
- Open
http://localhost:<port>in your browser (the port is shown in the terminal output) - Configure your LLM provider (API key)
- Start chatting!
Moltis picks a random available port on first install to avoid conflicts. The port is saved in your config and reused on subsequent runs.
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
Cargo Binstall
cargo binstall moltis
From Source
cd moltis
git pull
cargo 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