diff --git a/ports/esp32/Makefile b/ports/esp32/Makefile
index b7d804d073..e43cad751b 100644
--- a/ports/esp32/Makefile
+++ b/ports/esp32/Makefile
@@ -34,8 +34,10 @@ ifdef FROZEN_MANIFEST
        IDFPY_FLAGS += -D MICROPY_FROZEN_MANIFEST=$(FROZEN_MANIFEST)
 endif
 
+HELP_BUILD_ERROR ?= "See \033[1;31mhttps://github.com/micropython/micropython/wiki/Build-Troubleshooting\033[0m"
+
 all:
-	idf.py $(IDFPY_FLAGS) build
+	idf.py $(IDFPY_FLAGS) build || (echo -e $(HELP_BUILD_ERROR); false)
 	@$(PYTHON) makeimg.py \
 		$(BUILD)/sdkconfig \
 		$(BUILD)/bootloader/bootloader.bin \