Time to complete: 5 minutes
What you’ll get: xpander.ai running on your own Kubernetes cluster with full data control
Deploy the xpander.ai engine to your Kubernetes infrastructure. Keep all data within your network while leveraging the full power of the platform.

​
Quick K8s Deployment

1

Create Environment

Create a self-hosted environment in the xpander.ai Console:
  1. Go to app.xpander.ai/environments
  2. Click “Add Environment”
  3. Enter your server FQDN (e.g., xpander.my-company.com)
The platform provides your complete Helm installation commands!
2

Install with Helm

Run the provided Helm command from the UI. This is just an example. Make sure you provide your OpenAI/Anthropic keys.
# Add repository and install (example - use your generated commands)
helm repo add xpander https://charts.xpander.ai
helm upgrade --install xpander xpander/xpander \
  --namespace xpander --create-namespace \
  --set ingress.enabled=true \
  --set domain=xpander.my-company.com \
  --set global.organizationId=your-org-id \
  --set global.environmentId=your-env-id \
  --set secrets.static.deploymentManagerApiKey=your-key
3

Verify

Check deployment:
kubectl -n xpander get pods
curl http://agent-controller.xpander.my-company.com/health
All pods should show Running status.

​
What You Deployed

xpander self-deployed engine

Agent controller, AI gateway, MCP server, and worker nodes

Your Data Stays Private

All conversations and business logic remain in your cluster

Outbound Only

No inbound connections - only connects out to the xpander.ai cloud

Ready to Use

Easily deploy all your existing or new agents and MCP servers to your self-hosted environment

​
Prerequisites

  • Kubernetes 1.20+ with kubectl access
  • Helm 3.12+ installed
  • Ingress Controller (NGINX recommended)
  • Storage Class for persistent volumes
  • Outbound HTTPS access to 166.117.85.46 and 15.197.85.80

​
Next Steps

Your self-hosted xpander.ai is ready! Now build:

​
Troubleshooting

Check storage and permissions: kubectl -n xpander describe pod <pod-name>
Verify ingress and DNS: kubectl -n xpander get ingress
Full deployment guide: Self-Hosted Deployment