Organizations can be used to segment and isolate resources inside a Coder

deployment for different user groups or projects.

Here is an example of how one could use organizations to run a Coder deployment

with multiple platform teams, all with unique resources:


All Coder deployments start with one organization called `Default`.

To edit the organization details, navigate to `Deployment -> Organizations` in

the top bar:


From there, you can manage the name, icon, description, users, and groups:


Any additional organizations have unique admins, users, templates, provisioners,

groups, and workspaces. Each organization must have at least one

[provisioner](./provisioners.md) as the built-in provisioner only applies to the

default organization.

- Coder v2.16+ deployment with Premium license with Organizations enabled

([contact your account team](https://coder.com/contact)) for more details.

- User with `Owner` role

Within the sidebar, click `New organization` to create an organization. In this

example, we'll create the `data-platform` org.


From there, let's deploy a provisioner and template for this organization.

[Provisioners](../admin/provisioners.md) are organization-scoped and are

responsible for executing Terraform/OpenTofu to provision the infrastructure for

workspaces and testing templates. Before creating templates, we must deploy at

least one provisioner as the built-in provisioners are scoped to the default

organization.

Using Coder CLI, run the following command to create a key that will be used to

authenticate the provisioner:

coder provisioner keys create data-cluster-key --org data-platform

Successfully created provisioner key data-cluster! Save this authentication token, it will not be shown again.

< key omitted >

Next, start the provisioner with the key on your desired platform. In this

example, we'll start it using the Coder CLI on a host with Docker. For

instructions on using other platforms like Kubernetes, see our

[provisioner documentation](../admin/provisioners.md).

export CODER_URL=https://<your-coder-url>

export CODER_PROVISIONER_DAEMON_KEY=<key>

coder provisionerd start --org <org-name>

Once you've started a provisioner, you can create a template. You'll notice the

"Create Template" screen now has an organization dropdown:


Navigate to `Deployment->Organizations` to add members to your organization.

Once added, they will be able to see the organization-specific templates.


Now, users in the data platform organization will see the templates related to

their organization. Users can be in multiple organizations.


"versions": [

"main"

],

"title": "Organizations",

"description": "Learn how to manage organizations",

"path": "./admin/organizations.md",

"icon_path": "./images/icons/group.svg",

"state": "enterprise"

},

{

"title": "Template RBAC",

"description": "Learn how to use the role based access control against templates",