diff --git a/BUILDING_ON_FREEBSD.md b/BUILDING_ON_FREEBSD.md
new file mode 100644
index 000000000..796317931
--- /dev/null
+++ b/BUILDING_ON_FREEBSD.md
@@ -0,0 +1,17 @@
+# FreeBSD
+
+Note on Qt version compatibility: If you are installing Qt from a package manager, please ensure the version you are installing is at least **Qt 5.10 or newer**.
+
+## FreeBSD 12.1-RELEASE
+
+Note: This is known to work on FreeBSD 12.1-RELEASE amd64. Chances are
+high that this also works on older FreeBSD releases, architectures and
+FreeBSD 13.0-CURRENT.
+
+1. Install build dependencies from package sources (or build from the
+   ports tree): `# pkg install qt5-core qt5-multimedia qt5-svg
+   qt5-qmake qt5-buildtools gstreamer-plugins-good boost-libs
+   rapidjson`
+1. go into project directory
+1. create build folder `$ mkdir build && cd build`
+1. `$ qmake .. && make`
diff --git a/README.md b/README.md
index a0fc71be7..f39e14427 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,8 @@ git submodule update --init --recursive
 
 [Building on Mac](../master/BUILDING_ON_MAC.md)
 
+[Building on FreeBSD](../master/BUILDING_ON_FREEBSD.md)
+
 ## Code style
 The code is formatted using clang format in Qt Creator. [.clang-format](src/.clang-format) contains the style file for clang format.