https://podman-desktop.io/blog/podman-quadlet Skip to main content Podman Desktop LogoPodman Desktop Logo podman desktopDocumentationDownloadsCommunity Resources * Features * Tutorials * Extend Blog Download Search All blog posts 2025 * Configure a mirror registry * Podman Desktop 1.17 Release * Podman Quadlets with Podman Desktop * Podman Desktop 1.16 Release * Podman Desktop BootC extension 1.6 Release 2024 * Using CNCF projects with Podman Desktop * Podman Desktop 1.15 Release * Podman AI Lab - For developers to build AI Applications with LLMs running locally * Podman Desktop + CNCF - Community Driven Move * Creating a MicroShift bootable image with Podman Desktop * Podman Desktop 1.14 Release * Introduction to Podman Desktop extensions * Podman Desktop 1.13 Release * Build your Kubernetes application with Podman Desktop * Podman Desktop 1.12 Release * Using RHEL as a WSL podman machine * Podman Desktop 1.11 Release * Podman Desktop 1.10 Release * Podman Desktop 1.9 Release * Podman Desktop 1.8 Release * Podman Desktop Wins 2024 DEVIES Award * Unlock WebAssembly on macOS & Windows * Podman Desktop 1.7 Release * Getting started with Compose on Podman Desktop 2023 * Podman Desktop 1.6 Release * Share your local podman images with the Kubernetes cluster * Podman Desktop 1.5 Release * Podman Desktop 1.4 Release * Podman Desktop 1.3 Release * Podman Desktop 1.2 Release * Podman Desktop 1.1 Release * Podman Desktop 1.0 Release * Release Notes - Podman Desktop 0.15 * Setting up and running a Kubernetes cluster locally with Podman Desktop * Release Notes - Podman Desktop 0.14 * Release Notes - Podman Desktop 0.13 * 5 things to know about Podman Desktop for a Docker user * Release Notes - Podman Desktop 0.12 * Release Notes - Podman Desktop 0.11 2022 * Release Notes - Podman Desktop 0.10 * Build & run Podman Desktop in a DevContainer Podman Quadlets with Podman Desktop January 29, 2025 * 4 min read Axel Stefanini Axel Stefanini Software Engineer banner Containers are typically deployed in Kubernetes clusters. However, for smaller-scale use cases such as on a single-node server or during development, Kubernetes can be overkill. What's a more lightweight solution for running autonomous applications with multiple interacting containers? In this blog, we'll dive into what Quadlets are, their benefits, and how to use them within Podman Desktop. What Are Quadlets? Podman Quadlets allow you to manage containers declaratively using systemd^1. Since version 4.4, Podman can create, start, and manage containers (including pulling images, creating volumes, and managing pods) through systemd. Quadlets are simplified configuration files--recognized by their specific extensions, such as *.container, *.pod, or *.image that are processed during startup or when you reload the daemon using the systemctl daemon-reload command. Quadlets generate the equivalent systemd unit files, streamlining the container management process. Why Use Quadlets? * Declarative Configuration: Similar to Compose or Kubernetes manifests, Quadlets allow you to declare what you want to run, simplifying the workload setup. * Tight System Integration: Quadlets align with Podman's philosophy of integrating seamlessly with Linux, leveraging systemd's process management capabilities. * Ease of Automation: Quadlets make it simple to configure containers to start at boot, restart on failure, and more. Example: A Quadlet File for Nginx Below is an example of an nginx.container Quadlet file, which starts an nginx container at boot: ~/.config/containers/systemd/nginx.container # nginx.container [Container] ContainerName=nginx Image=nginx PublishPort=80:8080 [Service] Restart=always This configuration ensures the container restarts automatically if stopped, and exposes port 8080. Using the Podman Quadlet Extension in Podman Desktop Managing Quadlets directly on non-Linux platforms can be challenging due to virtualized environments (e.g., WSL or Hyper-V). Fortunately, the Podman Desktop extension Podman Quadlet simplifies this process, enabling you to list, generate, and edit Quadlets visually. Key Features of the Extension * Integration with Podlet: Generates Quadlets from existing Podman objects^2. * Quadlet Management UI: Provides a dedicated interface to list, edit, delete, start, and stop Quadlets. * Logs Viewer: Fetches and displays systemd logs using journalctl for troubleshooting. Installation If you already have the latest version of Podman Desktop, you can click here to install the Podman Quadlet extension. Alternatively, navigate to the Extensions page within Podman Desktop to install it. List Quadlets On the Podman Quadlet page, you can view all the Quadlets available across your Podman machines. To update the list, click Refresh. Quadlets ListQuadlets List In Podman Desktop, you can see that a dedicated icon is used for the containers managed by a Quadlet. Container Quadlet IconContainer Quadlet Icon Generate Quadlets To generate a Quadlet from an existing container, you'll need to install Podlet. The extension simplifies installation. Use one of the following ways to install Podlet: * Go to Settings > CLI Tools and install Podlet using the Podman Quadlet extension. * Download Podlet manually from its GitHub release page. Podlet InstallationPodlet Installation Example: Generate a Container Quadlet 1. Start a container using Podman: podman run --name nginx-demo -d -p 80:8080 nginx 2. In Podman Desktop, find your container on the Containers page. 3. Click the overflow menu icon and select Generate Quadlet. Container actionsContainer actions 4. Click Generate to finalize the Quadlet. Quadlet Generate FormQuadlet Generate Form 5. Optional: Edit the Quadlet configuration details. 6. Click Load into machine. Quadlet Generate FormQuadlet Generate Form Congrats you created your first Quadlet! Edit Quadlets Click the Quadlet STATUS icon to view its details page, which has three tabs: * Generated: View the systemd unit generated by Podman (read-only). * Source: Edit the Quadlet file directly. * Logs: Monitor logs for the service using journalctl. You can make changes to the Quadlet's source file and apply updates as needed. Quadlet Details SourceQuadlet Details Source View Quadlet Logs Since a Quadlet's corresponding resource is managed by systemd we can access corresponding unit's logs using journalctl. Quadlet Details LogsQuadlet Details Logs Conclusion Podman Quadlets provide a powerful way to manage containers declaratively with systemd, bridging the gap between lightweight container management and full orchestration tools like Kubernetes. With the Podman Quadlet extension in Podman Desktop, users gain a convenient interface to manage Quadlets visually, reducing complexity and saving time. Try it today and streamline your container workflows! Footnotes 1. https://docs.podman.io/en/latest/markdown/ podman-systemd.unit.5.html - 2. https://github.com/containers/podlet - Tags: * podman-desktop * extension * podman * quadlet * systemd Newer post Podman Desktop 1.17 Release Older post Podman Desktop 1.16 Release * What Are Quadlets? + Why Use Quadlets? + Example: A Quadlet File for Nginx * Using the Podman Quadlet Extension in Podman Desktop + Key Features of the Extension + Installation + List Quadlets + Generate Quadlets + Edit Quadlets + View Quadlet Logs * Conclusion Documentation * Installing Podman Desktop * Migrating from Docker * Working with Kubernetes * Troubleshooting Links * GitHub * Chat (bridged): #podman-desktop on Discord * Other ways to Communicate * Current Sprint Cloud Native Computing Foundation Cloud Native Computing Foundation We are a Cloud Native Computing Foundation sandbox project. (c) Copyright Podman Desktop Contributors 2025. (c) 2025 The Linux Foundation. All rights reserved. The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Usage page.