From 113b859927f52c95d1ee853425e4bdf2a6aa49c9 Mon Sep 17 00:00:00 2001
From: ducoterra <git@ducoterra.net>
Date: Thu, 13 Nov 2025 16:51:36 -0500
Subject: [PATCH] Clarify docker integration with podman on fedora

---
 active/os_fedora/fedora-kinoite.md  | 15 ++++++++++++++-
 active/os_fedora/fedora-software.md | 11 +++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/active/os_fedora/fedora-kinoite.md b/active/os_fedora/fedora-kinoite.md
index db6073f..b88e156 100644
--- a/active/os_fedora/fedora-kinoite.md
+++ b/active/os_fedora/fedora-kinoite.md
@@ -3,7 +3,7 @@
 - [Fedora Kinoite](#fedora-kinoite)
   - [TPM2 Luks Decryption](#tpm2-luks-decryption)
   - [Podman](#podman)
-    - [Autostarting services with quadlets](#autostarting-services-with-quadlets)
+    - [Docker Compose and Docker Buildkit with Rootless Podman](#docker-compose-and-docker-buildkit-with-rootless-podman)
   - [rpm-ostree](#rpm-ostree)
     - [Git, Vim, etc](#git-vim-etc)
     - [Libvirt, Qemu, KVM](#libvirt-qemu-kvm)
@@ -71,6 +71,19 @@ export REGISTRY_AUTH_FILE=$HOME/.podman-auth.json
 
 Source that and then run `podman login` to create the file.
 
+### Docker Compose and Docker Buildkit with Rootless Podman
+
+Allows you to use podman with full docker-compose compatibility.
+
+<https://emersion.fr/blog/2025/using-podman-compose-and-buildkit/>
+
+```bash
+rpm-ostree install docker-compose docker-buildx
+reboot
+systemctl --user enable --now podman.socket
+docker context create podman --docker host=unix://$XDG_RUNTIME_DIR/podman/podman.sock
+docker context use podman
+
 ### Autostarting services with quadlets
 
 If you want to run something as your user at boot (like a systemd process, think ollama) you can
diff --git a/active/os_fedora/fedora-software.md b/active/os_fedora/fedora-software.md
index 49e7f14..46e97cc 100644
--- a/active/os_fedora/fedora-software.md
+++ b/active/os_fedora/fedora-software.md
@@ -642,6 +642,17 @@ dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-co
 systemctl enable --now docker
 ```
 
+Or use docker with podman with full docker-compose compatibility.
+
+<https://emersion.fr/blog/2025/using-podman-compose-and-buildkit/>
+
+```bash
+dnf install -y docker-compose docker-buildx
+systemctl --user enable --now podman.socket
+docker context create podman --docker host=unix://$XDG_RUNTIME_DIR/podman/podman.sock
+docker context use podman
+```
+
 ## Boxes
 
 Virtualization at its boxiest.