zulip/templates/zerver/help/logging-in.md

84 lines
2.4 KiB
Markdown

# Logging in
By default, Zulip allows logging in via email/password as well as
various social authentication providers like Google, GitHub, and
GitLab.
Organization administrators can
[add other authentication methods](/help/configure-authentication-methods),
including the SAML and LDAP integrations, or disable any of the methods above.
You can log in with any method allowed by your organization, regardless of
how you signed up. E.g. if you originally signed up using your Google
account, you can later log in using GitHub, as long as your Google account
and GitHub account use the same email address.
### Log in to a Zulip organization for the first time
{start_tabs}
{tab|desktop}
1. Open the **left sidebar** (`Ctrl+Shift+s`).
1. Set your [proxy settings](/help/connect-through-a-proxy) or add a
[custom certificate](/help/custom-certificates) if needed (rare).
1. Click the **plus** (+) icon.
1. Enter your Zulip URL, and click **Connect**.
1. Follow the on-screen instructions.
{tab|mobile}
1. From the home screen, tap your **profile picture** in the lower right.
1. Tap **Switch account**.
1. Tap **Add new account**.
1. Enter your Zulip URL, and tap **Enter**.
1. Follow the on-screen instructions.
{tab|web}
1. Go to your organization's **Zulip URL**.
1. Follow the on-screen instructions.
{end_tabs}
For subsequent logins, see [switching between organizations](/help/switching-between-organizations).
## Troubleshooting
### I don't know my Zulip URL
Some ideas:
* If you know your organization is hosted on
[zulipchat.com](https://zulipchat.com), go to
[find my account](https://zulipchat.com/accounts/find/) and enter the email
address that you signed up with.
* Try guessing the URL. Zulip URLs often look like `<name>.zulipchat.com`,
`zulip.<name>.com`, or `chat.<name>.com` (replace `<name>` with the name of your
organization).
* Ask your organization administrators for your Zulip URL.
### I signed up with Google/GitHub auth and never set a password
If you signed up using passwordless authentication and want to start logging
in via email/password, you can
[reset your password](/help/change-your-password).
### I forgot my password
You can [reset your password](/help/change-your-password). This requires
access to the email address you currently have on file. We recommend
[keeping your email address up to date](change-your-email-address).