8000 GitHub - coder/coder at 8b0cc24a29a662e821ed4636907f107ee5188852
[go: up one dir, main page]

Skip to content

coder/coder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Coder

"GitHub Discussions" "Join us on Discord" Twitter Follow codecov

Provision remote development servers anywhere on anything.

Kubernetes workspace in Coder v2

Highlights

Workspaces:

  • Code on powerful servers: leverage cloud GPU, GPU, and network speeds
  • Use the coder CLI: connect via SSH, VS Code, and JetBrains
  • Self-serve workspaces: start from team-wide templates (see below)

Templates:

  • Manage the infrastructure behind workspaces with standard Terraform (.hcl files)
  • Use any OS and architecture: Mac, Windows, Linux, VM, Kubernetes, ARM, etc
  • Auto-shutdown or update workspaces when they're not in use!

TODO: succintly list value props

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 here. Terraform empowers you to create environments on anything, including:

  • VMs across any cloud
  • Kubernetes across any cloud (AKS, EKS, GKS)
  • Dedicated server providers (Hetzner, OVH)
  • Linux, Windows and MacOS environments

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

IDE Support

Installing Coder

We recommend installing the latest release on a system with at least 1 CPU core and 2 GB RAM:

  1. Download the release appropriate for your operating system
  2. Unzip the folder you just downloaded, and move the coder executable to a location that's on your PATH

Make sure you have the appropriate credentials for your cloud provider (e.g., access key ID and secret access key for AWS).

You can set up a temporary deployment, a production deployment, or a system service:

  • To set up a temporary deployment, start with dev mode (all data is in-memory and is destroyed on exit):

    coder server --dev
  • To run a production deployment with PostgreSQL:

    CODER_PG_CONNECTION_URL="postgres://<username>@<host>/<database>?password=<password>" \
        coder server
  • To run as a system service, install with .deb (Debian, Ubuntu) or .rpm (Fedora, CentOS, RHEL, SUSE):

    # Edit the configuration!
    sudo vim /etc/coder.d/coder.env
    sudo service coder restart

Use coder --help to get a complete list of flags and environment variables.

See the installation guide for additional ways to deploy Coder.

Creating your first template and workspace

In a new terminal window, run the following to copy a sample template:

coder templates init

Follow the CLI instructions to modify and create the template specific for your usage (e.g., a template to Develop in Linux on Google Cloud).

Create a workspace using your template:

coder create --template="yourTemplate" <workspaceName>

Connect to your workspace via SSH:

coder ssh <workspaceName>

Modifying templates

You can edit the Terraform template using a sample template:

coder templates init
cd gcp-linux/
vim main.tf
coder templates update gcp-linux

Documentation

Contributing

Read the contributing docs.

Contributors

Find our list of contributors here.

0