From 2e45236d316286e8fc11b4071d5d93ba27d5a9b2 Mon Sep 17 00:00:00 2001
From: david-fraley <67079030+david-fraley@users.noreply.github.com>
Date: Mon, 20 Oct 2025 06:49:06 -0500
Subject: [PATCH] docs: add warning around macOS install (#20253)

---
 docs/install/index.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/install/index.md b/docs/install/index.md
index 2fc04c186a..b7ba22da09 100644
--- a/docs/install/index.md
+++ b/docs/install/index.md
@@ -27,6 +27,23 @@ curl -L https://coder.com/install.sh | sh
 Refer to [GitHub releases](https://github.com/coder/coder/releases) for
 alternate installation methods (e.g. standalone binaries, system packages).
 
+> [!Warning]
+> If you're using an Apple Silicon Mac with ARM64 architecture, so M1/M2/M3/M4, you'll need to use an external PostgreSQL Database using the following commands:
+
+``` bash
+# Install PostgreSQL
+brew install postgresql@16
+
+# Start PostgreSQL
+brew services start postgresql@16
+
+# Create database
+createdb coder
+
+# Run Coder with external database
+coder server --postgres-url="postgres://$(whoami)@localhost/coder?sslmode=disable"
+```
+
 ## Windows
 
 If you plan to use the built-in PostgreSQL database, ensure that the