Installation

How to install and run the Dorgu Platform

The platform can be run via the dorgu CLI, as a standalone binary, or from source.

Via dorgu CLI (recommended)

If you already have the dorgu CLI installed:

dorgu platform serve

This starts the platform on port 8080 using your current kubeconfig context.

Options

dorgu platform serve --port 3000                    # Custom port
dorgu platform serve --kubeconfig ~/.kube/prod.yaml  # Specific kubeconfig
dorgu platform serve --context prod-cluster          # Specific context
dorgu platform serve --verbose                       # Enable debug logging

Standalone binary

Build and run the platform server directly:

cd dorgu-platform
make build
./bin/server -port 8080

Flags

Flag	Default	Description
-port	8080	HTTP server port
-kubeconfig	~/.kube/config	Path to kubeconfig file
-context	Current context	Kubernetes context to use

From source

1. Clone the repository

   git clone https://github.com/dorgu-ai/dorgu-platform.git
   cd dorgu-platform
   
2. Build the frontend

   cd web
   npm install
   npm run build
   cd ..
   
3. Build the binary

   make build
   

   This copies the frontend build to pkg/server/static and compiles a single Go binary with embedded assets.

4. Run

   ./bin/server -port 8080
   

Prerequisites

• A running Kubernetes cluster with the dorgu operator installed
• At least one ClusterPersona resource created
• A valid kubeconfig with access to the cluster

The platform only reads ClusterPersona resources — it makes no changes to your cluster. It requires get, list, and watch permissions on clusterpersonas.dorgu.io.

Verifying the installation

After starting the platform, verify it’s working:

# Check the health endpoint
curl http://localhost:8080/health

# Check the API returns clusters
curl http://localhost:8080/api/clusters

Then open http://localhost:8080 in your browser.

Quickstart

Step-by-step first use guide

Development

Run in development mode with hot reload