feat(docker): add docker support for opencode with litellm integration

- Create Dockerfile_litellm based on Ubuntu 24.04
  - Extract and install OpenCode from opencode-linux-x64.tar.gz
  - Add health check and non-root user for security
  - Expose port 3000 and set default start command

- Add Docker build workflow to ai-codespark-release.yml
  - Build and push images to GitHub Container Registry
  - Tag with version and latest
  - Depend on build-cli-linux job for artifacts
  - Enable GitHub Actions cache for faster builds

Images will be published to ghcr.io/ai-codespark/opencode on each release.

Author: craftslab

.github/workflows/ai-codespark-release.yml

@@ -263,3 +263,51 @@ jobs:
         with:
           name: opencode-vscode-extension
           path: sdks/vscode/opencode-vscode-extension.vsix
+
+  build-docker:
+    runs-on: ubuntu-latest
+    if: github.repository == 'ai-codespark/opencode'
+    needs: build-cli-linux
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - run: git fetch --force --tags
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.AI_CODESPARK_TOKEN }}
+
+      - name: Set version
+        run: |
+          VERSION="${{ github.event.release.tag_name }}"
+          VERSION="${VERSION#v}"
+          echo "RELEASE_VERSION=$VERSION" >> $GITHUB_ENV
+
+      - name: Download CLI artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: opencode-cli-linux-x64
+          path: .
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./Dockerfile_litellm
+          push: true
+          platforms: linux/amd64
+          build-args: |
+            OPENCODE_VERSION=${{ env.RELEASE_VERSION }}
+          tags: |
+            ghcr.io/${{ github.repository }}:${{ env.RELEASE_VERSION }}
+            ghcr.io/${{ github.repository }}:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

Dockerfile_litellm

@@ -0,0 +1,47 @@
+FROM ubuntu:24.04
+
+LABEL maintainer="AI CodeSpark <[email protected]>"
+LABEL description="OpenCode - AI-powered code intelligence platform running on Ubuntu"
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    wget \
+    ca-certificates \
+    unzip \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy the opencode-linux-x64 tarball
+ARG OPENCODE_VERSION
+COPY opencode-linux-x64.tar.gz /tmp/opencode-linux-x64.tar.gz
+
+# Extract and install OpenCode
+RUN mkdir -p /usr/local/opencode && \
+    tar -xzf /tmp/opencode-linux-x64.tar.gz -C /usr/local/opencode && \
+    rm /tmp/opencode-linux-x64.tar.gz && \
+    ln -s /usr/local/opencode/opencode /usr/local/bin/opencode && \
+    chmod +x /usr/local/opencode/opencode
+
+# Set environment variables
+ENV OPENCODE_VERSION=${OPENCODE_VERSION}
+ENV OPENCODE_CHANNEL=latest
+ENV PATH="/usr/local/opencode:${PATH}"
+
+# Create a non-root user for running OpenCode
+RUN useradd -m -s /bin/bash opencode && \
+    chown -R opencode:opencode /app
+
+USER opencode
+
+# Expose default port (if applicable)
+EXPOSE 3000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD opencode --version || exit 1
+
+# Default command
+CMD ["opencode", "start"]

README_litellm.md

@@ -23,6 +23,91 @@ export LITELLM_MODEL_NAME="gpt-4"
 
 Then run OpenCode. The model will be automatically available.
 
+## Running with Docker
+
+OpenCode is available as a Docker image for easy deployment on Ubuntu-based systems.
+
+### Pull and Run
+
+Pull the latest image from GitHub Container Registry:
+
+```bash
+docker pull ghcr.io/ai-codespark/opencode:latest
+```
+
+Run OpenCode with environment variables:
+
+```bash
+docker run -d \
+  --name opencode \
+  -p 3000:3000 \
+  -e LITELLM_BASE_URL="http://host.docker.internal:4000" \
+  -e LITELLM_API_KEY="sk-your-api-key" \
+  -e LITELLM_MODEL_NAME="gpt-4" \
+  ghcr.io/ai-codespark/opencode:latest
+```
+
+### Docker Compose
+
+Create a `docker-compose.yml` file:
+
+```yaml
+version: '3.8'
+
+services:
+  opencode:
+    image: ghcr.io/ai-codespark/opencode:latest
+    container_name: opencode
+    ports:
+      - "3000:3000"
+    environment:
+      - LITELLM_BASE_URL=http://litellm:4000
+      - LITELLM_API_KEY=${LITELLM_API_KEY}
+      - LITELLM_MODEL_NAME=gpt-4
+    depends_on:
+      - litellm
+    restart: unless-stopped
+
+  litellm:
+    image: ghcr.io/berriai/litellm:latest
+    container_name: litellm
+    ports:
+      - "4000:4000"
+    volumes:
+      - ./litellm-config.yaml:/app/config.yaml
+    command: --config /app/config.yaml
+    restart: unless-stopped
+```
+
+Then start both services:
+
+```bash
+docker-compose up -d
+```
+
+### Volume Mounting for Configuration
+
+To persist configuration and data, mount volumes:
+
+```bash
+docker run -d \
+  --name opencode \
+  -p 3000:3000 \
+  -v $(pwd)/opencode-config:/home/opencode/.config/opencode \
+  -v $(pwd)/opencode-data:/home/opencode/.local/share/opencode \
+  -e LITELLM_BASE_URL="http://host.docker.internal:4000" \
+  -e LITELLM_API_KEY="sk-your-api-key" \
+  -e LITELLM_MODEL_NAME="gpt-4" \
+  ghcr.io/ai-codespark/opencode:latest
+```
+
+### Available Tags
+
+- `latest` - Latest stable release
+- `v1.x.x` - Specific version tags (e.g., `v1.0.0`)
+
+Images are automatically built and published to GitHub Container Registry on each release.
+
 ## Environment Variables
 
 ### `LITELLM_BASE_URL`