🚀
ECS & ELBv2 Compatible
Full compatibility with Amazon ECS and ELBv2 APIs, enabling seamless local development and testing
KECSKubernetes-based ECS Compatible Service
Run Amazon ECS workloads locally with full AWS service integration
Skip to content
What is KECS?
KECS (Kubernetes-based ECS Compatible Service) provides a complete local Amazon ECS environment that runs entirely on your machine. It's designed for developers who want to:
- Develop locally without AWS costs or internet connectivity
- Test ECS workloads in a production-like environment
- CI/CD integration with consistent, reproducible environments
- Learn ECS without needing an AWS account
Key Features
🏗️ Complete ECS Implementation
- Full ECS API compatibility (clusters, services, tasks, task definitions)
- ELBv2 support (Application and Network Load Balancers)
- Service Discovery integration
- Auto-scaling capabilities
🌐 Unified AWS Experience
- Single endpoint for all AWS services (port 5373)
- Built-in LocalStack integration
- Automatic IAM role creation (
ecsTaskExecutionRole) - Seamless AWS CLI/SDK compatibility
👨💻 Developer Focused
- Container-based execution - no complex setup
- Multiple instance support for different projects
- Interactive TUI for resource management
- Hot reload for rapid development
🔧 Production-Ready Features
- DuckDB for reliable state persistence
- Graceful shutdown and cleanup
- Resource monitoring and health checks
- Comprehensive logging and debugging
Getting Help
- 📖 Documentation - Comprehensive guides and tutorials
- 🐛 Issue Tracker - Report bugs or request features
- 📝 Examples - Sample applications and configurations
License
KECS is open source software licensed under the Apache 2.0 License.