mirror of
https://github.com/multica-ai/multica.git
synced 2026-07-16 06:39:01 +02:00
576f20f2c7
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
77 lines
2.0 KiB
Markdown
77 lines
2.0 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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:
|
|
1. Configure CLI to connect to localhost:8080 / localhost:3000
|
|
2. Open a browser for login — use verification code `888888` with any email
|
|
3. Discover workspaces automatically
|
|
4. Start the daemon in the background
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
multica daemon status
|
|
```
|
|
|
|
Should show `running` with detected agents.
|
|
|
|
## Stopping
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
1. Edit `.env` and change `PORT` and `FRONTEND_PORT`
|
|
2. Run `make selfhost`
|
|
3. 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`
|