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

2.3 KiB

Logging in

By default, Zulip allows you to log with an email/password pair, a Google account, or a GitHub account.

Organization administrators can add other 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).

  2. Set your proxy settings or add a custom certificate if needed (rare).

  3. Click the plus (+) icon.

  4. Enter your Zulip URL, and click Connect.

  5. Follow the on-screen instructions.

{tab|mobile}

  1. From the home screen, tap your profile picture in the lower right.

  2. Tap Switch account.

  3. Tap Add new account.

  4. Enter your Zulip URL, and tap Enter.

  5. Follow the on-screen instructions.

{tab|web}

  1. Go to your organization's Zulip URL.

  2. Follow the on-screen instructions.

{end_tabs}

For subsequent logins, see switching between organizations.

Troubleshooting

I don't know my Zulip URL

Some ideas:

  • If you know your organization is hosted on zulipchat.com, go to find my account 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.

I forgot my password

You can reset your password. This requires access to the email address you currently have on file. We recommend keeping your email address up to date.