# Sign in on the desktop app or vitals

The ShipVitals desktop app and `vitals` sign in through your browser: the device shows a code, and you approve it on ShipVitals. One approval signs the device in as you and, if you choose, lets it run checks for one workspace.

This guide covers the browser's side. For the device's side, see [Pair a runner](pair-a-runner.md) and [Install the desktop app](install-the-desktop-app.md).

## Approve a device

1. On the device, start signing in. It shows a code like **WDJB-MJHT**. In the desktop app, press **Sign in** on **This Mac**, then **Open browser**; `vitals login` prints the address to open. Either way your browser opens **Sign in on this device?** with the code filled in. On a phone, open `shipvitals.com/device` and type the code (case, spaces and the dash don't matter), then press **Continue**.
2. If you aren't signed in, sign in first; you come back to the same page with the code.
3. Check that the page shows the device you're holding: its name, system and version, when and where it asked, and **Code … — it should match the one on the device.** Only continue if the device is in front of you. If someone sent you the code or link, press **Not me, cancel**.
4. **Signing in as …** names your account. Wrong account? Press **Not you?** to sign out and sign in as the right one.
5. To let the machine run checks, leave **Run checks on this Mac for …** ticked. Press **Change** to pick another workspace. The box appears only in workspaces where you can run a project; a viewer signs in without it.
6. Press **Sign in on this device**. ShipVitals may ask you to **Confirm it's you** first (a sign-in in the last 10 minutes, and your two-factor code if you use one).
7. The page says **You can close this tab.** ShipVitals emails you that the device signed in.

### When the plan's machines are all paired

The page says so in place, for example "Free covers one machine. Studio Mac mini is paired." Tick **Replace it** (or choose the machine to replace) to move the place to this device, or press **See plans**. If the paired machines are other people's, ask an admin to free one, or untick **Run checks** and sign in without it.

### When a code doesn't work

- **We don't know this code:** check it on the device and type it again.
- **This code has expired:** codes last 10 minutes. Get a new one on the device.
- **This code was already used** or **already approved:** a code signs in one device, once.
- **This sign-in was cancelled:** get a new code on the device.

## See and revoke your devices

Open **Account settings → Devices** (or **Security → Sessions → see your devices**).

- **Signed-in devices** lists each desktop app and `vitals` signed in as you, with the workspaces it runs checks for.
- **Revoke** signs the device out at once and stops the checks it runs.
- **Runners on their own** lists machines you paired that run checks with nobody signed in on them, such as an always-on Mac mini. Remove one in its workspace's **Settings → Runners**.
- **Enter a code from a device** opens the approval page without a code.

Your security activity lists each device signed in, signed out, revoked or paired.
