Skip to main content

Quick Start

Get MoLOS up and running in just a few minutes. Choose your preferred installation method.

Install MoLOS​

The fastest way to get started - just one command:

/bin/bash -c "$(curl -fsSL https://molos.app/install.sh)"

That's it! MoLOS opens in your browser with everything set up automatically.

tip

The installer handles everything: Docker setup, secure authentication, and data storage.

After installation, you'll see your BETTER_AUTH_SECRET displayed and saved securely to ~/.molos/.env (permissions: 600). Your data is stored in ~/.molos/data on your filesystem. Keep this secret safe!

Alternative: Docker Compose​

Best for: Production use, persistent data, simple configuration

Generate a secure secret and create data directory:

mkdir -p ~/.molos/data ~/.molos/secrets
chmod 700 ~/.molos ~/.molos/data ~/.molos/secrets
SECRET=$(openssl rand -base64 32)
echo "BETTER_AUTH_SECRET=$SECRET" > ~/.molos/secrets/.env
chmod 600 ~/.molos/secrets/.env

Create a docker-compose.yml file:

services:
  molos:
    image: ghcr.io/molos-app/molos:latest
    ports:
      - '4173:4173'
    volumes:
      - ~/.molos/data:/data
    env_file:
      - ~/.molos/secrets/.env
    environment:
      - DATABASE_URL=file:/data/molos.db

Start it:

docker-compose up -d

Open http://localhost:4173 and you're ready!

Alternative: Docker​

Best for: Testing, exploration, quick spin-up

mkdir -p ~/.molos/data ~/.molos/secrets
chmod 700 ~/.molos ~/.molos/data ~/.molos/secrets
docker run -d \
  --name molos \
  -p 4173:4173 \
  -v ~/.molos/data:/data \
  --env-file ~/.molos/secrets/.env \
  -e DATABASE_URL=file:/data/molos.db \
  ghcr.io/molos-app/molos:latest

Open http://localhost:4173.

note

Data is stored in ~/.molos/data on your filesystem. Always create a ~/.molos/secrets/.env file with your secret first.

Last Updated: March 22, 2026