diff --git a/doc/HOMEASSISTANT.md b/doc/HOMEASSISTANT.md
index c3f0383..071085c 100644
--- a/doc/HOMEASSISTANT.md
+++ b/doc/HOMEASSISTANT.md
@@ -45,3 +45,6 @@ After you've sent the registration request, you will receive a token via SMS for
 e.g:
 
 ```curl -X POST -H "Content-Type: application/json" 'http://127.0.0.1:8080/v1/register/+431212131491291/verify/123-456'```
+
+# Troubleshooting
+In case you've problems with the `signal-cli-rest-api` container, have a look [here](TROUBLESHOOTING.md)
diff --git a/doc/TROUBLESHOOTING.md b/doc/TROUBLESHOOTING.md
index ec227c6..05f1959 100644
--- a/doc/TROUBLESHOOTING.md
+++ b/doc/TROUBLESHOOTING.md
@@ -1,3 +1,3 @@
-# The signal-cli-rest-api docker container won't start
+## The signal-cli-rest-api docker container won't start (signal_messenger_signal-cli-rest-api_1 exited with code 0)
 
-If your docker container stops with `signal_messenger_signal-cli-rest-api_1 exited with code 0`, make sure that the host port isn't already occupied by another process (see #2).
+If your docker container stops with `signal_messenger_signal-cli-rest-api_1 exited with code 0`, make sure that the host port isn't already occupied by another process (see [here](https://github.com/bbernhard/signal-cli-rest-api/issues/2)).