diff --git a/README.md b/README.md
index 57a6d66c..4825795e 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ Most of the framework is implemented. Most noticable is the missing analogWrite.
 
 ### Using through Arduino IDE
 
-###[Instructions for Windows](doc/windows.md)
+#### [Instructions for Windows](doc/windows.md)
 
 #### Instructions for Mac
 - Install latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software)
@@ -58,6 +58,21 @@ Most of the framework is implemented. Most noticable is the missing analogWrite.
   ```
 - Restart Arduino IDE
 
+#### Instructions for Fedora
+- Install the latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software). `$ sudo dnf -y install arduino` will most likely install an older release.
+- Open Terminal and execute the following command (copy->paste and hit enter):
+
+  ```bash
+  sudo usermod -a -G dialout $USER && \
+  sudo dnf install git python3-pip python3-pyserial && \
+  mkdir -p ~/Arduino/hardware/espressif && \
+  cd ~/Arduino/hardware/espressif && \
+  git clone https://github.com/espressif/arduino-esp32.git esp32 && \
+  cd esp32/tools/ && \
+  python get.py
+  ```
+- Restart Arduino IDE
+
 #### Decoding exceptions
 
 You can use [EspExceptionDecoder](https://github.com/me-no-dev/EspExceptionDecoder) to get meaningful call trace.