diff --git a/README.md b/README.md
index 1182f55..a55e93c 100644
--- a/README.md
+++ b/README.md
@@ -7,9 +7,22 @@ Simplistic static site generator
 
 `cd hydrogen && pip install -r requirements`  
 
-_put some Markdown files into the `content` directory_  
+_put some Markdown files into the `content` directory._  
+
 `./hydrogen.py`  
 
+_the `public` directory is ready to be published._
+
+## Building and running in Docker
+`git clone https://git.exocortex.ru/Exocortex/hydrogen.git`  
+
+`cd hydrogen && docker buildx build --tag hydrogen .`  
+
+_put some Markdown files into the `content` directory_  
+
+`docker run -v .:/app hydrogen`  
+
+_the `public` directory is ready to be published._  
 
 ## Conventions / expectations
 `hydrogen` expects the following files in the `content` directory: