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 and Install the desktop app.
Approve a device
- 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 loginprints the address to open. Either way your browser opens Sign in on this device? with the code filled in. On a phone, openshipvitals.com/deviceand type the code (case, spaces and the dash don't matter), then press Continue. - If you aren't signed in, sign in first; you come back to the same page with the code.
- 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.
- Signing in as … names your account. Wrong account? Press Not you? to sign out and sign in as the right one.
- 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.
- 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).
- 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
vitalssigned 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.