This article has been archived. Please see Coder Docs for the updated version.
This article will walk you through the process of creating a new environment.
To begin, log in to Coder. You will automatically be redirected to the Environments page.
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 either Create Environment (if available) or New Environment in the top-right to launch the creation window.
When prompted, provide the following information for the environment you want to be created:
|Environment Name||A friendly name for your environment|
|Image||The Docker image you want to use as the base for your environment|
|Tag||The version of the Image you want to use|
By default, a new environment will be allocated resources (CPU Cores, Memory and Disk) based on its parent image. These values may be changed by configuring the Advanced section:
|CPU Cores||The number of CPU cores you'd like for your environment|
|Memory||The amount of memory you'd like for your environment|
|Disk||The amount of storage space you'd like for your environment|
When done, click Create to proceed. Coder will redirect you to an overview page for your environment while it builds.
Image Resource Allocation Defaults
Coder displays a warning if you choose resource settings lower than the image-recommended default, but you can still create the environment.
Please note that if the image you're using to create your environment does not include a .gitconfig file, Coder will automatically generate one for you using the details found in your Coder Enterprise account.
You can modify the .gitconfig file, but we recommend using a personalize file or a dotfiles repo instead to customize your environment.