diff --git a/README.md b/README.md
index fcbe557b7..8ccc127f0 100755
--- a/README.md
+++ b/README.md
@@ -9,6 +9,7 @@ As the build process for ROS 2 and micro-ROS is based on custom meta-build syste
   - [How to use the precompiled library](#how-to-use-the-precompiled-library)
     - [Arduino IDE](#arduino-ide)
     - [PlatformIO](#platformio)
+      - [Known issues](#known-issues)
   - [How to build the precompiled library](#how-to-build-the-precompiled-library)
   - [Patch Arduino board for support precompiled libraries](#patch-arduino-board-for-support-precompiled-libraries)
     - [Patch Teensyduino](#patch-teensyduino)
@@ -86,6 +87,77 @@ pio run --target upload # Flash the firmware
 ```
 
 An example of a micro-ROS application using PlatformIO is available [here](https://github.com/husarion/micro_ros_stm32_template).
+
+#### Known issues
+
+- `multiple definition of` Link errors on galactic:
+
+  Create a python script fix_linker.py on your directory and modify the linker flags manually:
+  ```
+  Import("env")
+  env["_LIBFLAGS"] =  ('-Wl,--start-group -Wl,--whole-archive '
+                      '${_stripixes(LIBLINKPREFIX, LIBS, LIBLINKSUFFIX, LIBPREFIXES, '
+                      'LIBSUFFIXES, __env__)} -Wl,--no-whole-archive -lstdc++ '
+                      '-lsupc++ -lm -lc -lgcc -lnosys -lmicroros -Wl,--end-group')
+  ```
+
+  Now add it to your `platformio.ini` like this: `extra_scripts = fix_linker.py` and delete the `-l libmicroros` line on `build_flags`.
+
+  Related: https://github.com/micro-ROS/micro_ros_arduino/pull/848#issuecomment-1072196933, https://github.com/micro-ROS/micro_ros_arduino/issues/774
+
+- Arduino Portenta H7
+  - Follow **`multiple definition of` Link errors on galactic** modifications
+
+    Related: https://github.com/micro-ROS/micro_ros_arduino/issues/847
+
+- Arduino Nano RP2040 Connect
+
+  - The following versioning shall be used:
+    ```
+    lib_deps =
+      arduino-libraries/WiFiNINA@^1.8.13
+      ...
+
+    platform_packages =
+      toolchain-gccarmnoneeabi @ ~1.70201.0
+      framework-arduino-mbed @ ~2.4.1
+    ```
+
+  - Library dependency finder shall be set to `chain+`: `lib_ldf_mode = chain+`
+  - Follow **`multiple definition of` Link errors on galactic** modifications
+
+    Related: https://github.com/micro-ROS/micro_ros_arduino/issues/780
+
+- Arduino Due
+  - The following versioning shall be used:
+    ```
+    platform_packages =
+      toolchain-gccarmnoneeabi@<1.50000.0
+    ```
+
+    Related: https://github.com/micro-ROS/micro_ros_arduino/issues/698
+
+- ESP32 Dev Module
+  - Known issues with espressif32 arduino package, use `2.0.2` version:
+    ```
+    [env:esp32dev]
+    platform = https://github.com/platformio/platform-espressif32.git#feature/arduino-upstream
+    board = esp32dev
+    framework = arduino
+    lib_deps =
+        https://github.com/micro-ROS/micro_ros_arduino.git
+    build_flags =
+        -L ./.pio/libdeps/esp32dev/micro_ros_arduino/src/esp32/
+        -l microros
+        -D ESP32
+
+    platform_packages =
+      toolchain-xtensa32 @ ~2.80400.0
+      framework-arduinoespressif32@https://github.com/espressif/arduino-esp32.git#2.0.2
+    ```
+
+    Related: https://github.com/micro-ROS/micro_ros_arduino/issues/736, https://github.com/platformio/platform-espressif32/issues/616
+
 ## How to build the precompiled library
 
 ```bash