Deployment

Production deployment options for your Sekuire agents.

Deployment Options

OptionBest ForInfrastructure
sekuire runDevelopment, quick testingLocal
DockerSingle-node productionAny Docker host
Helm/BYOCKubernetes clustersYour K8s cluster
ManagedZero-opsSekuire Cloud

Local Development

Use sekuire run for local testing with full bootstrap:

Terminalbash
sekuire run --cmd "npm start"

This handles:

  • Workspace registration
  • Install token creation
  • Heartbeat loop
  • Agent process management

Docker Deployment

Use sekuire docker-init to generate production-ready Docker configuration:

Terminalbash
sekuire docker-init --ci

This generates Dockerfile, docker-compose files, and optionally GitHub Actions CI pipeline. See sekuire docker-init for all options.

Build & Push to OCI Registry

Terminalbash
# Login to Sekuire OCI registry sekuire registry login # Build image docker build -t registry.sekuire.com/my-org/my-agent:v1.0.0 . # Push (includes vulnerability scanning and signing) sekuire registry push registry.sekuire.com/my-org/my-agent:v1.0.0

Run with Beacon

Terminalbash
docker run -d \ -p 8000:8000 \ -e OPENAI_API_KEY=$OPENAI_API_KEY \ -e SEKUIRE_WORKSPACE_ID=ws_abc123 \ -e SEKUIRE_INSTALL_TOKEN=$INSTALL_TOKEN \ registry.sekuire.com/my-org/my-agent:v1.0.0

The agent will automatically register with the Sekuire backend and start sending heartbeats.


Beacon Registration

For production deployments, agents should register with the Sekuire backend to enable:

  • Fleet visibility in the dashboard
  • Kill switch functionality
  • Heartbeat monitoring and alerts

Learn more about Beacon or see the Beacon SDK for programmatic control.


Kubernetes (BYOC)

Generate a Helm chart for your cluster:

Terminalbash
sekuire install bundle \ --workspace ws_abc123 \ --image myrepo/my-agent:v1.0.0 \ --output deploy/helm

Deploy with Helm

Terminalbash
cd deploy/helm/my-agent-helm # Review values.yaml # - Set secrets (API keys) # - Configure replicas # - Set resource limits helm install my-agent . -n my-namespace

Generated Files

deploy/helm/my-agent-helm/text
deploy/helm/my-agent-helm/ ├── Chart.yaml ├── values.yaml # Configure here ├── README.md └── templates/ ├── deployment.yaml ├── service.yaml ├── configmap.yaml └── secret.yaml

Managed Deployment

Let Sekuire host your agent (zero infrastructure management):

Terminalbash
sekuire install agent \ --workspace ws_abc123 \ --agent $(sekuire hash) \ --deployment-type managed

Requirements:

  • Agent pushed to registry (sekuire push)
  • Workspace with managed deployment enabled

Environment Variables

VariableDescription
SEKUIRE_WORKSPACE_IDTarget workspace
SEKUIRE_AGENT_IDAgent Sekuire ID
SEKUIRE_INSTALL_TOKENBootstrap token
SEKUIRE_BACKEND_URLAPI endpoint
💡Use sekuire install token to pre-generate tokens for CI/CD pipelines.

Next Steps