---
name: "podman-rootless-systemd-quadlet"
description: "Deploy daemonless, rootless containers managed natively as systemd services via Podman Quadlet."
metadata:
  author: "Containers"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write podman quadlet file"
  - "run podman as systemd service"
  - "configure podman auto-update"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Podman Rootless Containers & systemd Quadlets

Configures Podman: rootless execution, pod creation, converting containers into systemd services with Quadlet (.container and .kube files), auto-updates (podman auto-update), and migration from Docker.

## When to Invoke
Invoke this skill whenever you need to:
- write podman quadlet file
- run podman as systemd service
- configure podman auto-update

## Execution SOP & Rules
1. Write a .container file in ~/.config/containers/systemd/ specifying [Container] Image and Ports.
2. Run systemctl --user daemon-reload to let Quadlet compile files into native systemd units.
3. Start and enable service: systemctl --user enable --now myapp.service.
4. Check status with journalctl --user -u myapp.service -f.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.