# Environment variables

Coder injects a standard set of environment variables that allow you to access
contextual information about your workspace.

To obtain a list of environment variables and their values, launch the
**Terminal** via the Coder Dashboard and run:

```console
env | grep CODER_
```

## Available environment variables


<table>
    <tr>
        <th>Environment variable</th>
        <th>Description</th>
    </tr>
    <tr>
        <td><code>CODER_ASSETS_ROOT</code></td>
        <td>The directory where coder adds Coder-specific assets during
            workspace creation, such as the <code>coder-cli</code> binary</td>
    </tr>
    <tr>
        <td><code>CODER_CPU_LIMIT</code></td>
        <td>The CPU core limit given to your workspace</td>
    </tr>
    <tr>
        <td><code>CODER_IMAGE_DIGEST</code></td>
        <td>The content-addressable identifier for your image</td>
    </tr>
    <tr>
        <td><code>CODER_IMAGE_TAG</code></td>
        <td>The image tag used to create your workspace</td>
    </tr>
    <tr>
        <td><code>CODER_IMAGE_URI</code></td>
        <td>The URI of the image used to build the workspace</td>
    </tr>
    <tr>
        <td><code>CODER_MEMORY_LIMIT</code></td>
        <td>The memory limit given to your workspace in GB</td>
    </tr>
    <tr>
        <td><code>CODER_ORGANIZATION_ID</code></td>
        <td>The ID of the organization to which the workspace belongs.</td>
    </tr>
    <tr>
        <td><code>CODER_RUNTIME</code></td>
        <td>The container runtime used to start the workspace (either
        <code>kubernetes/default</code> or <code>kubernetes/sysbox</code>
        if the workspace is a CVM</td>
    </tr>
    <tr>
        <td><code>CODER_URL</code></td>
        <td>The base URL of your Coder deployment</td>
    </tr>
    <tr>
        <td><code>CODER_USER_EMAIL</code></td>
        <td>Your email address</td>
    </tr>
    <tr>
        <td><code>CODER_USERNAME</code></td>
        <td>Your user name</td>
    </tr>
    <tr>
        <td><code>CODER_WORKSPACE_ID</code></td>
        <td>The unique ID of your workspace</td>
    </tr>
    <tr>
        <td><code>CODER_WORKSPACE_NAME</code></td>
        <td>The name of your workspace</td>
    </tr>
    <tr>
        <td><code>CODER_WP_NAME</code></td>
        <td>The name of the workspace provider hosting the workspace</td>
    </tr>
</table>



## Other variables

Coder uses the following environment variables for its internal operation:

> **Important**: These variables may be modified or removed in future releases
> without prior notice and are not covered by Coder's backward compatibility
> policy. These are documented here for your information only.


<table>
    <tr>
        <th>Environment variable</th>
        <th>Description</th>
    </tr>
    <tr>
        <td><code>CODER_AGENT_TOKEN</code></td>
        <td>The token used by the <a href="../setup/architecture.md">Coder Agent</a>
            to authenticate with <code>coderd</code>. The Coder Agent handles
            tunnelled connections, collects workspace statistics (such as
            processor and memory utilization), and manages programs, such as
            editors.</td>
    </tr>
    <tr>
        <td><code>CODER_AGENT_URL</code></td>
        <td>The URL that the <code>coder agent</code> process uses
            to connect to <code>coderd</code>. If this is not set, the agent
            will connect to <code>CODER_URL</code> instead, enabling the
            <code>coder agent</code> and <code>coder</code> command-line tool
            to connect to different installations.</td>
    </tr>
    <tr>
        <td><code>CODER_BOOTSTRAP_SCRIPT</code></td>
        <td>The script used to initiate the workspace startup sequence when the
            <a href="../admin/workspace-management/self-contained-builds.md">
            self-contained workspace builds</a> feature is active; begins by
             downloading the "bootstrap agent" from the <code>coderd</code>
             process.</td>
    </tr>
</table>



Learn how to work with CODER_* environment variables inside workspaces.

Environment variable	Description
`CODER_ASSETS_ROOT`	The directory where coder adds Coder-specific assets during workspace creation, such as the `coder-cli` binary
`CODER_CPU_LIMIT`	The CPU core limit given to your workspace
`CODER_IMAGE_DIGEST`	The content-addressable identifier for your image
`CODER_IMAGE_TAG`	The image tag used to create your workspace
`CODER_IMAGE_URI`	The URI of the image used to build the workspace
`CODER_MEMORY_LIMIT`	The memory limit given to your workspace in GB
`CODER_ORGANIZATION_ID`	The ID of the organization to which the workspace belongs.
`CODER_RUNTIME`	The container runtime used to start the workspace (either `kubernetes/default` or `kubernetes/sysbox` if the workspace is a CVM
`CODER_URL`	The base URL of your Coder deployment
`CODER_USER_EMAIL`	Your email address
`CODER_USERNAME`	Your user name
`CODER_WORKSPACE_ID`	The unique ID of your workspace
`CODER_WORKSPACE_NAME`	The name of your workspace
`CODER_WP_NAME`	The name of the workspace provider hosting the workspace

Environment variable	Description
`CODER_AGENT_TOKEN`	The token used by the Coder Agent to authenticate with `coderd`. The Coder Agent handles tunnelled connections, collects workspace statistics (such as processor and memory utilization), and manages programs, such as editors.
`CODER_AGENT_URL`	The URL that the `coder agent` process uses to connect to `coderd`. If this is not set, the agent will connect to `CODER_URL` instead, enabling the `coder agent` and `coder` command-line tool to connect to different installations.
`CODER_BOOTSTRAP_SCRIPT`	The script used to initiate the workspace startup sequence when the self-contained workspace builds feature is active; begins by downloading the "bootstrap agent" from the `coderd` process.