diff --git a/apps/docs/content/guides/self-hosting/docker.mdx b/apps/docs/content/guides/self-hosting/docker.mdx
index 3f0e7fc1701..22fdba57a4f 100644
--- a/apps/docs/content/guides/self-hosting/docker.mdx
+++ b/apps/docs/content/guides/self-hosting/docker.mdx
@@ -198,7 +198,7 @@ Access to Studio (Dashboard) is protected with **HTTP basic authentication**.
 
 <Admonition type="danger">
 
-    A secure password MUST be set before starting Supabase. The password must include at least one letter - do not use numbers only or any special characters.
+  A secure password MUST be set before starting Supabase. The password must include at least one letter - do not use numbers only or any special characters.
 
 </Admonition>
 
@@ -236,6 +236,12 @@ To stop Supabase, use:
 docker compose down
 ```
 
+<Admonition type="caution" label="Windows: CRLF line endings">
+
+  If the API gateway (Kong) fails to start with an entrypoint error, your local files may have been checked out with CRLF line endings instead of LF. Re-clone the repository, or normalize everything in the `docker/` directory to LF, then restart Supabase. Fresh clones should already use LF because of `.gitattributes`.
+
+</Admonition>
+
 ## Accessing Supabase Studio (Dashboard)
 
 By default, you can access the dashboard through the API gateway on port `8000`.
diff --git a/docker/.gitattributes b/docker/.gitattributes
new file mode 100644
index 00000000000..95aa9f91142
--- /dev/null
+++ b/docker/.gitattributes
@@ -0,0 +1,17 @@
+* text=auto
+
+*.md eol=lf
+
+*.env eol=lf
+.env.example eol=lf
+
+*.sh eol=lf
+*.sql eol=lf
+*.yml eol=lf
+*.yaml eol=lf
+*.ts eol=lf
+*.exs eol=lf
+*.conf eol=lf
+*.tpl eol=lf
+Caddyfile eol=lf
+Dockerfile* eol=lf