From 19be5d4a528b425ca9cc0ee483bb578b56f773ff Mon Sep 17 00:00:00 2001
From: pat-s <patrick.schratz@gmail.com>
Date: Sun, 14 Jun 2026 11:12:33 +0200
Subject: [PATCH] docs(local): document docker-container driver for buildx
 builders

---
 justfile | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/justfile b/justfile
index 06f2200..b70f549 100644
--- a/justfile
+++ b/justfile
@@ -7,9 +7,11 @@
 # refreshed so the result is immediately servable.
 #
 # Prerequisites:
-#   - buildx builders named `artemis` (amd64) and `gaia` (arm64), e.g.
-#       docker buildx create --name artemis --node artemis ssh://<host-amd64>
-#       docker buildx create --name gaia    --node gaia    ssh://<host-arm64>
+#   - buildx builders named `artemis` (amd64) and `gaia` (arm64), created with the
+#     docker-container driver (runs BuildKit on the remote host's docker daemon over
+#     SSH). The default `remote` driver does NOT work with an ssh:// docker host.
+#       docker buildx create --name artemis --driver docker-container ssh://<user@host-amd64>
+#       docker buildx create --name gaia    --driver docker-container ssh://<user@host-arm64>
 #   - exported secrets: B2_S3_ACCESS_KEY, B2_S3_SECRET_KEY, PGPASS (GITHUB_PAT optional)
 #
 # Overridable (env or `just VAR=… rebuild …`):