Podman User's Guide
- Product:
- Oracle Linux Podman
- Document Type:
- User Guide
- Version:
- F30921-28 (December 2025)
- Last Publish Date:
- December 2025
- Tools Used:
- DITA XML, Oxygen XML, Git, Podman, Buildah, Skopeo
Overview
Oracle Linux Podman User’s Guide is the definitive documentation for Podman, the daemonless container engine for managing OCI-compliant containers and images on Oracle Linux. This guide covers Podman’s complete feature set along with companion tools Buildah (for advanced image building) and Skopeo (for remote image management). As the primary technical writer for the December 2025 update (F30921-28), I led a major modernization effort that restructured the guide using DITA XML data types, added comprehensive Oracle Linux 10 coverage, wrote new content for Kubernetes integration, and significantly rewrote multiple chapters.
Target Audience
Developers, system administrators, and DevOps engineers deploying containerized applications with Podman on Oracle Linux. Assumes familiarity with Linux system administration and container concepts.
My Recent Contributions (2025 Update)
DITA XML Restructuring
Transformed entire guide from legacy format to structured DITA architecture. Decomposed content into modular concept, task, and reference topics. Created logical DITA map structure optimizing content flow and navigation. Established conrefs and content references for multi-version documentation.
New Chapter: Kubernetes Integration
Wrote comprehensive “podman kube” chapter covering Kubernetes YAML generation and deployment. Documented Kubernetes manifest creation with detailed procedures for generating Kubernetes-compatible YAML from Podman pods. Covered bidirectional workflows (exporting Podman pods to Kubernetes and running Kubernetes YAML with Podman). Explained PersistentVolumeClaim handling and volume management. Provided procedures for using Podman to test Kubernetes manifests before cluster deployment.
Oracle Linux 10 Integration
Added complete installation and usage procedures for Oracle Linux 10. Documented Podman support with Unbreakable Enterprise Kernel 8. Created conditional content for Oracle Linux 8, 9, and 10 differences.
Major Content Rewrites
-
Completely rewrote the Buildah chapter focusing on advanced image building scenarios, updated for current Buildah feature set and best practices, new examples demonstrating Buildah advantages over podman build, expanded coverage of Containerfile processing, and integration with CI/CD pipelines.
-
Comprehensively revised the Skopeo chapter for remote registry management, updated commands and options for current Skopeo release, new use cases for bulk operations and registry migration, and registry authentication and security considerations.
-
Extensively rewrote the Podman Quadlets section covering modern approach to running containers as systemd services, configuration examples for production deployments, startup dependencies and service ordering, and conversion from older podman generate systemd method.
-
Significantly expanded the Private Container Registries section with step-by-step procedures for setting up private registries, authentication and access control configuration, TLS/SSL certificate management, and registry maintenance and troubleshooting.
Comprehensive Testing and Updates
Tested every command and procedure on Oracle Linux 8, 9, and 10. Revised all commands for current Podman, Buildah, and Skopeo releases. Updated command output examples to match current versions. Identified and corrected outdated external references. Fixed technical inaccuracies discovered during testing.
Documentation Challenges
Challenge 1: DITA Migration While Maintaining Currency
Restructuring to use DITA XML data types while simultaneously updating for Oracle Linux 10 and new features created complex coordination requirements.
Solution: Implemented phased approach. First migrated existing content to DITA establishing topic structure, then systematically updated topics with new content. Used DITA’s conditional processing to manage version-specific content from the start.
Challenge 2: Rapidly Evolving Container Technology
Podman, Buildah, and Skopeo undergo frequent updates with new features, changed defaults, and occasional breaking changes.
Solution: Established systematic testing framework covering all documented procedures across supported Oracle Linux versions. Maintained test environment matrices (OL 8/9/10 multiplied by UEK versions multiplied by Podman versions). Documented version-specific behaviors using DITA conditional processing where needed.
Important Note
The documentation has been updated since this work was done. Due to changes in direction, the book was merged into a single book that covers all Oracle Linux releases. The links to the live documentation no longer represent the work I did to generate a book for each Oracle Linux release, but do include the new technical content and DITA data typing.