# 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.

```{contents}
   :local:
   :depth: 1
```

## Download and install Jami

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

```{contents}
   :local:
   :depth: 1
```

### Jami for Android

```{admonition} Tip
Android includes both Android and Android TV devices.
```

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

f-droid
google-play
```

```{list-table}
:header-rows: 0

* - [![«Image: F-Droid logo»](images/f-droid-logo.png "F-Droid logo") F-Droid](f-droid.md)
  - [![«Image: Android logo»](images/android-logo.png "Android logo") Google Play](google-play.md)
```

### Jami for GNU/Linux

Select the distribution or the package manager.

#### Distribution

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

alma-linux
alpine-linux
alt-linux
arch-linux
cent-os-stream
clear-linux-os
crystal-linux
debian
deepin
elementary-os
endeavour-os
endless-os
fedora-linux
gentoo-linux
gnu-guix
kde-neon
kubuntu
linux-mint
mageia
manjaro
mx-linux
nix-os
open-mandriva-lx
open-suse
pardus
pisi-gnu-linux
pop-os
pure-os
raspberry-pi-os
red-hat-enterprise-linux
rocky-linux
salix
solus
trisquel
ubuntu
vanilla-os
void-linux
zorin-os
```

```{list-table}
:header-rows: 0

* - [![«Image: AlmaLinux logo»](images/alma-linux-logo.png "AlmaLinux logo") AlmaLinux](alma-linux.md)
  - [![«Image: Alpine Linux logo»](images/alpine-linux-logo.png "Alpine Linux logo") Alpine Linux](alpine-linux.md)
  - [![«Image: ALT Linux logo»](images/alt-linux-logo.png "ALT Linux logo") ALT Linux](alt-linux.md)
* - [![«Image: Arch Linux logo»](images/arch-linux-logo.png "Arch Linux logo") Arch Linux](arch-linux.md)
  - [![«Image: CentOS Stream logo»](images/cent-os-stream-logo.png "CentOS Stream logo") CentOS Stream](cent-os-stream.md)
  - [![«Image: Clear Linux OS logo»](images/clear-linux-os-logo.png "Clear Linux OS logo") Clear Linux OS](clear-linux-os.md)
* - [![«Image: Crystal Linux logo»](images/crystal-linux-logo.png "Crystal Linux logo") Crystal Linux](crystal-linux.md)
  - [![«Image: Debian logo»](images/debian-logo.png "Debian logo") Debian](debian.md)
  - [![«Image: Deepin logo»](images/deepin-logo.png "Deepin logo") Deepin](deepin.md)
* - [![«Image: elementary OS logo»](images/elementary-os-logo.png "elementary OS logo") elementary OS](elementary-os.md)
  - [![«Image: EndeavourOS logo»](images/endeavour-os-logo.png "EndeavourOS logo") EndeavourOS](endeavour-os.md)
  - [![«Image: Endless OS logo»](images/endless-os-logo.png "Endless OS logo") Endless OS](endless-os.md)
* - [![«Image: Fedora Linux logo»](images/fedora-linux-logo.png "Fedora Linux logo") Fedora Linux](fedora-linux.md)
  - [![«Image: Gentoo Linux logo»](images/gentoo-linux-logo.png "Gentoo Linux logo") Gentoo Linux](gentoo-linux.md)
  - [![«Image: GNU Guix logo»](images/gnu-guix-logo.png "GNU Guix logo") GNU Guix](gnu-guix.md)
* - [![«Image: KDE neon logo»](images/kde-neon-logo.png "KDE neon logo") KDE neon](kde-neon.md)
  - [![«Image: Kubuntu logo»](images/kubuntu-logo.png "Kubuntu logo") Kubuntu](kubuntu.md)
  - [![«Image: Linux Mint logo»](images/linux-mint-logo.png "Linux Mint logo") Linux Mint](linux-mint.md)
* - [![«Image: Mageia logo»](images/mageia-logo.png "Mageia logo") Mageia](mageia.md)
  - [![«Image: Manjaro logo»](images/manjaro-logo.png "Manjaro logo") Manjaro](manjaro.md)
  - [![«Image: MX Linux logo»](images/mx-linux-logo.png "MX Linux logo") MX Linux](mx-linux.md)
* - [![«Image: NixOS logo»](images/nix-os-logo.png "NixOS logo") NixOS](nix-os.md)
  - [![«Image: OpenMandriva Lx logo»](images/open-mandriva-lx-logo.png "OpenMandriva Lx logo") OpenMandriva Lx](open-mandriva-lx.md)
  - [![«Image: openSUSE logo»](images/open-suse-logo.png "openSUSE logo") openSUSE](open-suse.md)
* - [![«Image: Pardus logo»](images/pardus-logo.png "Pardus logo") Pardus](pardus.md)
  - [![«Image: Pisi GNU/Linux logo»](images/pisi-gnu-linux-logo.png "Pisi GNU/Linux logo") Pisi GNU/Linux](pisi-gnu-linux.md)
  - [![«Image: Pop!_OS logo»](images/pop-os-logo.png "Pop!_OS logo") Pop!_OS](pop-os.md)
* - [![«Image: PureOS logo»](images/pure-os-logo.png "PureOS logo") PureOS](pure-os.md)
  - [![«Image: Raspberry Pi OS logo»](images/raspberry-pi-os-logo.png "Raspberry Pi OS logo") Raspberry Pi OS](raspberry-pi-os.md)
  - [![«Image: Red Hat Enterprise Linux logo»](images/red-hat-enterprise-linux-logo.png "Red Hat Enterprise Linux logo") Red Hat Enterprise Linux](red-hat-enterprise-linux.md)
* - [![«Image: Rocky Linux logo»](images/rocky-linux-logo.png "Rocky Linux logo") Rocky Linux](rocky-linux.md)
  - [![«Image: Salix logo»](images/salix-logo.png "Salix logo") Salix](salix.md)
  - [![«Image: Solus logo»](images/solus-logo.png "Solus logo") Solus](solus.md)
* - [![«Image: Trisquel logo»](images/trisquel-logo.png "Trisquel logo") Trisquel](trisquel.md)
  - [![«Image: Ubuntu logo»](images/ubuntu-logo.png "Ubuntu logo") Ubuntu](ubuntu.md)
  - [![«Image: Vanilla OS logo»](images/vanilla-os-logo.png "Vanilla OS logo") Vanilla OS](vanilla-os.md)
* - [![«Image: Void Linux logo»](images/void-linux-logo.png "Void Linux logo") Void Linux](void-linux.md)
  - [![«Image: Zorin OS logo»](images/zorin-os-logo.png "Zorin OS logo") Zorin OS](zorin-os.md)
  - <!-- Full rows are required to enable the table to be displayed. -->
```

