zulip/help/logging-in.md

4.2 KiB

Logging in

By default, Zulip allows logging in via email/password as well as various social authentication providers like Google, GitHub, GitLab, and Apple.

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. For example, 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.

Find the Zulip log in URL

Here are some ways to find the URL for your Zulip organization.

{start_tabs}

{tab|logged-out}

  • If your organization is hosted on Zulip Cloud (usually at *.zulipchat.com), go to the Find your accounts page and enter the email address that you signed up with. You will receive an email with the sign-in information for any Zulip organizations associated with your email address.

  • Search your email account for a registration email from Zulip. The subject line will include Zulip: Your new account details or Zulip: Your new organization details. This email provides your organization's log in URL.

  • If you have visited your organization's log in page in the past, try reviewing your browser's history. Searching for zulipchat.com should find the right page if your Zulip organization is hosted on Zulip Cloud.

  • You can ask your organization administrators for your Zulip URL.

{tab|logged-in}

  • If using Zulip in the browser, your organization's Zulip log in URL is the first part of what you see in the URL bar (e.g., <organization-name>.zulipchat.com for Zulip Cloud organizations).

  • In the Desktop app, select Copy Zulip URL from the Zulip menu to copy the URL of the currently active organization. You can also access the Copy Zulip URL option by right-clicking on an organization logo in the organizations sidebar on the left.

  • In the Mobile app, tap your profile picture in the bottom right corner of the app, then tap switch account to see the URLs for all the organizations you are logged in to.

  • On Zulip Cloud and other Zulip servers updated to Zulip 6.0 or higher, click the gear () icon in the upper right corner of the web or desktop app. Your organization's log in URL is shown in the top section of the menu.

{end_tabs}

Log in for the first time

{start_tabs}

{tab|web}

  1. Go to the Zulip URL of the organization.

  2. Follow the on-screen instructions.

{tab|desktop}

!!! warn "" If you are having trouble connecting, you may need to set your proxy settings or add a custom certificate.

  1. Click the plus () icon in the organizations sidebar on the left. You can also select Add Organization from the Zulip menu in the top menu bar.

  2. Enter the Zulip URL of the organization, and click Connect.

  3. Follow the on-screen instructions.

{!desktop-toggle-sidebar-tip.md!}

{tab|mobile}

{!mobile-profile-menu.md!}

  1. Tap Switch account.

  2. Tap Add new account.

  3. Enter the Zulip URL of the organization, and tap Enter.

  4. Follow the on-screen instructions.

{end_tabs}

Switch between organizations

{!switching-between-organizations.md!}

Set or reset your password

If you signed up using passwordless authentication and want to start logging in via email/password, you will need to create a password by following the instructions below. You can also reset a forgotten password.

{!change-password-via-email-confirmation.md!}