siamakerlab/vibe-coder-server repository overview

⁠Vibe Coder Server

Self-hosted AI development server for a single-user LAN workflow. It runs Claude Code, Codex, OpenCode/GLM, Gradle, Flutter, Git, MCP tooling, project consoles, build logs, and the browser admin UI from Docker.

⁠Images

• Repository: siamakerlab/vibe-coder-server
• Current tags: 1.162.5, latest
• Architectures: linux/amd64, linux/arm64
• Apple Silicon/M-series Mac support: supported through the native linux/arm64 image. Use the same compose file; Docker pulls the matching architecture automatically.
• Database sidecar: postgres:17-alpine

⁠Quick Start

mkdir -p ~/vibe-coder && cd ~/vibe-coder

curl -fsSL https://raw.githubusercontent.com/siamakerlab/vibe-coder-server/main/docker/compose.yml -o compose.yml
curl -fsSL https://raw.githubusercontent.com/siamakerlab/vibe-coder-server/main/docker/.env.example -o .env

# Required: set VIBECODER_DB_PASSWORD in .env.
# Optional: set PUID/PGID, VIBE_PORT, JAVA_OPTS, memory limits.
${EDITOR:-nano} .env

docker compose up -d

Open http://<host-ip>:17880/setup, create the first admin user, then use Build Environment to install/update the SDKs and CLI tools you need. Persistent data lives under ./vibe-coder-data/, so docker compose pull && docker compose up -d --force-recreate preserves projects, PostgreSQL data, SDKs, Gradle cache, MCP packages, SSH keys, and Claude/Codex/OpenCode config.

⁠Install Notes for Apple Silicon Macs

No special image tag is required on M1/M2/M3/M4 Macs:

docker pull siamakerlab/vibe-coder-server:latest
docker image inspect siamakerlab/vibe-coder-server:latest --format '{{.Architecture}}'

The architecture should be arm64 on Apple Silicon. If you pin versions, use siamakerlab/vibe-coder-server:1.162.5 or newer.

⁠Main Capabilities

• Project-scoped TUI consoles for Claude, Codex, and OpenCode/GLM.
• Kotlin, Flutter, and iPhone project-type separation with platform-specific tooling profiles.
• Gradle and Flutter Android build pipelines with live logs and artifact downloads.
• iPhone/macOS preflight and macOS agent configuration groundwork.
• MCP catalog, prompt templates, prompt automation, scheduled prompts, history search, usage views, audit log, backups, PWA, and browser-only operation.
• Resource guard for AI/build child processes and Docker cgroup memory limits.

⁠Configuration Highlights

Important .env values:

• VIBECODER_IMAGE=siamakerlab/vibe-coder-server:latest
• VIBECODER_DB_PASSWORD=<required>
• VIBE_PORT=17880
• VIBE_DATA_ROOT=./vibe-coder-data
• JAVA_OPTS=-Xmx2g -XX:+UseG1GC -Dfile.encoding=UTF-8
• VIBECODER_SERVER_MEMORY_LIMIT=8g
• VIBECODER_RESOURCE_MEMORY_SOFT_PERCENT=88
• VIBECODER_RESOURCE_MEMORY_HARD_PERCENT=96
• VIBECODER_IOS_AGENT_ENABLED=false
• VIBECODER_IOS_AGENT_MODE=local|ssh

⁠Links

• Source: https://github.com/siamakerlab/vibe-coder-server⁠
• Docker install guide: https://github.com/siamakerlab/vibe-coder-server/blob/main/docker/README.md⁠
• Changelog: https://github.com/siamakerlab/vibe-coder-server/blob/main/CHANGELOG.md⁠
• License: AGPL-3.0