ContextQMD
Back to Zulip

Logging in

starlight_help/src/content/docs/logging-in.mdx

12.05.3 KB
Original Source

import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";

import FlattenedSteps from "../../components/FlattenedSteps.astro"; import ZulipNote from "../../components/ZulipNote.astro"; import ChangePasswordViaEmailConfirmation from "../include/_ChangePasswordViaEmailConfirmation.mdx"; import DesktopToggleSidebarTip from "../include/_DesktopToggleSidebarTip.mdx"; import MobileSwitchAccount from "../include/_MobileSwitchAccount.mdx"; import SwitchingBetweenOrganizations from "../include/_SwitchingBetweenOrganizations.mdx";

import PlusIcon from "~icons/fa/plus"; import GearIcon from "~icons/zulip-icon/gear"; import MobileArrowLeftRightIcon from "~icons/zulip-icon/mobile-arrow-left-right";

By default, Zulip allows logging in via email/password as well as various social authentication providers like Google, GitHub, GitLab, Discord 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.

<Tabs> <TabItem label="If you are logged out"> * If your organization is hosted on [Zulip Cloud](https://zulip.com/zulip-cloud/) (usually at `*.zulipchat.com`), go to the [**Find your accounts**](https://zulip.com/accounts/find/) 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](https://zulip.com/zulip-cloud/). * You can ask your organization administrators for your Zulip URL. </TabItem> <TabItem label="If you are 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](https://zulip.com/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 <MobileArrowLeftRightIcon /> **Switch account** to see the URLs for all the organizations you are logged in to. * On [Zulip Cloud](https://zulip.com/zulip-cloud/) and other Zulip servers updated to [Zulip 6.0 or higher](https://zulip.readthedocs.io/en/stable/overview/changelog.html#zulip-6-x-series), click the **gear** (<GearIcon />) 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. </TabItem> </Tabs>

Log in to a new organization

<Tabs> <TabItem label="Mobile"> <FlattenedSteps> <MobileSwitchAccount /> 
  1. Tap **Add new account**.
  1. Enter the Zulip URL of the organization, and tap **Continue**.
  1. Follow the on-screen instructions.
</FlattenedSteps>
</TabItem> <TabItem label="Desktop"> <ZulipNote> If you are having trouble connecting, you may need to set your [proxy settings](/help/connect-through-a-proxy) or add a [custom certificate](/help/custom-certificates). </ZulipNote> 
<Steps>
  1. Click the **add organization** (<PlusIcon />) icon in the
     **organizations sidebar** on the left. You can also select **Add Organization**
     from the **Zulip** menu in the top menu bar.
  1. Enter the Zulip URL of the organization, and click **Connect**.
  1. Follow the on-screen instructions.
</Steps>

<DesktopToggleSidebarTip />
</TabItem> <TabItem label="Web"> <Steps> 1. Go to the Zulip URL of the organization. 1. Follow the on-screen instructions. </Steps> </TabItem> </Tabs>

Switch between organizations

<SwitchingBetweenOrganizations />

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.

<ChangePasswordViaEmailConfirmation />