diff --git a/docs/lineage/airflow.md b/docs/lineage/airflow.md
index ef3568b408..da7d4a625c 100644
--- a/docs/lineage/airflow.md
+++ b/docs/lineage/airflow.md
@@ -30,7 +30,7 @@ pip install acryl-datahub-airflow-plugin
 
 :::note
 
-The [DataHub Rest](../../metadata-ingestion/sink_docs/datahub.md#datahub-rest) emitter is included in the plugin package by default.  To use [DataHub Kafka](../../metadata-ingestion/sink_docs/datahub.md#datahub-kafka) install `pip install acryl-datahub-airflow-plugin[datahub-kafka]`.
+The [DataHub Rest](../../metadata-ingestion/sink_docs/datahub.md#datahub-rest) emitter is included in the plugin package by default. To use [DataHub Kafka](../../metadata-ingestion/sink_docs/datahub.md#datahub-kafka) install `pip install acryl-datahub-airflow-plugin[datahub-kafka]`.
 
 :::
 
@@ -145,6 +145,17 @@ Take a look at this sample DAG:
 
 In order to use this example, you must first configure the Datahub hook. Like in ingestion, we support a Datahub REST hook and a Kafka-based hook. See step 1 above for details.
 
+## Debugging
+
+### Incorrect URLs
+
+If your URLs aren't being generated correctly (usually they'll start with `http://localhost:8080` instead of the correct hostname), you may need to set the webserver `base_url` config.
+
+```ini title="airflow.cfg"
+[webserver]
+base_url = http://airflow.example.com
+```
+
 ## Additional references
 
 Related Datahub videos: