Update installation guide with detailed steps

stirby · stirby · commit 51786ea40741 · 2024-09-05T15:29:55.000Z
Add detailed steps for installing Coder using different methods: - Single CLI for Coder server and client - Release channels: mainline and stable Installation methods: - For Linux/macOS: ```sh curl -L https://coder.com/install.sh | sh ``` - For Windows: - Available on [GitHub releases](https://github.com/coder/coder/releases) - Visual C++ Runtime required for PostgreSQL - Alternatively, use `winget`: ```powershell winget install Coder.Coder ``` Post-install steps: - Start Coder server: ```sh coder server ``` - Log in to existing deployment: ```sh coder login https://coder.example.com ``` Next steps: - [Create your first template](../templates/tutorial.md)
diff --git a/docs/install/README.md b/docs/install/README.md
@@ -1,5 +1,67 @@
 # Installing Coder
 
-TODO: Make this look great
+A single CLI (`coder`) is used for both the Coder server and the client.
+
+We support two release channels: mainline and stable - read the
+[Releases](./releases.md) page to learn more about which best suits your team.
+
+There are several ways to install Coder. For production deployments with 50+
+users, we recommend [installing on Kubernetes](./kubernetes.md). Otherwise, you
+can install Coder on your local machine or on a VM:
+
+<div class="tabs">
+
+## Linux/macOS
+
+Our install script is the fastest way to install Coder on Linux/macOS:
+
+```sh
+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).
+
+## Windows
+
+> **Important:** If you plan to use the built-in PostgreSQL database, you will
+> need to ensure that the
+> [Visual C++ Runtime](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist#latest-microsoft-visual-c-redistributable-version)
+> is installed.
+
+Use [GitHub releases](https://github.com/coder/coder/releases) to download the
+Windows installer (`.msi`) or standalone binary (`.exe`).
+
+![Windows setup wizard](../images/install/windows-installer.png)
+
+Alternatively, you can use the
+[`winget`](https://learn.microsoft.com/en-us/windows/package-manager/winget/#use-winget)
+package manager to install Coder:
+
+```powershell
+winget install Coder.Coder
+```
+
+## Other
 
 <children></children>
+
+</div>
+
+To start the Coder server:
+
+```sh
+coder server
+```
+
+![Coder install](../images/install/coder-setup.png)
+
+To log in to an existing Coder deployment:
+
+```sh
+coder login https://coder.example.com
+```
+
+## Next up
+
+- [Create your first template](../templates/tutorial.md)
