Setup Jami

This section is a guide for installing Jami on the platform of choice and configuring key features such as accounts, device linking, backups, and extensions.

Download and install Jami

For the desired platform, select the source to download and install the Jami application.

Jami for Android

Tip

Android includes both Android and Android TV devices.

F-Droid

Google Play

Jami for GNU/Linux

Select the distribution or the package manager.

Distribution

AlmaLinux	Alpine Linux	ALT Linux
Arch Linux	CentOS Stream	Clear Linux OS
Crystal Linux	Debian	Deepin
elementary OS	EndeavourOS	Endless OS
Fedora Linux	Gentoo Linux	GNU Guix
KDE neon	Kubuntu	Linux Mint
Mageia	Manjaro	MX Linux
NixOS	OpenMandriva Lx	openSUSE
Pardus	Pisi GNU/Linux	Pop!_OS
PureOS	Raspberry Pi OS	Red Hat Enterprise Linux
Rocky Linux	Salix	Solus
Trisquel	Ubuntu	Vanilla OS
Void Linux	Zorin OS

Package manager

Flathub

Homebrew

Snap Store

Jami for iOS

Tip

iOS includes both iPhone and iPad devices.

App Store

Jami for macOS

Select the operating system or the package manager.

Operating system

macOS

Package manager

Homebrew

Jami for Windows

Select the operating system or the package manager.

Operating system

Windows

Package manager

Chocolatey

Jami for servers

Server

Jami for Web

Note

Jami for Web is under development.

Web

---

Accounts

To set up any number of SIP accounts, Jami accounts, and JAMS accounts on one or multiple devices, visit the:

• Videos

• User manual

• JAMS manual

Add yourself

Tip

This is one of the many unique features of Jami.

Add yourself as a contact to enable:

• Peer-to-peer (without a third-party server) file transfers between your devices.

• Calling your account on other devices if you forget where the device is.

• Having one account shared in a family or organization to answer calls from shared contacts.

• Calling yourself to talk with members in the family or organization who are at different locations.

• Writing notes and lists to yourself that are available on all your devices.

• Other use cases that are not listed here.

---

Link devices

Link devices to use the same JAMI protocol account.

Back up JAMI protocol accounts

Important

If a JAMI protocol account has no account backup and is removed from all linked devices, the account is unable to be retrieved.

Back up all JAMI protocol accounts.

---

Jami extensions

Note

Jami extensions for Android and Jami extensions for Desktop could be in one file; however, it is often chosen to distribute the extensions separately for Jami for Desktop and Jami for Android to have smaller file sizes.

The Jami extensions for Desktop include multiple architectures (GNU/Linux, macOS, and Windows), and the extension preferences system is designed around a declarative mechanism to allow a native presentation of extension preferences across various Jami applications (i.e., the Jami client and the user interface (UI)).

The JXD (Jami eXtension for Desktop) file extension and the JXA (Jami eXtension for Android) file extension could be merged to the JXU (Jami eXtension Unified) file extension, as the Jami extension system is a unified format.

Unfortunately the “marketing” name for plugins was changed to extensions after years of development, and it would be too much work to change everything to extensions.

Currently, the consensus is to keep the JPL file extension, even if it is inconsistent with the UI, as most users would manage extensions through the Jami UI.

Important

Jami accounts and extensions have the description and file extension as shown below:

• Jami account (*.jac)

• Jami extension (*.jpl)

Tip

• Android includes both Android and Android TV devices.

• Desktop means devices with the Apple macOS, a GNU/Linux, or the Microsoft Windows operating systems.

• iOS means iPad and iPhone devices with the iOS operating system.

• Web means access with a web browser.

To download and install Jami extensions, select the Jami application:

Jami extensions for Android	Jami extensions for Desktop
Jami extensions for iOS	Jami extensions for Web