Skip to main content
AI
  • Get started with AI

    • Red Hat AI

      Accelerate the development and deployment of enterprise AI solutions.

    • AI learning hub

      Explore learning materials and tools, organized by task.

    • AI interactive demos

      Click through scenarios with Red Hat AI, including training LLMs and more.

    • AI/ML learning paths

      Expand your Red Hat OpenShift AI knowledge using these learning resources.

    • AI quickstarts

      Focused AI use cases designed for fast deployment on Red Hat AI platforms.

    • No-cost AI training

      Foundational Red Hat AI training.

  • Featured resources

    • Red Hat OpenShift AI
    • Open source AI for developers
    • AI product application development
    • Open source-powered AI/ML for hybrid cloud
    • AI and Node.js cheat sheet

Red Hat AI Factory with NVIDIA

Red Hat AI Factory with NVIDIA is a co-engineered, enterprise-grade AI solution for building, deploying, and managing AI at scale across hybrid cloud environments.

Learn
  • Self-guided

    • Documentation

      Find answers, get step-by-step guidance, and learn how to use Red Hat products.

    • Learning paths

      Explore curated walkthroughs for common development tasks.

    • Guided learning

      Receive custom learning paths powered by our AI assistant.

    • See all learning
  • Hands-on

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

    • Interactive labs

      Learn by doing in these hands-on, browser-based experiences.

    • Interactive demos

      Click through product features in these guided tours.

  • Browse by topic

    • AI/ML
    • Automation
    • Java
    • Kubernetes
    • Linux
    • See all topics
  • Training & certifications

    • Courses and exams
    • Certifications
    • Skills assessments
    • Red Hat Academy
    • Learning subscription
    • Explore training
Build
  • Get started

    • Red Hat build of Podman Desktop

      A downloadable, local development hub to experiment with our products and builds.

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

  • Download products

    • Red Hat Enterprise Linux
    • Red Hat AI
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products
  • Featured

    • Red Hat build of OpenJDK
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenShift Dev Spaces
    • Red Hat Developer Toolset
  • References

    • E-books
    • Documentation
    • Cheat sheets
    • Architecture center
Community
  • Get involved

    • Events
    • Live AI events
    • Red Hat Summit
    • Red Hat Accelerators
    • Community discussions
  • Follow along

    • Articles & blogs
    • Developer newsletter
    • Videos
    • Github
  • Get help

    • Customer service
    • Customer support
    • Regional contacts
    • Find a partner

Join the Red Hat Developer program

Download Red Hat products and project builds, access support documentation, learning content, and more.

ConsoleDocsSupport Search
New For you

Recommended

We'll recommend resources you may like as you browse. Try these suggestions for now.

  • Product downloads
  • Cheat sheets
  • Red Hat Developer learning portal
  • Developer blog
  • E-books
  • Developer Sandbox
Log in

Get more with a Red Hat Developer account

  • Product downloads
  • Console access
  • Event registration
  • Training & trials
Explore more account benefitsLog in or register

A subscription may be required for some services.

Contact us

Getting started with containers using Podman

Run and manage containers with Podman commands and systemd

