# Installation

[![image.png](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/whqimage-png.png)](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/whqimage-png.png)

### Installer les paquets

Connectez-vous sur votre machine Linux et mettez à jour la liste des paquets :

```
apt-get update
```

Ensuite, installez le paquet "samba" :

```
apt-get install -y samba
```

Suite à l'installation, on peut afficher la version actuelle de Samba via la commande *smbd* :

```
smbd --version
Version 4.13.5-Debian
```

Pour afficher le statut du serveur Samba, et voir s'il est démarré ou arrêté, voici la commande à exécuter :

```
systemctl status smbd
```

Avant de passer à la suite, nous allons activer le démarrage automatique de *smbd* (Samba) :

```
systemctl enable smbd
```

Maintenant, passons à la création du partage Samba.

### Créer un partage

La création du partage va s'effectuer en plusieurs étapes : la configuration de Samba dans un premier temps, et la préparation du groupe, de l'utilisateur et du dossier du partage dans un second temps.

#### smb.conf

Le fichier de configuration de Samba est "*/etc/samba/smb.conf*", nous allons l'éditer :

```
nano /etc/samba/smb.conf
```

Ajoutez ensuite les lignes suivantes pour déclarer notre partage :

```
[partage]
   comment = Partage de données
   path = /srv/partage
   guest ok = no
   read only = no
   browseable = yes
   valid users = @partage
```

Quelques explications :

- **\[partage\]** : sert à spécifier le nom du partage entre "\[\]", c'est le nom qui devra être utilisé pour accéder au partage
- **comment** : description du partage
- **path** : chemin vers le dossier à partager, sur le serveur
- **guest ok** : accès invité au partage (par défaut "*no*"). Si vous décidez d'activer cette option, vous devez configurer l'option "*guest account*" qui par défaut prend la valeur "*nobody*".
- **read only** : partage accessible uniquement en lecture seule (*yes* ou *no*)
- **browseable** : le partage doit-il être visible ou masqué si on liste les partages du serveur avec un hôte distant (découverte réseau). La valeur "*yes*" permet de le rendre visible.
- **valid users** : spécifier les utilisateurs ou les groupes qui ont les droits d'accès au partage (*les droits sur le système de fichiers doivent être cohérents vis-à-vis de cette autorisation*). On précise un utilisateur avec son identifiant et un groupe avec son identifiant précédé du caractère "@". Pour indiquer plusieurs valeurs, séparez-les par une virgule.

La configuration étant terminée, sauvegardez le fichier et redémarrez le service *smbd* :

```
systemctl restart smbd
```

#### Créer un utilisateur et un groupe

Le groupe "*partage*" que nous avons déclaré dans la configuration n'existe pas. Nous allons créer le groupe, ainsi qu'un utilisateur nommé "*it-connect*" et qui sera membre de ce groupe.

Créez l'utilisateur "*it-connect*" et définissez son mot de passe :

```
adduser rakouns
```

Pour que l'utilisateur puisse se connecter au partage, il faut l'autoriser dans Samba, en plus de la création au sein du système Linux. Pour cela, il faut utiliser la commande "***smbpasswd***" pour **déclarer l'utilisateur et lui créer un mot de passe Samba** (ce dernier pouvant être différent du mot de passe du compte sur le système).

Voici la commande pour ajouter l'utilisateur "*it-connect*" :

```
smbpasswd -a rakouns
```

Lorsqu'un utilisateur exécute lui-même la commande "*smbpasswd*", cela lui permet de modifier lui-même son mot de passe Samba.

L'utilisateur étant prêt, nous allons créer le groupe "*partage*" :

```
groupadd partage
```

Avec **gpasswd** ou **usermod**, ajoutez l'utilisateur "*rakouns*" au groupe "*partage*" :

```
gpasswd -a rakouns partage
```

Le tour est joué pour l'utilisateur et le groupe !

#### Préparer le dossier du partage

Le partage va être hébergé à l'emplacement "/srv/partage" de notre serveur. Commençons par créer le dossier :

```
mkdir /srv/partage
```

Ensuite, on va attribuer le groupe "*partage*" comme groupe propriétaire de ce dossier :

```
chgrp -R partage /srv/partage/
```

Puis, nous allons ajouter les droits de lecture/écriture à ce groupe sur ce dossier :

```
chmod -R g+rw /srv/partage/
```

On peut vérifier la configuration des droits avec la commande suivante :

```
ls -l /srv/
```

Tout est prêt, nous pouvons tester depuis un poste client.