diff --git a/README.md b/README.md index d08b423d..f6c23e50 100644 --- a/README.md +++ b/README.md @@ -2,15 +2,16 @@ A collection of one-click buttons and scripts for deploying [code-server](https://github.com/cdr/code-server) to various cloud hosting platforms. The fastest way to get a code-server environment! ☁️ -| | Name | Type | Lowest-Price Plan | Deploy | -| --------------------------------------------------------------------------------------------------------------- | ----------------- | ------------- | ------------------------------------- | ------------------------------------------------------- | -| [![DigitalOcean](img/logo/digitalocean.png)](https://digitalocean.com) | DigitalOcean | VM | $5/mo, 1 CPU, 1 GB RAM | [see guide](guides/digitalocean.md) | -| [![Vultr](img/logo/vultr.png)](https://vultr.com) | Vultr | VM | $3.50/mo, 1 CPU, 512 MB RAM | coming soon | -| [![Linode](img/logo/linode.png)](https://linode.com) | Linode | VM | $5/mo, 1 CPU, 1 GB RAM | [see guide](guides/linode.md) | +| | Name | Type | Lowest-Price Plan | Deploy | +| --------------------------------------------------------------------------------------------------------------- | ----------------- | ------------- | ----------------------------- | ------------------------------------------------------- | +| [![AWS EC2](img/logo/aws-ec2.png)](https://digitalocean.com) | AWS EC2 | VM | Free Tier, 1 CPU, 1 GB RAM | [see guide](guides/aws-ec2.md) | +| [![DigitalOcean](img/logo/digitalocean.png)](https://digitalocean.com) | DigitalOcean | VM | $5/mo, 1 CPU, 1 GB RAM | [see guide](guides/digitalocean.md) | +| [![Vultr](img/logo/vultr.png)](https://vultr.com) | Vultr | VM | $3.50/mo, 1 CPU, 512 MB RAM | coming soon | +| [![Linode](img/logo/linode.png)](https://linode.com) | Linode | VM | $5/mo, 1 CPU, 1 GB RAM | [see guide](guides/linode.md) | | [![Railway](img/logo/railway.png)](https://railway.app) | Railway | Container | Free, Shared CPU, 1 GB RAM 🚀 | [see guide](guides/railway.md) | -| [![Heroku](img/logo/heroku.png)](https://heroku.com) | Heroku | Container | Free, 1 CPU, 512 MB RAM | [see guide](guides/heroku.md) | -| [![Azure App Service](img/logo/azure-app-service.png)](https://azure.microsoft.com/en-us/services/app-service/) | Azure App Service | Container | Free, 1 CPU, 1 GB RAM | [see guide](https://github.com/bpmct/code-server-azure) | -| [![Coder](img/logo/coder.png)](https://coder.com/docs) | Coder | Dev Workspace | For developer teams 👨🏼‍💻 | [read the docs](https://coder.com/docs) | +| [![Heroku](img/logo/heroku.png)](https://heroku.com) | Heroku | Container | Free, 1 CPU, 512 MB RAM | [see guide](guides/heroku.md) | +| [![Azure App Service](img/logo/azure-app-service.png)](https://azure.microsoft.com/en-us/services/app-service/) | Azure App Service | Container | Free, 1 CPU, 1 GB RAM | [see guide](https://github.com/bpmct/code-server-azure) | +| [![Coder](img/logo/coder.png)](https://coder.com/docs) | Coder | Dev Workspace | For developer teams 👨🏼‍💻 | [read the docs](https://coder.com/docs) | --- diff --git a/guides/aws-ec2.md b/guides/aws-ec2.md new file mode 100644 index 00000000..9ca1c211 --- /dev/null +++ b/guides/aws-ec2.md @@ -0,0 +1,30 @@ +# deploying `code-server` on AWS EC2 + +![code-server and AWS EC2](../img/code-server-aws-ec2.png) + +[AWS EC2](https://aws.amazon.com/ec2/) is a popular way to manage and launch virtual machines. Here is a fast way to launch a code-server machine with AWS EC2: + +1. Log into AWS and head over to the [EC2 dashboard](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2). Launch a new instance. + +2. Use the "Ubuntu Server 20.04 LTS" 64-bit (x86) Quick Start. + +3. Choose `t2.micro` instance type or larger. + +4. Click `Next: Configure Instance Details` to add the code-server script. + +5. Under `User data`, copy & paste the [launch-code-server.sh](../deploy-vm/launch-code-server.sh) script. + +6. Expand your storage, if necessary under the "Add Storage" section. + +7. Under "Security Groups," ensure you have rows for "SSH" (:22) and "HTTP" (:80) + +8. Add any SSH keys, if necessary, and launch the instance. + +9. Once your instance starts, you can simply navigate to the public IP address and get forwarded to a secure version of code-server, which will be proxied behind your GitHub account (the first one you log in with). For information on how this works, see [code-server --link](https://github.com/cdr/code-server#cloud-program-%EF%B8%8F). + +10. Optional: To change the URL in the address bar from `ip-[xxxx]` to something more descriptive, you just need to change your hostname and restart code-server: + +```sh +sudo hostnamectl set-hostname bens-devbox +sudo systemctl restart code-server@coder +``` diff --git a/img/code-server-aws-ec2.png b/img/code-server-aws-ec2.png new file mode 100644 index 00000000..ffda2569 Binary files /dev/null and b/img/code-server-aws-ec2.png differ diff --git a/img/logo/aws-ec2.png b/img/logo/aws-ec2.png new file mode 100644 index 00000000..16c33389 Binary files /dev/null and b/img/logo/aws-ec2.png differ