From 99e90bdcefdab86f5e8e498f0d623e89ff6b0834 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Va=CC=81clav=20Slavi=CC=81k?= <vaclav@slavik.io>
Date: Sat, 13 Jul 2024 14:50:59 +0200
Subject: [PATCH] Add instructions for running with Docker

---
 README | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README b/README
index fc6f1182..b01cfa12 100644
--- a/README
+++ b/README
@@ -9,6 +9,21 @@ somewhere and run the 'bkl' tool in its top directory.
 On Windows, you don't need anything else, bkl.exe is self-contained executable.
 On other systems, you must have Python 2.7 installed.
 
+ Running with Docker or Podman
+-------------------------------
+
+As an alternative to installing Bakefile on your system, you can use Docker
+or Podman to run Bakefile in a container. The following command will run
+Bakefile in a container and mount the current directory as a volume:
+
+    docker run --rm -v $(pwd):$(pwd) -w $(pwd) ghcr.io/vslavik/bakefile:1 foo.bkl
+
+If your bakefiles depend on files in parent directories, you can mount a larger
+part of local filesystem, even your entire home directory, like this:
+
+    docker run --rm -v $HOME:$HOME -w $(pwd) ghcr.io/vslavik/bakefile:1 [...args...]
+
+
 
   2. Documentation
 ====================