Skip to content

armgit / zulip

Public Imported from GitHub
0

Zulip server and web application. Open-source team chat that helps teams stay productive and focused.

5.3 KB
Raw Blame
---
title: Logging in
---

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](/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. 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 />

## Related articles

* [Logging out](/help/logging-out)
* [Switching between organizations](/help/switching-between-organizations)
* [Change your email address](/help/change-your-email-address)
* [Change your password](/help/change-your-password)
* [Deactivate your account](/help/deactivate-your-account)