Installation

Install Marnie

Choose your platform. All methods start the app on port 3000 - if that port is taken, Marnie automatically tries 3001, 3002, and so on.

Requirements

Before you install

-Node.js 24 or newer
-Git
-Curl

If you run into a UI problem after install, rebuild the app with npm run build.

Manual Install

Linux and macOS

1. Run the installer

bash <(curl -fsSL https://raw.githubusercontent.com/moyshik7/marnie/main/install.sh)

2. Open in browser

http://localhost:3000

Manual Install

macOS (Apple Silicon)

1. Run the installer

bash <(curl -fsSL https://raw.githubusercontent.com/moyshik7/marnie/main/install.sh)

2. Open in browser

http://localhost:3000

Manual Install

Windows (PowerShell)

1. Run in PowerShell - not Command Prompt

irm https://raw.githubusercontent.com/moyshik7/marnie/main/install.ps1 | iex

2. Open in browser

http://localhost:3000

DockerRecommended

Docker Compose

1. Clone the repository

git clone https://github.com/moyshik7/marnie.git
cd marnie

2. Start the container

docker compose up -d --build

Mounts persistent data in ./data and ./workspace. Points OLLAMA_BASE_URL to http://host.docker.internal:11434 so it can reach Ollama on your host machine.

3. Check logs or stop

docker compose logs -f
docker compose down

Docker

Docker CLI

1. Build the image

docker build -t marnie .

2. Run the container

docker run -d \
  --name marnie \
  -p 3000:3000 \
  --add-host=host.docker.internal:host-gateway \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/workspace:/app/workspace \
  marnie

Exposes the app on port 3000 and keeps data and workspace files in local folders.

API

API Documentation

Full API reference is available in the repository at docs/API.md. The API covers Chat, Brain, Notes, Expanded Capacity, Cron, Tasks, Alerts, and Settings endpoints.