diff --git a/docs/howto_build_without_openssl.md b/docs/howto_build_without_openssl.md
new file mode 100644
index 0000000000..939100b55b
--- /dev/null
+++ b/docs/howto_build_without_openssl.md
@@ -0,0 +1,9 @@
+# how to compile without OpenSSL
+
+You may find it desirable to compile nu shell without requiring an OpenSSL installation on your system.
+
+You can do this by runnning:
+```sh
+cargo build --no-default-features --features=rustyline-support
+```
+