Skip to main content
Deploy Idun Agent Platform on Google Cloud Platform using a serverless architecture with Cloud Run and Cloud SQL.

​
Architecture

The platform maps to GCP services as follows:
ComponentGCP serviceDescription
Manager (control plane)Cloud RunHandles API requests, authentication, and agent configuration
Web UICloud RunServes the React admin dashboard
DatabaseCloud SQL for PostgreSQLStores platform state, agent configurations, and user data
Agent enginesCloud Run (or your CI/CD)Your agent services, deployed as separate Cloud Run services

​
Deployment process

1

Provision the database

Create a Cloud SQL PostgreSQL instance. The Manager requires PostgreSQL 16.Configure the connection string as DATABASE__URL for the Manager service:
postgresql+asyncpg://user:password@/dbname?host=/cloudsql/project:region:instance
2

Deploy the Manager

Deploy the Manager container image to Cloud Run with the database connection string and auth configuration:
gcloud run deploy idun-manager \
  --image your-registry/idun-manager:latest \
  --set-env-vars "DATABASE__URL=postgresql+asyncpg://..." \
  --set-env-vars "AUTH__SESSION_SECRET=your-secret" \
  --set-env-vars "AUTH__SECRET_KEY=your-api-key-secret" \
  --add-cloudsql-instances project:region:instance \
  --allow-unauthenticated
3

Deploy the Web UI

Deploy the UI container image to Cloud Run, pointing to the Manager’s URL:
gcloud run deploy idun-web \
  --image your-registry/idun-web:latest \
  --set-env-vars "VITE_API_URL=https://idun-manager-xyz.run.app" \
  --allow-unauthenticated
4

Configure networking (optional)

For production, set up a load balancer or use Cloud Run custom domains to expose the services under your own domain.

​
Agent deployment

Agent engines are deployed as separate Cloud Run services or through your existing CI/CD pipelines (GitHub Actions, Cloud Build). Each agent service runs the Idun engine SDK and fetches its configuration from the Manager at startup: 
export IDUN_AGENT_API_KEY=your-agent-api-key
export IDUN_MANAGER_HOST=https://idun-manager-xyz.run.app
idun agent serve --source manager

​
Terraform modules

Terraform modules for automating the full deployment (IAM, networking, security configuration) are available through a custom engagement with Idun.
Contact us for Terraform modules. Book a call or reach out via GitHub Issues to discuss your deployment needs.
Last modified on March 22, 2026