Skip to content

Installation

Choose your preferred installation method.

Docker is the fastest way to get started and recommended for production use.

git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
cp .env.example .env
# Generate AUTH_SECRET and add to .env
echo "AUTH_SECRET=$(openssl rand -base64 32)" >> .env
docker-compose up -d

Open http://localhost:5003 in your browser.

What Docker Sets Up

The container automatically:

  • Installs OpenCode 2 if not present (bundled 2.0.15; 2.x at 2.0.15 or newer required)
  • Builds and serves the frontend
  • Creates persistent volumes for the workspace, database, and OpenCode binary
  • Configures health checks and auto-restart

Docker Commands

# Start the container
docker-compose up -d

# Stop and remove containers (named volumes are preserved)
docker-compose down

# Stop and remove containers and all named volumes (workspace, database, OpenCode binary)
docker-compose down -v

# Rebuild the image
docker-compose build

# View logs
docker-compose logs -f

# Restart
docker-compose restart

# Access container shell
docker exec -it opencode-manager sh

Volumes

Volume Container Path Purpose
opencode-workspace /workspace Repository storage
opencode-data /app/data Database and config
opencode-bin /home/node/.opencode/bin OpenCode binary, persisted across container recreations

Local Development

For contributors who want to develop locally instead of using Docker.

Prerequisites

  • pnpm - Package manager (required for workspaces)
  • Bun - Backend runtime
  • OpenCode TUI 2.x, 2.0.15 or newer - curl -fsSL https://opencode.ai/v2/install | bash
  • Node.js 24+

Setup

# Clone the repository
git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager

# Install dependencies
pnpm install

# Copy environment configuration
cp .env.example .env

# Start development servers
pnpm dev

This starts:

  • Backend on http://localhost:5003
  • Frontend on http://localhost:5173 (with HMR)

Verifying Installation

After starting the application:

  1. Open your browser to the appropriate URL
  2. You should see the login page or setup wizard
  3. Check logs if you encounter issues: docker-compose logs -f

Next Steps