diff --git a/README.md b/README.md
index 816df45c9..5be01dfb4 100644
--- a/README.md
+++ b/README.md
@@ -162,6 +162,15 @@ To start developing YaCy in Netbeans:
 - Open the project (File → Open Project)
 - you may directly use all the Netbeans build feature.
 
+To start developing YaCy in IntelliJ IDEA
+
+- clone https://github.com/yacy/yacy_search_server.git
+- File -> New -> Project from Version Control -> URL (see above) -> Clone
+- Open or Import Project -> Gradle project -> OK
+- In the Gradle tab you can now execute the gradle tasks to build YaCy
+- Run via IDE -> Add Configuration -> + -> Gradle -> in Run Tasks add:  build run
+   - (in above line "build" is needed to make sure all needed Gradle tasks are executed before run)
+
 To join our development community, got to https://searchlab.eu
 
 Send pull requests to https://github.com/yacy/yacy_search_server