diff --git a/HACKING.md b/HACKING.md
index 645e1adb..f247a892 100644
--- a/HACKING.md
+++ b/HACKING.md
@@ -72,3 +72,14 @@ make a copy of one of the sample scripts and rename it. Then run this command:
 ``` shell
 sudo systemctl enable voice-recognizer.service
 ```
+
+## Troubleshooting
+
+If you see an error like:
+
+``` shell
+ALSA lib pcm.c:8403:(snd_pcm_set_params) Rate doesn't match (requested 16000Hz, get 48000Hz)
+```
+
+Try running `cp /etc/asound.conf ~/.asoundrc`. For more details, [see this GitHub
+issue](https://github.com/google/aiyprojects-raspbian/issues/183).