Skip to content

add ec2 guide #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 22, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 9 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) |

---

Expand Down
30 changes: 30 additions & 0 deletions guides/aws-ec2.md
Original file line number Diff line number Diff line change
@@ -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
```
Binary file added img/code-server-aws-ec2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/logo/aws-ec2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.