mirror of
https://github.com/zulip/zulip.git
synced 2025-10-30 19:43:47 +00:00
dedea23745
These files are not Jinja2 templates, so there's no reason that they needed to be inside `templates/zerver`. Moving them to the top level reflects their importance and also makes it feel nicer to work on editing the help center content, without it being unnecessary buried deep in the codebase.
138 lines
4.2 KiB
Markdown
138 lines
4.2 KiB
Markdown
# Installing the Zulip desktop app
|
|
|
|
Zulip on your macOS, Windows, or Linux desktop is even better than
|
|
Zulip on the web, with a cleaner look, tray/dock integration, native
|
|
notifications, and support for multiple Zulip accounts.
|
|
|
|
To install the latest stable release (recommended for most users),
|
|
find your operating system below. If you're interested in an early
|
|
look at the newest features, consider the [beta releases](#install-a-beta-release).
|
|
|
|
## Install the latest release
|
|
|
|
{start_tabs}
|
|
{tab|mac}
|
|
|
|
#### Disk image (recommended)
|
|
|
|
1. Download [Zulip for macOS](https://zulip.com/apps/mac).
|
|
|
|
1. Open the file, and drag the app into the `Applications` folder.
|
|
|
|
The app will update automatically to future versions.
|
|
|
|
#### Homebrew
|
|
|
|
1. Run the command `brew install --cask zulip` from a terminal.
|
|
|
|
1. Run Zulip from `Applications`.
|
|
|
|
The app will update automatically to future versions. Alternatively, you can
|
|
run the command `brew upgrade zulip` to immediately upgrade.
|
|
|
|
{tab|windows}
|
|
|
|
#### Web installer (recommended)
|
|
|
|
1. Download and run [Zulip for Windows](https://zulip.com/apps/windows).
|
|
|
|
1. Run Zulip from the Start menu.
|
|
|
|
The app will update automatically to future versions.
|
|
|
|
#### Offline installer (for isolated networks)
|
|
|
|
1. Download [zulip-x.x.x-x64.nsis.7z][latest] for 64-bit desktops
|
|
(common), or [zulip-x.x.x-ia32.nsis.7z][latest] for 32-bit (rare).
|
|
|
|
2. Copy the installer file to the machine you want to install the app
|
|
on, and run it there.
|
|
|
|
3. Run Zulip from the Start menu.
|
|
|
|
The app will NOT update automatically. You can repeat these steps to upgrade
|
|
to future versions. <!-- TODO fact check -->
|
|
|
|
{tab|linux}
|
|
|
|
#### APT (Ubuntu or Debian 8+)
|
|
|
|
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 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.
|
|
|
|
1. Run Zulip from your app launcher, or with `zulip` from a terminal.
|
|
|
|
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`.
|
|
|
|
#### AppImage (recommended for all other distros)
|
|
|
|
1. Download [Zulip for Linux](https://zulip.com/apps/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 name of the downloaded file).
|
|
|
|
3. Run the file from your app launcher, or from a terminal.
|
|
|
|
No installer is necessary; this file is the Zulip app. The app will update
|
|
automatically to future versions.
|
|
|
|
#### Snap
|
|
|
|
1. Make sure [snapd](https://docs.snapcraft.io/core/install) 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.
|
|
|
|
<!-- TODO why dpkg? -->
|
|
|
|
{end_tabs}
|
|
|
|
## Install a beta release
|
|
|
|
Get a peek at new features before they're released!
|
|
|
|
#### macOS, Windows, and most Linux distros
|
|
|
|
Start by finding the latest version marked "Pre-release" on the
|
|
[release list page][release-list]. There may or may not be a "Pre-release"
|
|
later than the latest release. If there is, download the appropriate Zulip
|
|
installer or app from there, and follow the instructions for your operating
|
|
system above.
|
|
|
|
#### Linux with apt (Ubuntu or Debian 8+)
|
|
|
|
If installing from scratch, follow the instructions above, except in the
|
|
command starting `echo "deb https://...` replace `stable` with `beta`.
|
|
|
|
If you've already installed the stable version, edit `zulip-desktop.list` and
|
|
reinstall:
|
|
```
|
|
sudo sed -i s/stable/beta/ /etc/apt/sources.list.d/zulip-desktop.list
|
|
sudo apt update
|
|
sudo apt install zulip
|
|
```
|
|
|
|
[latest]: https://github.com/zulip/zulip-desktop/releases/latest
|
|
[release-list]: https://github.com/zulip/zulip-desktop/releases
|
|
|
|
## Related articles
|
|
|
|
* [Connect through a proxy](/help/connect-through-a-proxy)
|
|
* [Use a custom certificate](/help/custom-certificates)
|
|
* [View Zulip version](/help/view-zulip-version)
|