jami-docs/setup/index.md

# Setup

```{contents}
   :local:
   :depth: 3
```

## Jami application

To download and install the Jami application, select the app store, the operating system, or the platform:

```{toctree}
:maxdepth: 1

alma-linux-os
app-store
chocolatey
debian
f-droid
federa-linux
google-play
linux-mint
mac-os
open-suse
snap-store
trisquel
ubuntu
windows
zorin-os
```

## 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:<br>
    Jami account (\*.jac)<br>
    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:

```{toctree}
:maxdepth: 1

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

## Accounts

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