Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.idunplatform.com/llms.txt

Use this file to discover all available pages before exploring further.

Idun Agent Platform supports two deployment modes depending on your needs. You can run a single agent with a config file, or deploy the full platform with centralized management.

​
Deployment modes

Pull published Docker images from Docker Hub and start the full stack. No build step required — this is the recommended approach for production and self-hosted deployments.
git clone https://github.com/Idun-Group/idun-agent-platform.git
cd idun-agent-platform
# Edit docker-compose.yml: set AUTH__SECRET_KEY to a strong random value
docker compose up -d
The Manager API is available at http://localhost:8000 and the web UI at http://localhost:3000.This mode suits:
  • Production deployments
  • Self-hosted environments
  • Multi-agent deployments
  • Teams that need centralized configuration and RBAC

​
Docker Compose variants

FilePurposeImages
docker-compose.ymlProductionPulls prebuilt images from Docker Hub
docker-compose.build.ymlBuild from sourceBuilds images locally from Dockerfiles
docker-compose.dev.ymlDevelopmentBuilds from source with hot reload, Vite dev server
docker-compose.debug.ymlDebug overlayAdds debugpy to the manager (use with -f alongside dev)
All production and build compose files use env_file: .env for secrets and configuration. Copy .env.example to .env before starting. To include the demo agent service, add the demo profile: 
docker compose --profile demo up

​
Agent lifecycle management

From the agent detail page, manage the agent lifecycle:
  • The status badge shows Draft or Active
  • Click Restart to call /reload on the running engine, which re-fetches config from the platform
  • The Overview tab includes Connect to Platform instructions for enrollment Agent detail overview tab

​
Full stack architecture

In managed mode, the platform consists of three services and a database:
ComponentDescriptionDefault port
ManagerFastAPI control plane API for agent configuration, auth, and workspace management8080
Web UIReact admin dashboard (nginx in production, Vite in dev)3000
PostgreSQLStores agent configs, user accounts, workspace data5432
Agent enginesYour agent services, each running the Idun engine SDK8000+

​
Prerequisites

RequirementStandaloneManaged
Python 3.12+YesYes (for agent services)
Docker + Docker ComposeNoYes
PostgreSQL 16NoYes (included in Docker Compose)
idun-agent-engine packageYesYes (for agent services)

​
Self-hosted cloud deployments

For production workloads, deploy the platform on your own cloud infrastructure.
Last modified on April 15, 2026