Manage Users#

Coiled helps individuals and teams manage their resources, control costs, and collaborate with one another. Team members can share resources, track usage, and consolidate billing with anyone else on the same account.

Adding team members#

When you sign up for Coiled, an account is automatically created for your user, and the name of the account is the same as your username.

For example, if you sign up with the username awesome-dev, then the awesome-dev user is automatically added to an account also named awesome-dev.

../../_images/teams.png

If you want to work with a team of two or more users, please create an additional team account for your company or organization. You can either reach out to us at support@coiled.io and we can do this for you, or you can create an additional account by signing up for Coiled and specifying your organization as the username.

Once your team account is created, you can add users from the Team page in the Coiled web application. After selecting the Add Member button in the upper right, you can choose to enter their username or email:

"Add user to team" pop-up window with fields for username or email, core limit, and whether to make the user an admin.

If you use their email address, the user will then receive an email invitation to sign up for Coiled and join your team. You can see all invitations on the Team page.

Two paneled table with Invitations on top and Members below. For each invitation there are columns for email address, inviter, role (member or admin), core limit, credit limit, invite link, and the option to edit or remove the invitation. For each member, there are columns for the user, role, core limit, and the option to edit or, for admins, to remove a member.

Sharing resources#

You can create clusters, software environments, and other resources from any account of which you are a member.

You can see all accounts of which you are a member from the Coiled web application. Select your avatar from the top right, then select Profile. Scroll down to the bottom of the page to see the Accounts section.

Two column table showing team membership and core limits for a user.

You can change your default account by using the coiled login CLI tool (see coiled login), which will set the account in your local Coiled configuration file ~/.config/dask/coiled.yaml (see Configuration).

coiled login --account <your-team-account>

Or, you can specify the account by using the account keyword argument commonly accepted in API commands. For example, if sarah-johnson wants to create a cluster in sarahs-team:

import coiled

cluster = coiled.Cluster(n_workers=5, account="sarahs-team")

Or create a software environment accessible to other team members:

import coiled

coiled.create_software_environment(
    name="sarahs-team/my-pip-env",
    pip=["dask[complete]", "xarray==0.15.1", "numba"],
)

Note

Once you are added to an account, you can use the cloud provider resources and credentials that have already been set up for your team. Similarly, any tokens you’ve created will work for any account to which you belong (there is no need to create a new token).

Tracking usage#

On the Billing page, Coiled account admins can see detailed Coiled usage including your credit balance, credits used, and percentage of free credits used.

Monthly billing table available for PAYG customers.

If you have added a credit card to your account, you will also have visibility into your Coiled bill for the month:

Monthly billing table available for PAYG customers.

If your usage stays below the amount of free credits, then this value will always show $0 since you don’t have to pay Coiled anything.

For more detailed tracking of your Coiled and cloud provider usage and costs, you can use custom Tags.

Managing resources#

Administrators for a Coiled team can set resource limits for team members including:

../../_images/teams.png
  1. Coiled credits You can limit the number of Coiled credits used each month for each user or for a team from the Team page. You can, for example, limit your team to spending 2,000 Coiled credits per month, which is much lower than the 10,000 free Coiled credits offered each month, to better control AWS costs.

  2. Team-level vCPUs The number of virtual CPUs that can be running for a team at a given time. If you’d like to change this setting, please reach out to us at support@coiled.io.

  3. User-level vCPUs The number of virtual CPUs that can be running in a user’s account at a given time. You can set this limit for any user on your team from the Team page.