Installation
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
| Dependency | Min version | Purpose |
|---|---|---|
| Node.js | 22.0.0+ | Runtime (required for npm / source) |
| pnpm | 9.0.0+ | Package manager (source build) |
2. Install (pick one)
Option A — Desktop app (recommended, macOS / Windows / Linux)
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 runnode packages/cli/dist/index.js start+pnpm --filter @markus/web-ui devseparately).
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 →