1---2name: devops-docker3description: Use when configuring Docker Engine (daemon.json, logging, storage, live-restore), writing Compose files, building images with BuildKit/Buildx (multi-stage, cache mounts, multi-platform, SBOM/provenance, Bake), publishing ports safely next to a host firewall (iptables, experimental nftables backend, ufw/firewalld), running a private registry, signing images with cosign, running daemonless containers with Podman/Quadlet, or troubleshooting/cleaning a container host. Not for Kubernetes (devops-kubernetes), CI pipelines (devops-cicd), dependency vulnerability audits (fuse-security:dependency-audit) or Swarm.4versions:5 docker-engine: "29.9.3"6 docker-compose: "5.7.0"7 buildkit: "0.34.2"8 buildx: "0.38.2"9 podman: "6.1.4"10 cosign: "3.1.4"11 distribution-registry: "3.1.2"12user-invocable: true13references:14 - references/engine-daemon-config.md15 - references/compose-v5.md16 - references/buildkit-dockerfile.md17 - references/networking-firewall.md18 - references/registries-supply-chain.md19 - references/podman-quadlet.md20 - references/runtime-troubleshooting.md21 - references/safe-ops.md22 - references/templates/daemon-json.md23 - references/templates/dockerfile-hardened.md24 - references/templates/compose-production.md25 - references/templates/bake-and-sign.md26 - references/templates/quadlet-units.md27related-skills:28 - devops-kubernetes29 - devops-cicd30 - devops-linux31 - devops-networking32 - devops-secrets33 - devops-observability34 - devops-storage-backup35 - devops-sre-ops36 - fuse-security:dependency-audit37metadata:38 source: https://skillmd.com/skills/fusengine/devops-docker39---4041<objective>42Covers a container host end to end: Engine daemon config, Compose v5, BuildKit/Buildx43builds (multi-stage, multi-platform, attestations, Bake), networking versus the host44firewall, registries, cosign signing, Podman/Quadlet, troubleshooting and safe cleanup.45Not covered: Kubernetes (devops-kubernetes), CI pipelines (devops-cicd), host nftables46design (devops-networking), secret stores (devops-secrets), CVE audits47(fuse-security:dependency-audit), Swarm.48</objective>4950# Docker, Compose, BuildKit and Podman5152## Agent Workflow (MANDATORY)5354Before ANY container change, spawn in parallel, one `Agent` call each with a `name`:55561. **fuse-ai-pilot:explore-codebase** - find `Dockerfile*`, `compose*.yaml`, `docker-bake.hcl`, `daemon.json`, Quadlet units572. **fuse-ai-pilot:research-expert** - re-check the versions in the frontmatter at docs.docker.com and the GitHub releases583. **mcp__context7__query-docs** (`/docker/docs`, `/docker/compose`) - confirm every flag or key you are about to write5960On a live host, inspect read-only first (`docker version`, `docker info`, `docker compose ls`, `docker system df`). After changes, run **fuse-ai-pilot:sniper**.6162---6364## Overview6566| Area | What matters in 2026 |67|------|----------------------|68| **Engine 29** | containerd image store is the default on fresh installs only; cgroup v1 deprecated; Docker Content Trust removed from the CLI |69| **Compose v5** | internal builder removed, builds go through Bake; top-level `version:` is obsolete |70| **BuildKit / Buildx** | min-mode provenance added by default; SBOM is opt-in; Bake files drive multi-target builds |71| **Firewall** | iptables is the default backend; nftables backend (`firewall-backend`) is experimental, no `DOCKER-USER` chain, not usable in Swarm |72| **Supply chain** | cosign v3 stores signatures as OCI 1.1 referrers and uses the bundle format by default |73| **Podman 6 / Quadlet** | `.container`/`.network`/`.volume` units generated into systemd services |7475---7677## Critical Rules78791. **Never invent a flag or key** - `dockerd --validate --config-file=...` and `docker compose config -q` prove syntax before any restart or `up`.802. **Published ports bypass ufw** - Docker's `nat` rules divert traffic before ufw's `INPUT` chain; bind to `127.0.0.1` or filter in `DOCKER-USER` (iptables) or your own nftables table.813. **Do not edit Docker's own firewall tables or chains** - Docker owns them and rewrites them.824. **Destructive commands are proposed, never run on your own** - prune, `volume rm`, `compose down -v`, `podman system reset`: list what goes, state the effect, wait for the user's explicit go ([safe-ops.md](references/safe-ops.md)).835. **Secrets never in `ENV`, `ARG` or image layers** - use build secret mounts and Compose `secrets:`; `mode=max` provenance exposes build args.846. **Sign and deploy by digest, not tag** - tags move; cosign signs `image@sha256:...`.857. **Read the release notes before a minor upgrade** - live-restore only survives patch upgrades, not `YY.MM` jumps.8687---8889## Architecture9091```92/etc/docker/daemon.json # engine config (validate before restart)93project/{Dockerfile,.dockerignore,docker-bake.hcl,compose.yaml,secrets/} # secrets/ never committed94~/.config/containers/systemd/ # rootless Quadlet units (Podman)95```9697---9899## Reference Guide100101### Concepts102103| Topic | Reference | When to Consult |104|-------|-----------|-----------------|105| **Daemon config** | [engine-daemon-config.md](references/engine-daemon-config.md) | daemon.json, logging, storage, live-restore, rootless |106| **Compose v5** | [compose-v5.md](references/compose-v5.md) | healthchecks, depends_on, profiles, secrets, limits |107| **BuildKit** | [buildkit-dockerfile.md](references/buildkit-dockerfile.md) | multi-stage, cache mounts, multi-platform, SBOM, Bake |108| **Networking** | [networking-firewall.md](references/networking-firewall.md) | bridge/macvlan, published ports, ufw, nftables backend |109| **Registries** | [registries-supply-chain.md](references/registries-supply-chain.md) | registry:3, mirrors, cosign sign/verify, digests |110| **Podman** | [podman-quadlet.md](references/podman-quadlet.md) | rootless, Quadlet units, auto-update |111| **Troubleshooting** | [runtime-troubleshooting.md](references/runtime-troubleshooting.md) | OOM, unhealthy loops, disk usage, events |112| **Safe ops** | [safe-ops.md](references/safe-ops.md) | any prune/rm/down -v/reset |113114### Templates115116| Template | When to Use |117|----------|-------------|118| [daemon-json.md](references/templates/daemon-json.md) | Baseline `/etc/docker/daemon.json` for a server |119| [dockerfile-hardened.md](references/templates/dockerfile-hardened.md) | Multi-stage, non-root, cache-mounted Dockerfile |120| [compose-production.md](references/templates/compose-production.md) | Compose app with healthchecks, limits, secrets |121| [bake-and-sign.md](references/templates/bake-and-sign.md) | Multi-arch Bake build + attestations + cosign sign/verify |122| [quadlet-units.md](references/templates/quadlet-units.md) | Rootless Podman service as systemd units |123124---125126## Quick Reference127128```bash129docker version && docker info -f '{{ .DriverStatus }}' # engine + storage backend130dockerd --validate --config-file=/etc/docker/daemon.json # before any restart131docker compose config -q && docker compose up -d --wait # validate, then start until healthy132docker buildx bake --print # resolved build plan, builds nothing133docker system df -v # what uses the disk (read-only)134```135136---137138## Best Practices139140### DO141- Pin base images by digest in production and rebuild on a schedule for patched layers142- Set `log-driver: local` (rotated by default) or `max-size`/`max-file` on `json-file`143- Give every long-running service a healthcheck and memory/pids limits144- Prefer named volumes or explicit bind mounts for data; anonymous volumes are not reattached by a new `up`145146### DON'T147- Expose the Docker socket or add users to the `docker` group casually - it grants root-level privileges148- Set `"iptables": false` to "fix" ufw - it breaks masquerading and exposes container ports to the LAN149- Run `docker system prune -a --volumes` on a host that holds data150- Assume Compose `depends_on` waits for readiness without `condition: service_healthy`