Opencode Web for Cloudron

AI coding agent with web UI for Cloudron.

Installation

Install via Cloudron App Store or manually:

cloudron install --source <repo-url>

Configuration

Edit /app/data/config/env.sh to configure:

• BROWSERLESS_HOST - Browserless instance hostname
• BROWSERLESS_TOKEN - Browserless auth token (optional)
• Access to the web UI is handled by Cloudron proxyAuth
• Sign in with your Cloudron account; no separate app username or password is used

Model Providers

Configure API keys in /app/data/config/opencode.json:

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "your-api-key"
      }
    }
  }
}

Supports: Anthropic, OpenAI, Google, and 70+ providers via models.dev.

Browserless Integration

This app integrates with the self-hosted Browserless instance on your Cloudron for headless browser tasks. Set BROWSERLESS_HOST and BROWSERLESS_TOKEN in env.sh.

Access

• Web UI: https://<your-app-domain>
• Sign in with your Cloudron account via Cloudron proxyAuth

Creating Projects

Projects must be created as directories in /app/data/projects/:

1. Via Cloudron File Manager:

   • Navigate to the app's data directory
   • Create a new folder in projects/ (e.g., my-first-project)

2. Via Terminal:

   mkdir -p /app/data/projects/my-first-project
   

Then in the web UI:

• Click "Add Project" or "Open Project"
• You should see the projects folder with your created directories
• Select a project directory to start a session

Note: The file picker shows symlinks to /app/data directories. Navigate into projects/ to see your project folders.

Documentation

• Opencode Docs
• Cloudron Packaging Guide