Coder has open-sourced a new remote development platform 🥳 Check it out at coder/coder on GitHub.

Getting started

1. Import an image

Ensure you've imported an image for your environment to use.

2. Create an environment

If this is your first time using Coder, you'll see a Create Environment button in the middle of your screen; otherwise, you'll see a list of your existing environments. Click the New Environment button.

Create an environment

  1. Enter a friendly name for your environment, and choose an image to use.

  2. Set the parameters for your environment.

  3. Click Create to proceed.

Coder redirects you to an overview page for your environment during the build process. Learn more about the environment creation parameters.

Your environment persists in the home directory, updates to new versions of the image, and runs custom configuration on startup. Learn about the environment lifecycle.


Coder provides advanced settings that allow you to customize your environment. You can choose to run your environment as a Container-based virtual machine, specifying the resources Coder should allocate.

By default, Coder allocates resources (CPU Cores, Memory, and Disk Space) based on the parent image.

Coder displays a warning if you choose your resource settings and they're less than the image-recommended default, but you can still create the environment.

3. Start Coding

Once you've created an environment, it's time to hop in. Read more about how to connect your favorite editor or IDE with your new environment!

Start coding

Integrate with Git to have your SSH key injected automatically into Environments.

See an opportunity to improve our docs? Make an edit.