#### Package manager

<!--
Required to show the Previous and the Next buttons.
The homebrew toctree link is under Jami for macOS.
-->
```{toctree}
:maxdepth: 1
:hidden:

flathub
snap-store
```

```{list-table}
:header-rows: 0

* - [![«Image: Flathub logo»](images/flathub-logo.png "Flathub logo") Flathub](flathub.md)
  - [![«Image: Homebrew logo»](images/homebrew-logo.png "Homebrew logo") Homebrew](homebrew.md)
  - [![«Image: Ubuntu logo»](images/ubuntu-logo.png "Ubuntu logo") Snap Store](snap-store.md)
```

### Jami for iOS

```{admonition} Tip
iOS includes both iPhone and iPad devices.
```

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

app-store
```

```{list-table}
:header-rows: 0

* - [![«Image: iOS logo»](images/ios-logo.png "iOS logo") App Store](app-store.md)
```

### Jami for macOS

Select the operating system or the package manager.

#### Operating system

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

mac-os
```

```{list-table}
:header-rows: 0

* - [![«Image: Apple logo»](images/apple-logo.png "Apple logo") macOS](mac-os.md)
```

#### Package manager

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

homebrew
```

```{list-table}
:header-rows: 0

* - [![«Image: Homebrew logo»](images/homebrew-logo.png "Homebrew logo") Homebrew](homebrew.md)
```

### Jami for Windows

Select the operating system or the package manager.

#### Operating system

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

windows
```

```{list-table}
:header-rows: 0

* - [![«Image: Windows logo»](images/windows-logo.png "Windows logo") Windows](windows.md)
```

#### Package manager

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

chocolatey
```

```{list-table}
:header-rows: 0

* - [![«Image: Windows logo»](images/windows-logo.png "Windows logo") Chocolatey](chocolatey.md)
```

### Jami for servers

```{list-table}
:header-rows: 0

* - [![«Image: Server logo»](images/server-logo.png "Server logo") Server](/user/jami-for-servers.md)
```

### Jami for Web

```{note}
Jami for Web is under development.
```

```{list-table}
:header-rows: 0

* - [![«Image: Web logo»](images/web-logo.png "Web logo") Web](/user/all-features-by-client.md)
```

-----------
## Accounts

To set up any number of SIP accounts, Jami accounts, and JAMS accounts on one or multiple devices, visit the:
* [Videos](/videos/index.md)
* [User manual](/user/index.md)
* [JAMS manual](/jams/index.md)

## Add yourself

```{admonition} 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

![«Image: Extensions»](images/extensions.png "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)
```

```{admonition} 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:

<!-- Required to show the Previous and the Next buttons. -->
```{toctree}
:maxdepth: 1
:hidden:

jami-extensions-for-android
jami-extensions-for-desktop
jami-extensions-for-ios
jami-extensions-for-web
```

```{list-table}
:header-rows: 0

* - [![«Image: Extensions logo»](images/extensions-logo.png "Extensions logo")![«Image: Android logo»](images/android-logo.png "Android logo") Jami extensions for Android](jami-extensions-for-android.md)
  - [![«Image: Extensions logo»](images/extensions-logo.png "Extensions logo")![«Image: Desktop logo»](images/desktop-logo.png "Desktop logo") Jami extensions for Desktop](jami-extensions-for-desktop.md)
* - [![«Image: Extensions logo»](images/extensions-logo.png "Extensions logo")![«Image: iOS logo»](images/ios-logo.png "iOS logo") Jami extensions for iOS](jami-extensions-for-ios.md)
  - [![«Image: Extensions logo»](images/extensions-logo.png "Extensions logo")![«Image: Web logo»](images/web-logo.png "Web logo") Jami extensions for Web](jami-extensions-for-web.md)
```