Team VMs
How VMs work within a team
## Shared quota
When you're in a team, individual VM limits are replaced by team-wide limits.
All members' VMs count toward the same pool. Run `team` to see current usage:
```
VMs: 12 / 100
```
## Creating VMs
Team members create VMs the same way as individual users. The VM is owned by
whoever creates it and counts toward the team's shared quota.
## Admin visibility
Team admins (and the billing owner) see all team members' VMs by running
`team vm ls`. These appear under a "Team VMs" section, separate from your
own. The listing can be grouped with `--group=user` or `--group=access`
(as well as `tag` and `region`). Admins can also visit
[exe.dev/team/vms](https://exe.dev/team/vms) to see all VMs on their team.
## Admin SSH access
Admins can SSH directly into any team member's VM, both by name and by IP
shard routing. This works the same as SSHing into your own box:
```
ssh mybox@exe.dev
```
Admins can also delete, rename, and copy member VMs. Other team members can
copy after the VM owner runs `share access allow`. A web-only team share does
not allow copying.
## Sharing with the team
There are two kinds of team sharing.
### Web access
Share a VM's private web proxy with the whole team:
```
share add mybox team
```
Team shares are dynamic — when a new member joins, they automatically get
access to all team-shared VMs. Remove it with:
```
share remove mybox team
```
### SSH, Shelley, and web access
Web sharing (`share add mybox team`) grants web-proxy access only. To let any
team member (not just admins) SSH into the VM or use Shelley on it:
```
share access allow mybox
```
Because shell access is strictly more powerful than web access — a teammate
with SSH can port-forward to any port anyway — `share access allow` also
grants web-proxy access to the VM's standard route, just as if you had run
`share add mybox team`. You don't need to run both commands.
Revoke all of it (SSH, Shelley, and the implied web access) with:
```
share access disallow mybox
```
See [team sharing controls](/docs/teams/sharing-controls) for more on
how teams can share VMs, and the individual [sharing
docs](/docs/sharing) for more on how sharing works.