Skip to main content

Deployment

This section covers deploying AgentVisor™ to various environments.

Overview​

AgentVisor can be deployed as:

  • Docker containers: Single-node development/staging
  • Kubernetes: Production-scale deployment
  • Combined images: Self-contained agent images

Guides​

Quick Reference​

Local Development​

# Start development services (from the scaffolded project's compose.yml)
docker compose up -d

# Run agent (Docker is the default sandbox mode for `serve`)
agentvisor serve ./my-agent

Docker​

# Build image
agentvisor build ./my-agent -t my-agent:v1

# Run (gVisor rootless is the default)
docker run --security-opt seccomp=unconfined \
    --security-opt apparmor=unconfined \
    my-agent:v1

Kubernetes​

apiVersion: v1
kind: Pod
spec:
  containers:
  - name: agent
    image: my-agent:v1
    securityContext:
      seccompProfile:
        type: Unconfined  # Required for rootless gVisor (default mode)
      appArmorProfile:
        type: Unconfined  # Required on Ubuntu 24.04+, GKE, AKS

Requirements​

License​

License required

Production images built with agentvisor build require a valid Manetu license key. Always provide AGENTVISOR_LICENSE_KEY as an environment variable (Docker -e, Kubernetes Secret). See the Licensing guide for container deployment patterns and where to obtain a key.

Temporal​

AgentVisor requires a Temporal server for durable execution.

Development:

docker compose up -d

Production:

For Linux deployments where maximum isolation is preferred:

# Install gVisor
curl -fsSL https://gvisor.dev/archive.key | sudo apt-key add -
sudo add-apt-repository "deb https://storage.googleapis.com/gvisor/releases release main"
sudo apt-get update && sudo apt-get install runsc