mirror of https://github.com/multica-ai/multica.git synced 2026-07-12 20:29:10 +02:00

Files

Jiayuan Zhang 576f20f2c7 refactor(cli): separate install from setup, redesign CLI configuration flow (#888 )

Decouple install.sh from environment configuration — install.sh now only
installs the CLI binary (and optionally Docker via --with-server), while
all environment configuration moves to `multica setup` subcommands.

Key changes:
- install.sh: remove config writes, rename --local to --with-server
- multica setup: add cloud/self-host subcommands with --server-url,
  --app-url, --port, --frontend-port flags and --profile support
- Add config overwrite protection with interactive prompt
- Remove redundant commands: `config local`, `auth login` alias
- Replace silent multica.ai fallbacks with explicit errors
- Onboarding wizard: dynamically show correct setup command for
  Cloud vs Self-host environments
- Update all docs, landing page, and install scripts for consistency

2026-04-13 22:32:10 +08:00

2.0 KiB

Raw Permalink Blame History

Self-Hosting Setup (for AI Agents)

This document is designed for AI agents to execute. Follow these steps exactly to deploy a local Multica instance and connect to it.

Prerequisites

Docker and Docker Compose installed
Homebrew installed (for CLI)
At least one AI agent CLI on PATH: claude or codex

Install

# Install CLI + provision self-host server
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server

# Configure CLI for localhost, authenticate, and start daemon
multica setup self-host

Wait for the server output ✓ Multica server is running and CLI is ready! before running multica setup self-host.

Expected result:

Frontend at http://localhost:3000
Backend at http://localhost:8080
multica CLI installed and configured for localhost

Alternative: Manual Setup

git clone https://github.com/multica-ai/multica.git
cd multica
make selfhost
brew install multica-ai/tap/multica
multica setup self-host

The multica setup self-host command will:

Configure CLI to connect to localhost:8080 / localhost:3000
Open a browser for login — use verification code 888888 with any email
Discover workspaces automatically
Start the daemon in the background

Verification

multica daemon status

Should show running with detected agents.

Stopping

# Stop the daemon
multica daemon stop

# Stop all Docker services
cd multica
make selfhost-stop

Custom Ports

If the default ports (8080/3000) are in use:

Edit .env and change PORT and FRONTEND_PORT
Run make selfhost
Run multica setup self-host --port <PORT> --frontend-port <FRONTEND_PORT>

Troubleshooting

Backend not ready: docker compose -f docker-compose.selfhost.yml logs backend
Frontend not ready: docker compose -f docker-compose.selfhost.yml logs frontend
Daemon issues: multica daemon logs
Health check: curl http://localhost:8080/health

2.0 KiB Raw Permalink Blame History