# 02 - Installation

## <span style="text-decoration: underline; color: rgb(45, 194, 107);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">A - Préparation à l'installation :</span></span></span></span></span></span></span></span></span></span>**</span>

> [<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">https://docs.zammad.org/en/latest/install/package.html</span></span></span></span></span></span></span></span></span></span>](https://docs.zammad.org/en/latest/install/package.html)
> 
> [<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">https://docs.zammad.org/en/latest/install/elasticsearch.html#configure-zammad-with-elasticsearch</span></span></span></span></span></span></span></span></span></span>](https://docs.zammad.org/en/latest/install/elasticsearch.html#configure-zammad-with-elasticsearch)
> 
> [<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">https://docs.zammad.org/en/latest/getting-started/configure-webserver.html</span></span></span></span></span></span></span></span></span></span>](https://docs.zammad.org/en/latest/getting-started/configure-webserver.html)

### <span style="color: rgb(53, 152, 219);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">1. Prérequis :</span></span></span></span></span></span></span></span></span></span>**</span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Tout d'abord, pour le bon fonctionnement de Zammad il vous faudra installer Postfix.</span></span>

```bash
#Installation postfix
apt install postfix
```

### <span style="color: rgb(53, 152, 219);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">2. Installation de la dépendances du forfait :</span></span></span></span></span></span></span></span></span></span>**</span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Les dépendances ci-dessous doivent être installées sur votre système.</span></span></span></span></span></span></span></span></span></span>

```bash
#Installation des dépendances du package
apt install curl apt-transport-https gnupg
```

### <span style="color: rgb(53, 152, 219);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">3. Configuration d'Elasticsearch :</span></span></span></span></span></span></span></span></span></span>**</span>

<p class="callout info"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Source : https://docs.zammad.org/en/latest/install/elasticsearch.html</span></span></span></span></span></span></span></span></span></span></p>

#### <span style="color: rgb(35, 111, 161);">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Installation</span></span></span></span></span></span></span></span></span></span>***</span>

```bash
#Installation d'Elacticsearch

apt install apt-transport-https sudo wget curl gnupg

echo "deb [signed-by=/etc/apt/trusted.gpg.d/elasticsearch.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main"| \
  tee -a /etc/apt/sources.list.d/elastic-7.x.list > /dev/null

curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | \
  gpg --dearmor | tee /etc/apt/trusted.gpg.d/elasticsearch.gpg> /dev/null

apt update

apt install elasticsearch

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment
```

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Après avoir installé Elasticsearch et son plugin de pièce jointe, assurez-vous de l'activer par défaut et démarrez-le.</span></span></span></span></span></span></span></span></span></span>

```bash
#Démarrage d'Elasticsearch
systemctl start elasticsearch
systemctl enable elasticsearch
```

### <span style="color: rgb(53, 152, 219);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">4. Vérification des paramètres régionaux :</span></span></span></span></span></span></span></span></span></span>**</span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Pour que Zammad fonctionne correctement, votre système doit utiliser les paramètres régionaux corrects.</span></span></span></span></span></span></span></span></span></span>

```bash
#Répertoriez vos paramètres régionaux actuels
apt install locales
locale-gen fr_FR.UTF-8
echo "LANG=fr_FR.UTF-8
```

## <span style="text-decoration: underline; color: rgb(45, 194, 107);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">B - Installation de Zammad :</span></span></span></span></span></span></span></span></span></span>**</span>

#### <span style="color: rgb(35, 111, 161);">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Ajout d'un référentiel</span></span></span></span></span></span></span></span></span></span>***</span>

```bash
#Installer la clé référentiel
curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
  gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null

#Ubuntu 22.04 
echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| \
   tee /etc/apt/sources.list.d/zammad.list > /dev/null
```

#### <span style="color: rgb(35, 111, 161);">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> Installation de Zammad </span></span></span></span></span></span></span></span></span></span>***</span>

```bash
#Installation de Zammad
apt update
apt install zammad
```

## <span style="text-decoration: underline; color: rgb(45, 194, 107);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">C - Connexion à Zammad :</span></span></span></span></span></span></span></span></span></span>**</span>

```bash
#Définir l'adresse du serveur Elasticsearch
zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"

#Construire l'index de recherche
zammad run rake zammad:searchindex:rebuild
```

## <span style="text-decoration: underline; color: rgb(45, 194, 107);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">D - Configuration des fichiers de conf :</span></span></span></span></span></span></span></span></span></span>**</span>

#### <span style="color: rgb(35, 111, 161);">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> Obtenez un fichier de configuration actuelle</span></span></span></span></span></span></span></span></span></span>***</span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Copiez et écrasez la valeur par défaut </span></span></span></span></span></span></span></span></span></span>`<span class="pre">zammad.conf</span>`<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> en utilisant</span></span></span></span></span></span></span></span></span></span>

```bash
cp /opt/zammad/contrib/nginx/zammad_ssl.conf /etc/nginx/sites-available/zammad.conf
```

#### <span style="color: rgb(35, 111, 161);">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> Ajustez le fichier de configuration</span></span></span></span></span></span></span></span></span></span>***</span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Ajustez le fichier que vous venez de copier avec un éditeur de texte de votre choix (par exemple </span></span></span></span></span></span></span></span></span></span>`<span class="pre">vi</span>`<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">ou </span></span></span></span></span></span></span></span></span></span>`<span class="pre">nano</span>`<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">).</span></span></span></span></span></span></span></span></span></span>

```bash
nano /etc/nginx/sites-available/zammad.conf
```

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Localisez n'importe quelle </span></span></span></span></span></span></span></span></span></span>`<span class="pre">server_name</span>` <span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">directive et ajustez </span></span></span></span></span></span></span></span></span></span>`<span class="pre">example.com</span>` <span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">la au sous-domaine que vous avez choisi pour votre instance Zammad.</span></span></span></span></span></span></span></span></span></span>

[![image.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/77dimage.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/77dimage.png)

<p class="callout warning"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Pour que le serveur soit opérationnel, il est important de supprimer toute la partie ssl du fichier de conf étant donné que c'est le proxy qui prendra en charge le ssl.</span></span>[![2023-12-07 10_07_36-Édition Page 02 - Installation _ Wiki Morbihan-Energies.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/2023-12-07-10-07-36-edition-page-02-installation-wiki-morbihan-energies.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/2023-12-07-10-07-36-edition-page-02-installation-wiki-morbihan-energies.png)</p>

#### <span style="color: rgb(35, 111, 161);">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> Configuration du </span></span></span></span></span></span></span></span></span></span>***</span><span style="color: #236fa1;"><span style="font-size: 23.324px;">***<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> conteneur</span></span>***</span></span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Après avoir édité le fichier de configuration de </span></span><span id="bkmrk-zammad"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Zammad</span></span></span><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> , il est nécessaire de modifier également celui du conteneur </span></span><span id="bkmrk-lxc"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">LXC</span></span></span><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"> .</span></span>

```bash
#Configuration du conteneur LXC
lxc config edit {CT_Name}
```

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Une fois dans le fichier de conf, supprimez la ligne "devices \[ \]" et remplacez le par : </span></span>

```bash
devices:
 eth0:
  ipv4.address: {adresse ip du conteneur}
  name: eth0
  network: lxdbr1
  type: nic
port22215:
  connect: tcp:0.0.0.0:22
  listen: tcp:192.168.56.190:22215
  type: proxy
port44215:
  connect: tcp:0.0.0.0:80
  listen: tcp:192.168.56.190:44215
  type: proxy
```

<p class="callout warning"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Attention, pensez à bien modifier l'adresse Ip ainsi que les différents ports.</span></span></p>

## <span style="text-decoration: underline; color: rgb(45, 194, 107);">**<span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">E - Configuration du Serveur Web :</span></span></span></span></span></span></span></span></span></span>**</span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Une fois arrivé sur la page ci-dessous, la configuration peut commencer.</span></span>

[![Zammad Web.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/zammad-web.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/zammad-web.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Après avoir cliqué sur "Set ip a new system", il vous faudra créer un compte administrateur.</span></span>

[![02-Compte admin Zammad.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/02-compte-admin-zammad.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/02-compte-admin-zammad.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Ensuite, vous devrez remplir le nom et le logo de l'organisation.</span></span>

[![03-Organisation.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/mT303-organisation.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/mT303-organisation.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Maintenant, vous devrez configurer la notification par e-mail.</span></span>

[![04-Notif Email.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/04-notif-email.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/04-notif-email.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Ici, vous avez le choix de connecter les canaux ou bien de passer afin d'utiliser Zammad au plus vite.</span></span>

[![05-paramétrage des canaux.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/05-parametrage-canaux.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/05-parametrage-canaux.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Si vous choisissez de connecter les canaux, vous devrez remplir le compte email.</span></span>

[![06- E-mail.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/06-email.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/06-email.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Puis pour finir, vous devrez remplir l'email entrant.</span></span>

[![07-Email participant.png](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/scaled-1680-/07-email-entrant.png)](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/07-email-entrant.png)

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Une fois toutes ces étapes finies, l'installation de votre Zammad est terminée et vous n'avez plus cas l'utiliser !</span></span>