Managing Teams
Create teams, rename them, give them an icon and delete them.
A team is the top of the tree. It holds projects and the settings they share, and it has its own members. Every team runs in its own namespace on the cluster, so nothing in one team can see another.
Your instance starts with one team, Default.
Create a team
Only people who own the instance can create teams. Open the team switcher in the breadcrumb at the top of the page and press New Team. Give it a name of up to 32 characters, unique on the instance, and an optional description.
Whoever creates the team is its first admin. From there, add people under Settings > Members.
A new team starts empty. Create a project in it to get going. See Projects and Environments.
Settings
Team > Settings has:
- General: the team's name, description and icon.
- Variables: values shared by every project in the team. See Variables.
- Storage: buckets for database backups. See S3 Storage.
- Members: who can reach the team and with what role.
- Webhooks: notifications about the team's projects and services. See Webhooks.
- GitHub Apps: GitHub connections shared with the team.
- Danger Zone: delete the team.
Team icon
A team shows its icon next to its name in the team switcher. Until you set one, the icon is the first letter of the team's name in a circle.
To set one, go to Settings > General and click the avatar, or drop a file on it. It can be an SVG, PNG or JPEG of up to 512 KB and 1024×1024 pixels. The icon is cropped to a circle, so a square image works best. Remove goes back to the letter.
Changing the icon needs the editor role on the team. SVGs need a viewBox and can't have scripts or links to other files. PNG and JPEG files are stored without their metadata, such as camera or location details.
Delete a team
Deleting takes everything with it
Deleting a team permanently deletes every project in it, with their services, databases, volumes and buckets, and the namespace they ran in. It cannot be undone.
Deleting needs the admin role on the team. Go to Settings > Danger Zone, press Delete Team and type the team's name to confirm.
Members keep their accounts and whatever they have on other teams. A link to the deleted team takes them to another of their teams, or shows Team not found if they have none. API keys and connected apps limited to the deleted team stop reaching anything.