Podmanager: Podman, in your sidebar.

A powerful VSCode extension designed to help you manage Podman containers, images, volumes, networks, and pods directly from your development environment.

Everything Podman, nothing to memorize.

One tree view for every resource, with the actions you reach for most one click away.

Create containers your way

Use quick setup, or go advanced with ports, volumes, networks, environment variables, CPU and memory limits, and custom mounts.

PortsVolumesNetworksEnv varsCPU & memoryMounts

Logs where you want them

Read container logs in the Output panel or a dedicated terminal. Open an interactive shell or run a command in any container.

Output · Podmanager: api-server
listening on :8080
GET /health 200

Compose support

Up, down, start, stop and restart services with Docker Compose or Podman Compose, including remote compose. Project names are detected and compose file locations are remembered.

docker-compose.ymlshop
docker-compose.yamlblog

Build, push, prune

Build from a Dockerfile, push to a registry (opt-in, with an optional default registry), and clear out what you no longer need.

Dangling imagesPrune
All unused imagesPrune
Builder cachePrune

Pods

Create pods with a name, hostname, extra hosts and CPU shares. Start, stop, restart, or add a stopped container to one.

namehostnameextra hostsCPU shares

Podman machine control

One button in the title bar starts or stops your machine and shows its state, and the status bar reports it at startup. Using a named machine? Set it once in settings.

podman-machine-defaultRunning

Volumes and networks

Create them, inspect their details, and remove them. Deletes are forced, so a stuck resource doesn't get in your way.

Create volumeView details
Create networkView details

Inspect anything

View details opens the podman inspect output for containers, images, volumes, networks and pods. Every action is both an inline icon and a right-click entry.

ContainersImagesVolumesNetworksPods

Safe by design

Podman and compose run with an argument list, never through a shell. The path and machine settings can only be set in your user settings, and untrusted workspaces are restricted.

No shellMachine-scoped pathsWorkspace Trust
  • Status bar progress
  • Auto-refresh (opt-in)
  • Collapse all
  • Copy errors to clipboard
  • Quick links sidebar
  • Remembers compose file paths
  • Disk usage overview
  • Green and red image usage markers
  • Custom Podman and compose commands

Every command, one search away.

Find any action from the Command Palette, or filter the full list here.

General
Refresh ViewRefresh the whole Podman resources view
General
Refresh OverviewUpdate the overview section
General
Open Tools MenuQuick tools and actions
General
Reset Podman PathGo back to the default Podman path
General
Collapse AllCollapse every node in the tree
Machine
Start Podman MachineStart the configured machine
Machine
Stop Podman MachineStop the running machine
Machine
Show Podman Machine StatusReport whether the machine is running
Container
Create ContainerQuick or advanced setup
Container
Start ContainerStart a stopped container
Container
Stop ContainerStop a running container
Container
Restart ContainerRestart a container
Container
Delete ContainerRemove a container
Container
Open in TerminalInteractive terminal in a container
Container
View Container LogsIn the Output panel or a terminal
Container
Execute Command in ContainerRun a command and show its output
Container
View DetailsOpen the podman inspect output of any resource
Container
Add Container to PodRe-create a stopped container inside a pod
Image
Build ImageBuild from a Dockerfile
Image
Push ImagePush to a registry (opt-in setting)
Image
Delete ImageRemove an image
Image
Prune ImagesRemove dangling images
Image
Prune All ImagesRemove all unused images
Image
Prune Builder CacheClear the builder cache
Volume
Create VolumeMake a new volume
Volume
Delete VolumeRemove a volume
Network
Create NetworkMake a new network
Network
Delete NetworkRemove a network
Pod
Create PodName, hostname, extra hosts and CPU shares
Pod
Start PodStart a pod
Pod
Stop PodStop a running pod
Pod
Restart PodRestart a pod
Pod
Delete PodRemove a pod
Compose
Compose UpCreate and start services
Compose
Compose DownStop and remove services
Compose
Compose StartStart existing services
Compose
Compose StopStop running services
Compose
Compose RestartRestart services
Compose
Register Compose FilesRemember compose files by project folder

Up and running in three steps.

  1. Install the extensionOpen Extensions (Ctrl Shift X), search for “Podmanager” and install it.
  2. Check PodmanMake sure Podman is installed and reachable from your command line.
  3. Open the sidebarClick the Podmanager icon in the activity bar. It activates when VS Code starts.

Open source. Read it, fork it, fix it.

Podmanager is built in the open. Report a bug, request a feature, or send a pull request.

git clone https://github.com/dreamcatcher45/podmanager.git

Questions, answered.

Do I need Podman installed?

Yes. Podmanager drives your local Podman, so it needs to be installed and reachable from your command line. If it lives somewhere unusual, set podmanager.podmanPath.

Does it work with compose files?

Yes. It supports docker-compose.yml and docker-compose.yaml, with up, down, start, stop and restart. Pick the command style that matches your setup with podmanager.composeCommandStyle, and register compose files by project folder so they are remembered.

Will it delete things without asking?

Deletes are confirmed with a prompt, and you can turn that prompt off with podmanager.confirmDeletions. Deletes are force removals.

Where do container logs appear?

In the Output panel (a one-time dump) or a dedicated terminal (live, following the log). Switch between them with podmanager.logsOutput.

Can I push images to a registry?

Yes. It is off by default: enable podmanager.enablePushCommand and set a default registry with podmanager.pushDefaultRegistry to pre-fill the destination.

Can I move a container into a pod?

Podman cannot move a container, so Add Container to Pod re-creates a stopped container inside the pod. The container gets a new ID and the original is replaced.

Can I use Flatpak, sudo or a remote Podman?

Yes. podmanager.podmanPath and podmanager.composePath accept a command with arguments, such as flatpak-spawn --host podman, sudo podman or podman --remote. Quote paths that contain spaces.

Why are my project settings for the Podman path ignored?

On purpose. podmanPath, composePath and machineName decide which program runs, so they are machine-scoped and can only be set in your user settings. That stops a repository from running commands the moment you open it.

Does the view refresh by itself?

Not by default. Set podmanager.autoRefreshInterval to a number of seconds (minimum 5) to refresh while the view is visible. 0 turns it off.

Can I control the Podman machine from VS Code?

Yes. A button in the view title bar starts or stops the machine and shows its state, and the status bar reports it at startup. Set podmanager.machineName if you use a named machine.