Customize Your Installation
Configure Zentinel with the agents you need. Generate installation commands and starter configuration for your use case.
1 Installation Method
2 Official Agents
Select the agents you want to include. All agents are optional and can be added later.
Looking for more? We have 25+ agents for security, observability, and traffic management.
Browse All Agents3 Installation
Shell
# Install Zentinel proxy
curl -fsSL https://getzentinelproxy.io | sh
# Select agents above to include them in the installation4 Example Configuration
A starter configuration with your selected agents. Save as zentinel.kdl
zentinel.kdl
// Zentinel Configuration
// https://zentinelproxy.io
system {
worker-threads 0 // 0 = number of CPU cores
graceful-shutdown-timeout-secs 30
}
listeners {
listener "http" {
address "0.0.0.0:8080"
protocol "http"
}
}
routes {
route "default" {
matches {
path-prefix "/"
}
upstream "backend"
}
}
upstreams {
upstream "backend" {
targets {
target {
address "127.0.0.1:3000"
}
}
load-balancing "round_robin"
}
}
// No agents configured5 Run Zentinel
Start Zentinel with your configuration file.
Shell
# Start Zentinel
zentinel --config zentinel.kdl