Podmanager is a Visual Studio Code extension that helps you manage Podman containers, images, volumes, networks and pods directly from the VSCode interface.
If you find this project useful, please consider giving it a star ⭐ on GitHub! Your support helps me continue developing and improving it.
-
Manage Podman Resources: Comprehensive management of containers, images, volumes, networks and pods. Every action is available both as an inline icon and in the right-click menu.
-
Podman Machine Control
- Start and stop your Podman machine directly from VSCode
- Machine status monitoring (shown in the status bar at startup and on demand)
- Configurable machine name support
-
Container Management
- Simple & Advanced Creation: Choose between quick setup or advanced configuration (ports, volumes, networks, env vars, CPU/Memory limits and custom mounts).
- Start, stop and restart containers
- Delete containers (force-removed; the confirmation prompt can be turned off)
- Interactive terminal access to containers
- Flexible Logging: View logs in the Output panel or a dedicated Terminal.
- Execute commands in containers
- View container details (
podman inspect) - Add a stopped container to a pod
-
Image Management
- Build images from a Dockerfile
- Push Images: Push images to a registry, with support for a default registry (opt-in setting)
- Remove images (force-removed)
- Prune dangling images
- Prune all unused images
- Prune builder cache
- View image details
-
Volume Management
- Create new volumes
- Delete volumes (force-removed)
- View volume details
-
Network Management
- Create new networks
- Delete networks (force-removed)
- View network details
-
Pod Management
- Advanced Pod Creation: Configure name, hostname, additional hosts and CPU shares.
- Start, stop and restart pods
- Delete pods (force-removed)
- View pod details and status
-
Docker/Podman Compose Support
- Up, down, start, stop and restart compose services
- Support for both
docker-compose.ymlanddocker-compose.yaml - Project name detection
- Smart Path Persistence: Remembers the location of your compose files for quick access.
- Register compose files manually
- Multiple compose file support
- Configurable compose command style
- Remote compose support
-
Tools and Utilities
- Quick Links Sidebar: Easy access to the website, documentation, GitHub repository, issues and settings.
- Quick access tools menu
- Customizable Podman path
- Status bar integration with operation progress
- Error handling with copy-to-clipboard support
- Collapsible tree view with "Collapse All" support
- Optional auto-refresh (off by default, see
podmanager.autoRefreshInterval)
- Install Podmanager: Open the Extensions view in VSCode (
Ctrl+Shift+X), search for "Podmanager", and install the extension. - Ensure Podman is installed: Make sure you have Podman installed on your system and accessible from your command line.
Once the extension is installed:
- Activate the Extension: The extension activates automatically when VSCode starts.
- Open the Podmanager Sidebar: Click the Podmanager icon in the activity bar on the left to open the sidebar.
- Manage Your Resources: Use the Podmanager view to interact with your containers, images, volumes, networks and pods.
Refresh View: Refresh the entire Podman resources viewRefresh Overview: Update the overview sectionOpen Tools Menu: Access quick tools and actionsReset Podman Path: Reset the Podman path to its defaultShow Podman Machine Status: Report whether the configured machine is runningCollapse All: Collapse all expandable elements in the tree view
Start Podman Machine: Start the configured Podman machineStop Podman Machine: Stop the running Podman machine
Create Container: Create a new container (Simple or Advanced mode)Start Container: Start a stopped containerStop Container: Stop a running containerRestart Container: Restart a containerDelete Container: Remove a containerOpen in Terminal: Open an interactive terminal in a containerView Container Logs: View container logsExecute Command in Container: Run a command inside a container and show the outputView Details: Open thepodman inspectoutput of a container, image, volume, network or podAdd Container to Pod: Re-creates a stopped container inside a pod (Podman cannot move a container, so the original is replaced)
Build Image: Build an image from a DockerfilePush Image: Push an image to a registry (turn onpodmanager.enablePushCommand)Delete Image: Remove an imagePrune Images: Remove all dangling imagesPrune All Images: Remove all unused imagesPrune Builder Cache: Clear the Podman builder cache
Create Volume: Create a new volumeDelete Volume: Remove a volume
Create Network: Create a new networkDelete Network: Remove a network
Create Pod: Create a new podStart Pod: Start a podStop Pod: Stop a running podRestart Pod: Restart a podDelete Pod: Remove a pod
Compose Up: Create and start compose servicesCompose Down: Stop and remove compose servicesCompose Start: Start existing compose servicesCompose Stop: Stop running compose servicesCompose Restart: Restart compose servicesRegister Compose Files: Register compose files by project folder (remembered across sessions)
You can customize Podmanager via VSCode Settings (Ctrl+,):
| Setting | Description |
|---|---|
podmanager.podmanPath |
Podman command (e.g. podman, flatpak-spawn --host podman, podman --remote). Quote paths with spaces. |
podmanager.composePath |
Compose command (e.g. podman-compose, docker compose). Quote paths with spaces. |
podmanager.composeCommandStyle |
Choose between default, podman-compose or podman-space-compose (podman compose). |
podmanager.machineName |
The Podman machine name. |
podmanager.confirmDeletions |
Turn confirmation prompts for resource deletion on or off. |
podmanager.logsOutput |
Where logs are shown (outputChannel or terminal). |
podmanager.enablePushCommand |
Turn the Push Image action on or off (off by default). |
podmanager.pushDefaultRegistry |
Default registry (and namespace) used to pre-fill the push destination, e.g. quay.io/username. |
podmanager.autoRefreshInterval |
Refresh the view every N seconds while it is visible. 0 (the default) turns it off; the minimum when enabled is 5. |
Security:
podmanPath,composePathandmachineNamechoose which program Podmanager runs, so they are machine-scoped: they can only be set in your user (or remote machine) settings and are ignored in a project's.vscode/settings.json. Podmanager runs podman with an argument list and never through a shell, and it declares limited support for untrusted workspaces.
Most setups need no changes. Check these if something stops working:
- Workspace settings for
podmanPath,composePathandmachineNameare ignored. Move them to your user settings (Settings, "User" tab). - Windows:
.bat/.cmdwrappers no longer work forpodmanPath/composePath; use the.exe. - Shell features no longer work in those two settings (pipes,
&&, redirects,$(...), backticks, aliases). A program with arguments still works (flatpak-spawn --host podman,sudo podman,docker compose,podman --remote), and~and$HOME-style variables are still substituted. Quote paths that contain spaces. - Names that start with
-are refused rather than treated as command-line options.
Contributions, issues and feature requests are welcome! Feel free to check the Issues page to report bugs or request features.
npm run test:unit: compile-free fast tests (fake podman, mocked VS Code); also works on Windowstask test:container: the full suite in a throwaway Podman container (needs Node and Podman)- See
TESTING.mdfor details andCHECKLIST.mdfor the manual test checklist