diff --git a/readme.md b/readme.md
index ce590be6..95645864 100644
--- a/readme.md
+++ b/readme.md
@@ -59,7 +59,28 @@ The last step of the build process is copying the `bandplans` and `res` director
 If you followed the steps above, it should be `build/Release`.
 
 # Building on Linux
-comming soon :)
+## install requirements
+On Debian/Ubtuntu system:
+apt install libglew-dev libglfw3-dev libfftw3-dev libvolk1-dev portaudio19-dev libsoapysdr-dev gcc
+
+## The build
+```
+mkdir build
+cd build
+cmake ..
+make
+```
+
+## Modify root_dev/modules_list.json
+If the content is different than the following, change it.
+```
+{
+    "Radio": "./radio/radio.so",
+    "Recorder": "./recorder/recorder.so",
+    "Soapy": "./soapy/soapy.so",
+    "RTLTCPSource": "./rtl_tcp_source/rtl_tcp_source.so"
+}
+```
 
 # Building on OSX
 ## Install requirements
@@ -78,6 +99,17 @@ cmake ..
 cmake --build . --config Release
 ```
 
+## Modify root_dev/modules_list.json
+If the content is different than the following, change it.
+```
+{
+    "Radio": "./radio/radio.dylib",
+    "Recorder": "./recorder/recorder.dylib",
+    "Soapy": "./soapy/soapy.dylib",
+    "RTLTCPSource": "./rtl_tcp_source/rtl_tcp_source.dylib"
+}
+```
+
 # Contributing
 
 Feel free to issue pull request and report bugs via the github issues.