diff --git a/docs/configuration.md b/docs/configuration.md
index 7fcc5c7e..4e82f5ca 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -17,6 +17,11 @@ Alternatively, you can use the environment variable `TUWUNEL_CONFIG` to specify
 the config file to used. Conduit's environment variables are supported for 
 backwards compatibility.
 
+> [!IMPORTANT]
+> It is bad practice to uncomment default options without changing them. Many
+> defaults are updated by developers as features evolve and can be essential
+> to expected server function.
+
 ## Option commandline flag
 
 Tuwunel supports setting individual config options in TOML format from the