| Platform | OS Version | Podman | devcontainer CLI | Last Tested |
|---|---|---|---|---|
| Ubuntu | 24.04 | 4.9.3 | 0.82.0 | 2026-01-27 |
| Fedora | 43 | 5.7.1 | 0.82.0 | 2026-01-27 |
Automated compatibility tests for VS Code Dev Containers with Podman.
# Install devcontainers CLI
npm install -g @devcontainers/cli
# Run a test
cd tests/minimal
devcontainer up --workspace-folder . --docker-path podmanMinimum devcontainer.json (no special config needed since CLI v0.76.0):
{
"image": "alpine:latest"
}This repository verifies VS Code Dev Containers compatibility with Podman, addressing:
| Component | Version | Changes |
|---|---|---|
| devcontainers/cli | v0.76.0+ | Auto-detects Podman, applies --security-opt label=disable and --userns=keep-id |
| Dev Containers Extension | 0.412.0+ | Includes fixed CLI |
| Test | Description |
|---|---|
| Minimal | {"image": "alpine:latest"} |
| Dockerfile | Custom Dockerfile build |
| Features (Go) | Dev Container Features |
| Docker in Docker | Nested container support |
Official Dev Container templates verified with Podman:
| Sample | Image |
|---|---|
| Python | mcr.microsoft.com/devcontainers/python:1-3.12 |
| Node.js | mcr.microsoft.com/devcontainers/javascript-node:1-22 |
| Go | mcr.microsoft.com/devcontainers/go:1-1.22 |
| Trigger | Description |
|---|---|
| Daily | 00:00 UTC (only if Podman/CLI versions changed) |
| On Push | When test files are modified |
| Manual | Via workflow dispatch |
| Platform | Infrastructure | Notes |
|---|---|---|
| Ubuntu | GitHub-hosted runner | Stable Podman (apt) |
| Fedora | AWS EC2 spot instance (c6id.large) | Latest Podman, NVMe SSD |
- Podman installed and running
- Node.js 18+
podman machine init && podman machine start
./scripts/run-tests.sh./scripts/run-tests.sh| Dev Containers Extension | devcontainers/cli | Status |
|---|---|---|
| 0.412.0+ | 0.76.0+ | ✅ Fully compatible |
| < 0.412.0 | < 0.76.0 |
- Fork the repository
- Add new test cases under
tests/ - Submit a pull request
MIT License - See LICENSE for details.