mirror of https://github.com/multica-ai/multica.git synced 2026-06-17 03:38:32 +02:00

Files

devv-eve 9ed1fa95fc feat(server): add readiness health endpoints (#1605 )

* feat(server): add readiness health endpoints

* fix(server): cache readiness checks

* fix(server): raise readiness cache ttl

---------

Co-authored-by: Eve <eve@multica.ai>

2026-04-24 13:50:24 +08:00

2.1 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 checks: curl http://localhost:8080/health for liveness, curl http://localhost:8080/readyz for dependency-aware readiness

2.1 KiB Raw Permalink Blame History