Run containers as microVMs. Fast, secure, simple.
Ravel is an open-source orchestrator that runs OCI containers inside lightweight microVMs powered by Cloud Hypervisor. Get the security of VMs with the simplicity of containers.
# Deploy nginx in a microVM
curl -X POST 'http://localhost:3000/fleets/my-fleet/machines?namespace=default' \
-H 'Content-Type: application/json' \
-d '{"region": "eu-west", "config": {"image": "nginx:alpine", "guest": {"cpus": 1, "memory_mb": 512}}}'Built by Valyent to power our cloud infrastructure.
- MicroVM Runtime - Run any OCI/Docker image inside isolated Cloud Hypervisor VMs
- HTTP Gateway - Automatic HTTPS routing with Let's Encrypt support
- TCP/UDP Proxy - Load-balanced proxy for any protocol
- Private Networks - WireGuard-based networking between machines
- Volumes & Secrets - Persistent storage and secure secret management
- Clustering - Multi-node clusters with gossip-based state sync
# 1. Create a namespace
curl -X POST 'http://localhost:3000/namespaces' \
-H 'Content-Type: application/json' -d '{"name": "default"}'
# 2. Create a fleet
curl -X POST 'http://localhost:3000/fleets?namespace=default' \
-H 'Content-Type: application/json' -d '{"name": "web"}'
# 3. Deploy a machine
curl -X POST 'http://localhost:3000/fleets/web/machines?namespace=default' \
-H 'Content-Type: application/json' \
-d '{"region": "eu-west", "config": {"image": "nginx:alpine", "guest": {"cpu_kind": "std", "cpus": 1, "memory_mb": 512}}}'
# 4. Create a gateway to expose it
curl -X POST 'http://localhost:3000/fleets/web/gateways?namespace=default' \
-H 'Content-Type: application/json' -d '{"name": "www", "target_port": 80}'Your app is now live at https://www.yourdomain.com
| Example | Description |
|---|---|
| hello-world | Simple Alpine container |
| nginx | Nginx web server with gateway |
| frankenphp | Modern PHP application server |
See the examples directory for more.
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Client │────▶│ Edge Proxy │────▶│ Local Proxy │
└─────────────┘ └─────────────┘ └─────────────┘
│ │
▼ ▼
┌─────────────┐ ┌─────────────┐
│ Corrosion │ │ MicroVM │
│ (State) │ │ (Container) │
└─────────────┘ └─────────────┘
Components:
- Cloud Hypervisor - Lightweight VMM for microVMs
- Containerd - OCI image management
- Corrosion - Distributed state via gossip
- NATS - Pub/sub messaging
Not yet, Ravel is in beta and is to be considered unstable.
But we are working full time on providing a stable release.
Ravel is named after the famous composer Maurice Ravel, known for his orchestral works.
Please come and join us on our Discord server, where you can ask questions, get help, and contribute to the project.
Please open an issue on our GitHub repository.
Please open an issue on our GitHub repository.
Copyright 2024-2025 Valyent
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Thank you for your support! 🌟