paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-10-28 10:33:54 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
c4cb75979a69d6069b11feff5eaed6af1130e89d
zulip/help/desktop-app-install-guide.md
Shubham Padia 34633d467e help: Multiline ordered list items should have spacing after 2nd line. 
The expected behaviour would be to have some spaces from the second line
onwards for multi-list items. Regex used to check for this was
`^1\..*\r?\n^[^\s].*$` which gives us some extra results that don't fit
our criteria which we can chose to ignore.
2025-07-29 10:09:21 -07:00

5.4 KiB
Raw Blame History

Installing the Zulip desktop app

The Zulip desktop app comes with native desktop notifications, support for multiple Zulip accounts, and a dedicated tray icon.

Installing the latest stable release is recommended for most users. For an early look at the newest features, consider the beta releases.

Install the latest release

{start_tabs}

{tab|mac}

{!app-will-update-tip.md!}

Disk image (recommended)

  1. Download Zulip for macOS.

  2. Open the file, and drag the app into the Applications folder.

Homebrew

  1. Run the command brew install --cask zulip from a terminal.

  2. Run Zulip from Applications.

You can run the command brew upgrade zulip to immediately upgrade the app.

{tab|windows}

Web installer (recommended)

{!app-will-update-tip.md!}

  1. Download and run Zulip for Windows.

  2. Run Zulip from the Start menu.

Offline installer (for isolated networks)

!!! warn "" The app will not update automatically. You can repeat these steps to upgrade to future versions.

  1. Download zulip-x.x.x-x64.msi for 64-bit desktops (common), or zulip-x.x.x-ia32.msi for 32-bit (rare).

  2. Copy the installer file to the machine you want to install the app on, and open it there.

  3. Run Zulip from the Start menu.

{tab|linux}

APT (Ubuntu or Debian)

!!! tip "" The app will be updated automatically to future versions when you do a regular software update on your system, e.g., with sudo apt update && sudo apt upgrade.

  1. Enter the following commands into a terminal:

    sudo apt install curl
sudo curl -fL -o /etc/apt/trusted.gpg.d/zulip-desktop.asc \
    https://download.zulip.com/desktop/apt/zulip-desktop.asc
echo "deb https://download.zulip.com/desktop/apt stable main" | \
    sudo tee /etc/apt/sources.list.d/zulip-desktop.list
sudo apt update
sudo apt install zulip

    These commands set up the Zulip Desktop APT repository and its signing key, and then install the Zulip client.

  2. Run Zulip from your app launcher, or with zulip from a terminal.

AppImage (recommended for all other distros)

{!app-will-update-tip.md!}

  1. Download Zulip for Linux.

  2. Make the file executable, with chmod a+x Zulip-x.x.x-x86_64.AppImage from a terminal (replace x.x.x with the actual app version of the downloaded file).

  3. Run the file from your app launcher, or from a terminal. This file is the Zulip app, so no installation is required.

Snap

  1. Make sure snapd is installed.

  2. Execute following command to install Zulip:

    sudo snap install zulip

  3. Run Zulip from your app launcher, or with zulip from a terminal.

Flathub

  1. Make sure you have Flatpak installed on your system.

  2. Use the following command from the official Flathub page to install Zulip:

    flatpak install flathub org.zulip.Zulip

  3. After the installation is complete, you can run Zulip using the following command:

    flatpak run org.zulip.Zulip

{end_tabs}

Install a beta release

Get a peek at new features before they're released!

{start_tabs}

{tab|most-systems}

{!app-will-update-tip.md!}

  1. Go to the Zulip releases page on GitHub, and find the latest version tagged with the “Pre-release” label.

  2. If there's a Pre-release that's more recent than the latest release, download the appropriate Zulip beta installer or app for your system.

  3. To install and run Zulip, refer to the instructions for your operating system in the Install the latest release section above.

{tab|linux-with-apt}

!!! tip ""

The app will be updated automatically to future versions when you do a
regular software update on your system, e.g., with
`sudo apt update && sudo apt upgrade`.

You don't have the Zulip app installed

  1. Enter the following commands into a terminal:

    sudo curl -fL -o /etc/apt/trusted.gpg.d/zulip-desktop.asc \
    https://download.zulip.com/desktop/apt/zulip-desktop.asc
echo "deb https://download.zulip.com/desktop/apt beta main" | \
    sudo tee /etc/apt/sources.list.d/zulip-desktop.list
sudo apt update
sudo apt install zulip

    These commands set up the Zulip Desktop beta APT repository and its signing key, and then install the Zulip beta client.

  2. Run Zulip from your app launcher, or with zulip from a terminal.

You already have the Zulip app installed

  1. Enter the following commands into a terminal:

    sudo sed -i s/stable/beta/ /etc/apt/sources.list.d/zulip-desktop.list
sudo apt update
sudo apt install zulip

    These commands set up the Zulip Desktop beta APT repository, and then install the Zulip beta client.

  2. Run Zulip from your app launcher, or with zulip from a terminal.

{end_tabs}

Related articles