From 00d292d764935d7afcd5b66b49cc8e1d5c5b3631 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 19 Mar 2026 10:31:32 -0500 Subject: [PATCH] docs: remove EC2 install guide and rename AWS marketplace doc (#23298) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Summary - **Removed** `docs/install/cloud/ec2.md` — the standalone EC2 install guide. - **Renamed** `docs/install/cloud/aws-mktplc-ce.md` → `docs/install/cloud/aws-marketplace.md` for a clearer, more discoverable filename. - **Updated** `docs/manifest.json`: replaced the "AWS EC2" entry with "AWS Marketplace" pointing to the renamed file. - **Updated** `docs/install/cloud/index.md`: fixed the internal link to the renamed file. --- .../{aws-mktplc-ce.md => aws-marketplace.md} | 0 docs/install/cloud/ec2.md | 90 ------------------- docs/install/cloud/index.md | 2 +- docs/manifest.json | 6 +- 4 files changed, 4 insertions(+), 94 deletions(-) rename docs/install/cloud/{aws-mktplc-ce.md => aws-marketplace.md} (100%) delete mode 100644 docs/install/cloud/ec2.md diff --git a/docs/install/cloud/aws-mktplc-ce.md b/docs/install/cloud/aws-marketplace.md similarity index 100% rename from docs/install/cloud/aws-mktplc-ce.md rename to docs/install/cloud/aws-marketplace.md diff --git a/docs/install/cloud/ec2.md b/docs/install/cloud/ec2.md deleted file mode 100644 index 58c73716b4..0000000000 --- a/docs/install/cloud/ec2.md +++ /dev/null @@ -1,90 +0,0 @@ -# Amazon Web Services - -This guide is designed to get you up and running with a Coder proof-of-concept -VM on AWS EC2 using a [Coder-provided AMI](https://github.com/coder/packages). -If you are familiar with EC2 however, you can use our -[install script](../cli.md) to run Coder on any popular Linux distribution. - -## Requirements - -This guide assumes your AWS account has `AmazonEC2FullAccess` permissions. - -## Launch a Coder instance from the from AWS Marketplace - -We publish an Ubuntu 22.04 AMI with Coder and Docker pre-installed. Search for -`Coder` in the EC2 "Launch an Instance" screen or -[launch directly from the marketplace](https://aws.amazon.com/marketplace/pp/prodview-zaoq7tiogkxhc). - -![Coder on AWS Marketplace](../../images/platforms/aws/marketplace.png) - -Be sure to keep the default firewall (SecurityGroup) options checked so you can -connect over HTTP, HTTPS, and SSH. - -![AWS Security Groups](../../images/platforms/aws/security-groups.png) - -We recommend keeping the default instance type (`t2.xlarge`, 4 cores and 16 GB -memory) if you plan on provisioning Docker containers as workspaces on this EC2 -instance. Keep in mind this platforms is intended for proof-of-concept -deployments and you should adjust your infrastructure when preparing for -production use. See: [Scaling Coder](../../admin/infrastructure/index.md) - -Be sure to add a keypair so that you can connect over SSH to further -[configure Coder](../../admin/setup/index.md). - -After launching the instance, wait 30 seconds and navigate to the public IPv4 -address. You should be redirected to a public tunnel URL. - - - -That's all! Use the UI to create your first user, template, and workspace. We -recommend starting with a Docker template since the instance has Docker -pre-installed. - -![Coder Workspace and IDE in AWS EC2](../../images/platforms/aws/workspace.png) - -## Configuring Coder server - -Coder is primarily configured by server-side flags and environment variables. -Given you created or added key-pairs when launching the instance, you can -[configure your Coder deployment](../../admin/setup/index.md) by logging in via -SSH or using the console: - - - -```sh -ssh ubuntu@ -sudo vim /etc/coder.d/coder.env # edit config -sudo systemctl daemon-reload -sudo systemctl restart coder # restart Coder -``` - -## Give developers EC2 workspaces (optional) - -Instead of running containers on the Coder instance, you can offer developers -full EC2 instances with the -[aws-linux](https://github.com/coder/coder/tree/main/examples/templates/aws-linux) -template. - -Before you add the AWS template from the dashboard or CLI, you'll need to modify -the instance IAM role. - -![Modify IAM role](../../images/platforms/aws/modify-iam.png) - -You must create or select a role that has `EC2FullAccess` permissions or a -limited -[Coder-specific permissions policy](https://github.com/coder/coder/tree/main/examples/templates/aws-linux#required-permissions--policy). - -From there, you can import the AWS starter template in the dashboard and begin -creating VM-based workspaces. - -![Modify IAM role](../../images/platforms/aws/aws-linux.png) - -### Next steps - -- [IDEs with Coder](../../user-guides/workspace-access/index.md) -- [Writing custom templates for Coder](../../admin/templates/index.md) -- [Configure the Coder server](../../admin/setup/index.md) -- [Use your own domain + TLS](../../admin/setup/index.md#tls--reverse-proxy) diff --git a/docs/install/cloud/index.md b/docs/install/cloud/index.md index 28dc1924a4..6271fe9b85 100644 --- a/docs/install/cloud/index.md +++ b/docs/install/cloud/index.md @@ -9,7 +9,7 @@ cloud of choice. We publish Coder Community Edition on the AWS Marketplace. Follow the tutorial here: -- [Install Coder Community Edition from AWS Marketplace](./aws-mktplc-ce.md) +- [Install Coder Community Edition from AWS Marketplace](./aws-marketplace.md) Alternatively, install the [CLI binary](../cli.md) on any Linux machine or follow our [Kubernetes](../kubernetes.md) documentation to install Coder on an diff --git a/docs/manifest.json b/docs/manifest.json index 170de644c9..0da274a620 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -137,9 +137,9 @@ "icon_path": "./images/icons/cloud.svg", "children": [ { - "title": "AWS EC2", - "description": "Install Coder on AWS EC2", - "path": "./install/cloud/ec2.md" + "title": "AWS Marketplace", + "description": "Install Coder via AWS Marketplace", + "path": "./install/cloud/aws-marketplace.md" }, { "title": "GCP Compute Engine",