From defd5d48a1bdd256aaafe7c2db808a657e8de8b0 Mon Sep 17 00:00:00 2001 From: earapo13 Date: Mon, 24 Aug 2026 05:27:00 -0700 Subject: [PATCH] docs: clarify that Coder server should run on a separate machine (#27468) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes [DOCS-600](https://linear.app/codercom/issue/DOCS-600/make-it-clear-in-the-quickstart-that-you-should-install-the-coder). The Quickstart guide has readers install and run `coder server` on the same machine they're working from, without calling out that this is only for a quick trial. Coder's actual value comes from remote development, so hosting the Coder server on a separate machine has a lot more power than running it locally. This adds two notes to `docs/get-started/index.md`: - In **Prerequisites**, explaining that this quickstart runs the server locally for convenience, but a real deployment should host it on a separate machine, and linking to the [Install](https://coder.com/docs/install) page. - In **Step 2: Install and start Coder**, a shorter reminder right before the install commands. ---- Created using Coder Agents 🤖 --------- Co-authored-by: Nick Vigilante --- docs/get-started/index.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/get-started/index.md b/docs/get-started/index.md index 221dee2f895..ffb96db26b8 100644 --- a/docs/get-started/index.md +++ b/docs/get-started/index.md @@ -30,10 +30,21 @@ explained through a cooking analogy: ## Prerequisites -- A machine with 2+ CPU cores and 4GB+ RAM +- A machine with 2+ CPU cores and 4GB+ RAM (ideally a separate machine or VM, not your primary dev machine) - Familiarity with running commands in the terminal - 10 minutes of your time +
+Why a separate machine? + +Coder's value comes from remote development. +Hosting the Coder server on a separate machine, such as a cloud VM, a spare desktop, or on-premises hardware, gives you and your team infrastructure that's more powerful, always-on, and reachable from anywhere, instead of tying your dev environment to your own laptop. + +When you're ready to move past this tutorial, install the Coder server on a separate machine and connect to it remotely. +Refer to the [Install guide](../install/index.md) for supported platforms and installation methods. + +
+ > [!TIP] > If you use a coding agent like Claude Code, the [coder/skills](https://github.com/coder/skills) `setup` skill can train the coding agent on the following steps (install a container runtime, install Coder, create your first template, and launch a workspace).