accounts.md

 1# Accounts
 2
 3Signing in to Zed is not a requirement. You can use most features you'd expect in a code editor without ever doing so. We'll outline the few features that do require signing in, and how to do so, here.
 4
 5## What Features Require Signing In?
 6
 71. All real-time [collaboration features](./collaboration.md).
 82. [LLM-powered features](./ai/overview.md), if you are using Zed as the provider of your LLM models. Alternatively, you can [bring and configure your own API keys](./ai/configuration.md#use-your-own-keys) if you'd prefer, and avoid having to sign in.
 9
10## Signing In
11
12Zed uses GitHub's OAuth flow to authenticate users, requiring only the `read:user` GitHub scope, which grants read-only access to your GitHub profile information.
13
141. Open Zed and click the `Sign In` button in the top-right corner of the window, or run the `client: sign in` command from the command palette (`cmd-shift-p` on macOS or `ctrl-shift-p` on Windows/Linux).
152. Your default web browser will open to the Zed sign-in page.
163. Authenticate with your GitHub account when prompted.
174. After successful authentication, your browser will display a confirmation, and you'll be automatically signed in to Zed.
18
19**Note**: If you're behind a corporate firewall, ensure that connections to `zed.dev` and `collab.zed.dev` are allowed.
20
21## Signing Out
22
23To sign out of Zed, you can use either of these methods:
24
25- Click on the profile icon in the upper right corner and select `Sign Out` from the dropdown menu.
26- Open the command palette and run the `client: sign out` command.
27
28## Email
29
30Note that Zed associates your Github _profile email_ with your Zed account, not your _primary email_. We're unable to change the email associated with your Zed account without you changing your profile email.
31
32We _are_ able to update the billing email on your account, if you're a Zed Pro user. See [Updating Billing Information](./ai/billing.md#updating-billing-info) for more