coder/docs
Steven Masley b785e996f8
chore: explain GIT_ASKPASS behavior in docs (#12784)
* chore: docs explaining GIT_ASKPASS behavior

- VSCode configuration requirements
2024-03-28 13:59:03 -05:00
..
about add updated architecture diagrams (#12584) 2024-03-15 11:09:03 -04:00
admin chore: explain GIT_ASKPASS behavior in docs (#12784) 2024-03-28 13:59:03 -05:00
api chore(codersdk): move all tailscale imports out of `codersdk` (#12735) 2024-03-26 12:44:31 -05:00
changelogs chore: fix changelog typos (#12663) 2024-03-19 16:04:27 +00:00
cli feat(cli): unhide support bundle cmd (#12745) 2024-03-25 15:14:27 +00:00
contributing docs: update FE fetching data docs (#11376) 2024-01-03 12:27:33 +00:00
guides docs: add guide for Xray integration (#12629) 2024-03-28 04:48:50 +03:00
ides chore: path app IDEs (#11007) 2023-12-04 11:22:22 +00:00
images docs: add guide for Xray integration (#12629) 2024-03-28 04:48:50 +03:00
install docs: simplify install docs (#11946) 2024-03-08 15:15:59 +00:00
networking fix(docs/networking/stun): convert svg diagrams to png 2024-02-12 17:27:53 +00:00
platforms docs: update remote docker host docs (#11919) 2024-02-01 22:43:38 +03:00
security chore(docs): update docs for correct use of shell and console and enforce linewidth (#9245) 2023-08-23 12:27:57 +03:00
templates chore: add note about options use in numeric parameters (#12770) 2024-03-27 13:46:41 +02:00
CONTRIBUTING.md chore: fix broken docs links (#11760) 2024-01-22 18:45:34 -06:00
README.md chore: fix broken docs links (#11760) 2024-01-22 18:45:34 -06:00
cli.md feat(cli): unhide support bundle cmd (#12745) 2024-03-25 15:14:27 +00:00
dotfiles.md docs: improve structure for example templates (#9842) 2023-12-17 17:05:13 +03:00
enterprise.md hotfix(docs): we do not offer phone support yet (#12658) 2024-03-19 10:22:32 +00:00
faqs.md docs: fix jetbrains reconnect faq (#12073) 2024-02-09 23:44:33 +00:00
ides.md chore(docs): update docs for correct use of shell and console and enforce linewidth (#9245) 2023-08-23 12:27:57 +03:00
manifest.json docs: add guide for Xray integration (#12629) 2024-03-28 04:48:50 +03:00
secrets.md chore(docs): update docs for correct use of shell and console and enforce linewidth (#9245) 2023-08-23 12:27:57 +03:00
workspaces.md minor change to quiet hours docs (#12338) 2024-02-29 14:50:00 -06:00

README.md

About Coder

Coder is an open-source platform for creating and managing developer workspaces on your preferred clouds and servers.

By building on top of common development interfaces (SSH) and infrastructure tools (Terraform), Coder aims to make the process of provisioning and accessing remote workspaces approachable for organizations of various sizes and stages of cloud-native maturity.

If you are a Coder v1 customer, view the docs or the sunset plans.

How it works

Coder workspaces are represented with Terraform, but no Terraform knowledge is required to get started. We have a database of pre-made templates built into the product.

Coder workspaces don't stop at compute. You can add storage buckets, secrets, sidecars and whatever else Terraform lets you dream up.

Learn more about managing infrastructure.

IDE Support

You can use any Web IDE (code-server, projector, Jupyter, etc.), JetBrains Gateway, VS Code Remote or even a file sync such as mutagen.

Why remote development

Migrating from local developer machines to workspaces hosted by cloud services is an increasingly common solution for developers and organizations alike. There are several benefits, including:

  • Increased speed: Server-grade compute speeds up operations in software development, such as IDE loading, code compilation and building, and the running of large workloads (such as those for monolith or microservice applications)

  • Easier environment management: Tools such as Terraform, nix, Docker, devcontainers, and so on make developer onboarding and the troubleshooting of development environments easier

  • Increase security: Centralize source code and other data onto private servers or cloud services instead of local developer machines

  • Improved compatibility: Remote workspaces share infrastructure configuration with other development, staging, and production environments, reducing configuration drift

  • Improved accessibility: Devices such as lightweight notebooks, Chromebooks, and iPads can connect to remote workspaces via browser-based IDEs or remote IDE extensions

Why Coder

The key difference between Coder OSS and other remote IDE platforms is the added layer of infrastructure control. This additional layer allows admins to:

  • Support ARM, Windows, Linux, and macOS workspaces
  • Modify pod/container specs (e.g., adding disks, managing network policies, setting/updating environment variables)
  • Use VM/dedicated workspaces, developing with Kernel features (no container knowledge required)
  • Enable persistent workspaces, which are like local machines, but faster and hosted by a cloud service

Coder includes production-ready templates for use with AWS EC2, Azure, Google Cloud, Kubernetes, and more.

What Coder is not

  • Coder is not an infrastructure as code (IaC) platform. Terraform is the first IaC provisioner in Coder, allowing Coder admins to define Terraform resources as Coder workspaces.

  • Coder is not a DevOps/CI platform. Coder workspaces can follow best practices for cloud service-based workloads, but Coder is not responsible for how you define or deploy the software you write.

  • Coder is not an online IDE. Instead, Coder supports common editors, such as VS Code, vim, and JetBrains, over HTTPS or SSH.

  • Coder is not a collaboration platform. You can use git and dedicated IDE extensions for pull requests, code reviews, and pair programming.

  • Coder is not a SaaS/fully-managed offering. You must host Coder on a cloud service (AWS, Azure, GCP) or your private data center.

Up next