diff --git a/README.asciidoc b/README.asciidoc
index 820946a0..745968c5 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -206,6 +206,27 @@ pkg install kakoune
 --------------------------------------------------
 ====
 
+[TIP]
+.OpenBSD
+====
+Building on OpenBSD 6.6 amd64.
+
+--------------------------------------------------
+# pkg_add git gmake
+# git clone https://github.com/mawww/kakoune
+# cd kakoune
+# export CXX=clang++
+# gmake install
+--------------------------------------------------
+
+Running with support for plugins.
+--------------------------------------------------
+# pkg_add dash
+$ export KAKOUNE_POSIX_SHELL=/usr/local/bin/dash 
+$ kak
+--------------------------------------------------
+====
+
 [TIP]
 .Solus
 ====