diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..15bda1b
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,14 @@
+# Force LF line endings for shell scripts on all platforms.
+# Without this, git on macOS/Windows with core.autocrlf=true checks out
+# .sh files with CRLF, which causes bash to read variable names as
+# "VARNAME\r" and fail with "unbound variable" errors.
+*.sh    text eol=lf
+
+# Other text files — normalise to LF in the repo.
+*.rs    text eol=lf
+*.toml  text eol=lf
+*.md    text eol=lf
+*.yml   text eol=lf
+*.yaml  text eol=lf
+*.env*  text eol=lf
+Caddyfile text eol=lf