Kaoto Infrastructure view: manage Camel dev services from VS Code

Kaoto 2.12 introduced a new Infrastructure view — a sidebar panel that lets you start, monitor, and stop Camel infrastructure services (databases, message brokers, and other backing services) without leaving VS Code. The feature shipped in 2.12 and is present in 2.13.
Because it is experimental, the view is hidden by default behind a single VS Code setting. This post walks you through enabling it and shows what it can do — and we would love to hear your feedback.
Why it exists
Every non-trivial Camel integration depends on something external: a database, a message broker, a cache. While developing locally, that usually means opening a terminal, running a docker run or podman run command, waiting for the service to be ready, copying the connection URL into your config, and repeating this every time you restart your machine.
The Infrastructure view moves all of that into Kaoto. One click to start a service, live status in the sidebar, one-click copy of the connection URL into your clipboard.
Enabling the view
The feature is marked experimental and hidden by default — that is why you may not have noticed it. Experimental does not mean broken: the view is fully functional and usable today. We keep it opt-in while we gather feedback and decide what to add next.
To turn it on:
- Open VS Code Settings (
Ctrl+,/Cmd+,) and search forkaoto.infrastructure.enabled. - Check the Kaoto › Infrastructure: Enabled checkbox.
- The Infrastructure panel appears in the Kaoto sidebar.
Starting a service
Once the view is visible, click the + button in the toolbar. Kaoto queries camel infra — the dev services capability built into Camel JBang — and shows you the list of available services.
Pick one, optionally enter a custom port (leave it empty to use the service default), and the service starts. It appears immediately in the tree with a starting badge that flips to running once the container is ready.
A couple of guardrails worth knowing:
- No container runtime? If Docker or Podman is not running, Kaoto shows a clear error message instead of a cryptic failure.
- Already running externally? If the service is already up (started outside VS Code), a dialog lets you choose: Use Existing to keep it as-is and register it in the view, or Stop and Restart to take over management.
Watching and managing running services
Each running service shows its name, port, and a live status indicator. The view refreshes automatically while services are running so the status stays accurate.
Hover over a service for inline actions:
- Stop — stops the service with a confirmation dialog to prevent accidental stops
- Show logs — opens the dedicated VS Code terminal for the service
Right-click for clipboard shortcuts:
- Copy URL — copies the service address (
host:port) to the clipboard, when available - Copy port — just the port number
Running with Podman
Note: This section only applies to Linux + Podman. On macOS and Windows, Podman runs inside a Podman machine (a VM) that already exposes a Docker-compatible API endpoint, so the Infrastructure view works there without any extra configuration.
camel infra starts services through Testcontainers, which talks to a Docker-compatible API socket rather than to the docker or podman CLI. Docker provides that socket out of the box, but on Linux Podman is daemonless, so nothing is listening on it by default. If you use Podman on Linux without the Podman service running, the service fails to start with an error like this:
Could not find a valid Docker environment. Please check configuration. Attempted configurations were:
UnixSocketClientProviderStrategy: failed with exception InvalidConfigurationException (Could not find unix domain socket). Root cause NoSuchFileException (/var/run/docker.sock)
DockerDesktopClientProviderStrategy: failed with exception NullPointerException ...
Testcontainers is looking for /var/run/docker.sock, which does not exist. Fixing it takes two steps: run the Podman API service, then tell Testcontainers where its socket is.
1. Run the Podman API service
Pick one of the following options.
Option A: enable the systemd socket (recommended). Podman starts on demand when something connects to the socket, and it survives restarts. Nothing has to stay open in a terminal:
systemctl --user enable --now podman.socket
Option B: run the service manually. This is the command from the Podman Desktop tutorial. The --time=0 flag disables the inactivity timeout, so the service keeps running until you stop it. The command stays in the foreground, so the terminal hangs while the service is in use. Keep that terminal open, or append & to run it in the background of the current shell:
podman system service --time=0
Either way, you can check where the socket lives with:
podman info --format '{{.Host.RemoteSocket.Path}}'
For a rootless setup on Linux this is usually /run/user/<uid>/podman/podman.sock.
2. Point Testcontainers to the Podman socket
Create a ~/.testcontainers.properties file in your home directory. Use the path printed above; the file does not expand shell variables, so write the resolved path (replace 1000 with your user id, id -u):
docker.host=unix:///run/user/1000/podman/podman.sock
We recommend the file over exporting DOCKER_HOST: VS Code launches camel infra with its own environment, which may not include variables from your shell profile, whereas the properties file is always read.
After that, starting a service from the Infrastructure view (or running camel infra run elasticsearch from a terminal) works as it does with Docker.
If you run into trouble, for example with Ryuk (the Testcontainers cleanup container) or SELinux, these guides cover the details:
- Using Podman instead of Docker in the Testcontainers documentation
- Setup Testcontainers with Podman in the Podman Desktop tutorials
We want your feedback
This feature is marked experimental for a reason: we shipped it to get real-world signal on how developers actually want to manage infrastructure from their editor. Your feedback now directly shapes where it goes next.
Things we are particularly interested in:
- Which services do you start most often?
- Is the start / stop / log flow what you expected, or did something feel off?
- What is missing that would make this part of your daily workflow?
Join the conversation in GitHub Discussions or open an issue if you hit a rough edge.
Give it a try
- Install or update the Kaoto VS Code extension — the Infrastructure view is available from version 2.12 onwards
- Enable
kaoto.infrastructure.enabledin your VS Code settings - Read the full Infrastructure view documentation for a detailed reference
- Start a service and let us know what you think 🐫