November 18, 2026
Alex Taylor
Related topics:
Containers
Related products:
Red Hat OpenShift Container Platform

    Containers package an application alongside all its dependencies into an isolated runtime. Because they share the host kernel instead of virtualizing an entire operating system, containers spin up in seconds with a fraction of the overhead of traditional virtual machines.

    With containers, you can:

    • Spin up new infrastructure in seconds without polluting your host environment
    • Tear down and redeploy test instances with zero leftover artifacts
    • Package an application once and run it consistently across Fedora, Red Hat Enterprise Linux (RHEL), or personal lab hardware

    What is Podman?

    In this topic article, Red Hat explains that Podman is an open source engine designed to let you develop, run, and maintain containers across Linux environments without requiring root privileges or a background daemon.

    If it's not already installed on your system, you can install it using dnf:

    dnf install podman

    When I was first introduced to containers in 2019, they completely changed the way I ran services, both in my homelab and later as a system administrator. To this day, I always check that a project has a container before even considering installing it directly on a host.

    How are Podman container images created?

    Podman container images are built from something called a Containerfile. This file contains the commands used to create a container image. You may notice the syntax looks similar to a Bash script.

    # Example of a Containerfile
    FROM alpine
    RUN apk add --no-cache figlet
    ENTRYPOINT ["figlet", "Hello, world!"]

    Once created, a Podman image can be published, which means that image can be used on any number of machines when it's pulled down from a container registry, such as Quay.io or Docker Hub.

    Running a container

    For this example, I use the popular open source project Uptime-Kuma. Here's a simple example of how easy it can be to get started running a container:

    podman run -d --name uptime-kuma -p 3001:3001 \
    docker.io/louislam/uptime-kuma:2
    • -d: Runs the container in "detached" mode
    • -p: Publishes port 3001 on your machine to port 3001 in the container
    • docker.io/louislam/uptime-kuma:2: The image name in the format of registry/namespace/repository:tag

    However, because no volumes are mounted, if you recreate the container (such as during an upgrade, where you pull down a new image), you will lose your data.

    You need a volume mapping (-v) to mount a source folder from your host machine to the container (an example command for this is shown in the next section).

    By default, Podman is daemonless. This has the benefit of not being one monolithic service. If Podman had one single monolithic daemon, and that daemon crashed, it could take down every container with it.

    Updating a container created on the command line

    To update a container, stop and remove the container. Then pull the new updated image and run it (make sure the appropriate volume mount is added). For example:

    podman stop uptime-kuma
    podman rm uptime-kuma
    podman pull docker.io/louislam/uptime-kuma:2
    podman run -d \
        --name uptime-kuma \
        -p 3001:3001 \
        --restart always \
        -v ~/uptime-kuma-data:/app/data:z \
        docker.io/louislam/uptime-kuma:2

    Notice that for this command, I use volume mapping. Before doing this, ensure the directory is already created, and the :z label is added if running on a machine with SELinux (for example, RHEL, Fedora, and so on). This also assumes you had this mounted on the container before updating. Mounting a volume like this after the fact doesn't copy the files!

    Running a container with podman-compose

    The podman-compose command provides a simple way to run containers declaratively using YAML. Install it with dnf:

    dnf install podman-compose

    Some people prefer to structure applications into multiple containers running alongside one another, rather than trying to fit technically unrelated applications into a single container. Because each container is defined by a YAML file, you can manage your infrastructure with a good version control system, like Git.Some people find it easier to understand, and better to run, with stacks of multiple containers, such as using a database alongside a main container. They can also be managed with version control, such as Git.

    Save this as podman-compose.yml in your project directory:

    services:
      uptime-kuma:
        image: docker.io/louislam/uptime-kuma:2
        restart: always
        container_name: uptime-kuma
        volumes:
          - ~/uptime-kuma-data:/app/data:z
        ports:
          - "3001:3001"

    Run it using podman-compose:

    podman-compose up -d

    Updating a container created with podman-compose

    You can update a container using podman-compose in just 2 commands. First, ensure you're in the project directory, then pull the new image (replacing the tag as necessary) and recreate it!

    podman-compose pull
    podman-compose up -d --force-recreate

    Persistence

    Because Podman is daemonless, a container doesn't start on boot by default. Instead, you can enable "lingering" and then use the podman-restart service to automatically start containers. When you set a user's systemd to linger on boot, you allow systemd to manage containers as that user:

    loginctl enable-linger $USER

    To enable the podman-restart service, which starts a container according to its restart policy, use systemctl:

    systemctl --user enable podman-restart.service

    A container managed this way is started according to its restart policy, so make sure it's set to always. A container doesn't start on boot with its default value of no.

    Further reading

    There are yet more ways to use containers. Here are some other methods to check out:

    • Podman Desktop
    • Cockpit lets you manage your containers from a web UI
    • Podman Quadlets uses systemd to manage each of your containers
    • My personal favorite is using Red Hat Ansible Automation Platform to manage and deploy Podman Quadlets

    Get started with Red Hat OpenShift

    Red Hat Training and Certification provides comprehensive curriculum designed to empower both new and experienced professionals in OpenShift. If you're new to containers, start with our no-cost Red Hat OpenShift for Developers Technical Overview (DO088) on-demand video. Once you've mastered the basics, you're ready to take the next step with Red Hat OpenShift Development I: Introduction to Containers with Podman (DO188).

    Related Posts

    • What's new in Red Hat build of Podman Desktop 1.2

    • Managing and monitoring Podman Quadlet in the Red Hat Enterprise Linux web console

    • How to manage RHEL virtual machines with Podman Desktop

    • Introducing image mode for RHEL and bootable containers in Podman Desktop

    Recent Posts

    • How to inspect, test, and debug MCP servers in Red Hat OpenShift console

    • Getting started with containers using Podman

    • How asago bridges the gaps in AI agent security

    • GitOps Promoter: Declare, deploy, deliver

    • Securing third-party AI agents on Red Hat AI with OpenShell

    What’s up next?

    Learning Path Containers podman feature image

    Container development using Podman, Podman Desktop, and Kubernetes

    Podman Desktop is a lightweight and efficient tool for managing containers...
    Red Hat Developers logo

    Platforms

    • Red Hat AI
    • Red Hat Enterprise Linux
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products

    Build

    • Developer Sandbox
    • Developer tools
    • Interactive tutorials
    • API catalog

    Quicklinks

    • Learning resources
    • E-books
    • Cheat sheets
    • Blog
    • Events
    • Newsletter

    Communicate

    • About us
    • Contact sales
    • Find a partner
    • Report a website issue
    • Site status dashboard
    • Report a security problem

    Red Hat Developer

    Build here. Go anywhere.

    We serve the builders. The problem solvers who create careers with code.

    Join us if you’re a developer, software engineer, web designer, front-end designer, UX designer, computer scientist, architect, tester, product manager, project manager or team lead.

    Sign me up

    Red Hat legal and privacy links

    • About Red Hat
    • Jobs
    • Events
    • Locations
    • Contact Red Hat
    • Red Hat Blog
    • Inclusion at Red Hat
    • Cool Stuff Store
    • Red Hat Summit
    © 2026 Red Hat

    Red Hat legal and privacy links

    • Privacy statement
    • Terms of use
    • All policies and guidelines
    • Digital accessibility
    Ask AI