Installation

中文原版 · ← Back to English home

Install and start the Markus platform on one machine — four options, pick whichever you like. Data is stored locally (SQLite); no external database needed.


1. Prerequisites

DependencyMin versionPurpose
Node.js22.0.0+Runtime (required for npm / source)
pnpm9.0.0+Package manager (source build)

2. Install (pick one)

Download the installer for your platform from GitHub Releases (e.g. Markus-Setup-*.exe) and double-click to install. The desktop app bundles the backend and frontend — no command line needed.

Option B — npm global install (CLI)

Requires Node.js 22+:

npm install -g @markus-global/cli

You get a markus command (see “Start” below).

Option C — Linux one-liner (no Node.js needed)

curl -fsSL https://markus.global/install.sh | bash

Installs the runtime and sets up the markus command automatically.

Option D — From source (development)

git clone https://github.com/markus-global/markus.git markus
cd markus
pnpm install      # install all workspace deps
pnpm build        # build all workspace packages

Dev ports: backend API :8056, frontend Vite Dev :8057 (pnpm dev, or run node packages/cli/dist/index.js start + pnpm --filter @markus/web-ui dev separately).


3. Start

markus start

Then open http://localhost:8056 in your browser; the onboarding wizard guides you through setup.

  • Default login: admin@markus.local / markus123
  • On first login, the onboarding wizard asks you to set your real name, email, and a new password (replacing the default credentials).

4. Configure LLM & Settings

Everything is configured visually in the Settings page of the Web UI — no config files or environment variables:

  • Models (LLM): add your provider and API key in Settings. Any LLM provider works (Anthropic / OpenAI / Google / DeepSeek / MiniMax / Ollama / SiliconFlow / Moonshot…).
  • Account & security: change passwords, invite members, manage permissions — all in Settings.
  • System parameters (ports, etc.) can also be adjusted in Settings.

5. Verify the Installation

markus start
# "API server listening on port 8056" means the backend is ready

Open http://localhost:8056, see the onboarding wizard, and log in successfully — installation complete.

Next: First Agent →