This directory contains templates for deploying Moltis on a VPS or bare-metal server.
| File | Purpose |
|---|---|
docker-compose.yml |
Docker Compose for VPS deployment |
moltis.service |
systemd unit file for bare-metal installs |
moltis-podman.conf |
systemd override for rootless Podman |
moltis-podman-api.service |
Optional host socket service for sandbox passthrough |
cd deploy
export MOLTIS_PASSWORD="your-secure-password"
docker compose up -dOpen https://<your-server-ip>:13131 and configure your LLM provider.
# Create user and directories. /var/lib/moltis is also its Podman-compatible home.
sudo useradd -r -m -d /var/lib/moltis -s /usr/sbin/nologin moltis
sudo mkdir -p /etc/moltis
sudo chown moltis:moltis /var/lib/moltis /etc/moltis
# Install the binary
sudo cp moltis /usr/local/bin/moltis
# Install the service
sudo cp deploy/moltis.service /etc/systemd/system/The default unit retains systemd privilege and home-directory hardening. If Moltis uses rootless Podman, install the required override before starting it:
sudo mkdir -p /etc/systemd/system/moltis.service.d
sudo cp deploy/moltis-podman.conf /etc/systemd/system/moltis.service.d/podman.conf
# Assign an unused subordinate ID range if moltis has none in /etc/subuid and /etc/subgid.
# sudo usermod --add-subuids 200000-265535 --add-subgids 200000-265535 moltisIf allow_host_podman = true, also install and enable the API service before
Moltis. It creates the socket at the path configured by the drop-in:
sudo cp deploy/moltis-podman-api.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now moltis-podman-api.serviceThen start the service:
sudo systemctl daemon-reload
sudo systemctl enable --now moltisSee docs.moltis.org/deploy-vps for a complete walkthrough.