diff --git a/doc/eclipse/1_Install_New_Software.png b/doc/eclipse/1_Install_New_Software.png
new file mode 100644
index 000000000..a3e9d3619
Binary files /dev/null and b/doc/eclipse/1_Install_New_Software.png differ
diff --git a/doc/eclipse/2_Install_software.png b/doc/eclipse/2_Install_software.png
new file mode 100644
index 000000000..b7baadaa9
Binary files /dev/null and b/doc/eclipse/2_Install_software.png differ
diff --git a/doc/eclipse/eclipse.md b/doc/eclipse/eclipse.md
new file mode 100644
index 000000000..a2b237887
--- /dev/null
+++ b/doc/eclipse/eclipse.md
@@ -0,0 +1,34 @@
+using Eclipse with Arduino ESP8266
+===========================================
+
+### What to Download ###
+- [arduino IDE](https://www.arduino.cc/en/Main/Software)
+- [Eclipse IDE for C/C++ Developers](http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/marsr)
+- [Java](http://www.java.com/)
+
+### Setup Arduino ###
+ see the [Readme](https://github.com/esp8266/Arduino#installing-with-boards-manager)
+ 
+### Setup Eclipse ###
+- [step 1](http://www.baeyens.it/eclipse/how_to.shtml#/c)
+- [step 2](http://www.baeyens.it/eclipse/how_to.shtml#/e)
+- go to Window --> preferences --> Arduino
+- add as private hardware path the Part to the ESP8266 (example: C:\Users\username\AppData\Roaming\Arduino15\packages\esp8266\hardware\esp8266)
+
+### Eclipse wont build ###
+if eclipse dont find the path to the Compiler add to the platform.txt 
+after:
+```
+version=1.6.4
+```
+this:
+```
+runtime.tools.xtensa-lx106-elf-gcc.path={runtime.platform.path}/../../../tools/xtensa-lx106-elf-gcc/1.20.0-26-gb404fb9
+runtime.tools.esptool.path={runtime.platform.path}/../../../tools/esptool/0.4.4
+```
+Note: 
+ - the path may changed, check the current version.
+ - each update over the Arduino IDE will remove the fix
+ - may not needed in future if Eclipse Plugin get an Update
+
+ 
\ No newline at end of file