Aller au contenu

Configuration initiale

  • ssdv2
  • ssh
  • putty
  • linux
  • security
  • git

Abstract

Cette section couvre la configuration initiale d’un serveur avant d’installer/administrer SSDV2 :
connexion SSH via PuTTY, création d’un utilisateur non-root (avec sudo), mise à jour du système, installation de Git, bascule propre de root vers non-root, puis clonage et correction des permissions du dépôt SSDV2.

TL;DR

1) Se connecter en SSH (PuTTY)
2) Créer un utilisateur non-root + l’ajouter à sudo
3) Mettre à jour le système + installer Git
4) Quitter root (reconnexion non-root ou su -l)
5) Cloner SSDV2 + corriger les permissions (chown)

Raccourci mental

Root = dépannage ponctuel • Non-root + sudo = exploitation normale • Session root fermée dès que possible

Objectif & règles d’or

  • ✅ Se connecter au serveur en SSH
  • ✅ Créer un utilisateur non-root et lui donner les droits sudo
  • ✅ Mettre à jour le système et installer Git
  • ✅ Arrêter d’utiliser root pour la suite du guide
  • ✅ Cloner SSDV2 et corriger les permissions

Sécurité

Pour la suite du guide, il est impératif de ne plus utiliser le compte root :
risque d’erreurs destructives, permissions incohérentes, et mauvaises pratiques d’exploitation.

Vue d’ensemble (ordre recommandé)

flowchart TD A["Connexion SSH (PuTTY)"] --> B["Création utilisateur non-root"] B --> C["Ajout au groupe sudo"] C --> D["Mise à jour système (apt)"] D --> E["Installation Git"] E --> F["Bascule root -> non-root"] F --> G["Clonage SSDV2"] G --> H["Correction permissions (chown)"] H --> I["Configuration initiale terminée ✅"]

Connexion SSH

Étape 1 — Installer PuTTY

  1. Rendez-vous sur le site officiel : https://www.putty.org/
  2. Téléchargez la version correspondant à votre OS
  3. Exécutez l’installateur
Alternative (optionnel)

Sur Windows 10/11, vous pouvez aussi utiliser Windows Terminal + ssh natif.
PuTTY reste parfaitement valide et très courant.

Étape 2 — Se connecter au serveur

  1. Ouvrez PuTTY
  2. Host Name (or IP address) : IP ou hostname du serveur
  3. Port :
  4. par défaut : 22 (peut varier)
  5. Protocole : SSH
  6. (Optionnel) Saved Sessions : enregistrez la session
  7. Cliquez Open
  8. Alerte “clé inconnue” : cliquez Yes
  9. Entrez login + mot de passe
  10. Shell obtenu : SSH OK ✅

Bon réflexe sécurité

Si vous avez un accès console/panel VPS, vérifiez l’empreinte de la clé SSH lors de la première connexion (MITM rare, mais bon réflexe).

Création d’un utilisateur non-root

Remplacez nom_utilisateur par le nom choisi.

Créer un utilisateur standard

adduser nom_utilisateur

Ajouter l’utilisateur au groupe sudo

usermod -aG sudo nom_utilisateur

Validation rapide

Une fois connecté avec l’utilisateur : - exécutez sudo -v
- si un mot de passe est demandé et accepté, vos droits sudo sont OK.

Mise à jour des paquets

sudo apt update && sudo apt upgrade -y

Pourquoi maintenant ?

Installer SSDV2 sur une base à jour réduit les surprises (sécurité, compatibilité, versions).

Installation de Git

sudo apt install -y git

Passage de root à non-root (obligatoire)

Pour la suite du guide : n’utilisez plus root.

  1. Fermez la session PuTTY root
  2. Ouvrez PuTTY à nouveau
  3. Connectez-vous avec nom_utilisateur

Dans la session actuelle :

su -l nom_utilisateur

Puis saisissez le mot de passe de nom_utilisateur.

Pourquoi su -l ?

su -l simule une vraie connexion (environnement propre), ce qui évite des incohérences de chemins/permissions.

Risque (permissions)

Continuer en root entraîne souvent des permissions incohérentes et des erreurs difficiles à diagnostiquer.
Passez non-root maintenant, pas “plus tard”.

Clonage du script SSDV2

Une fois connecté en non-root, clonez le dépôt SSDV2 :

sudo git clone https://github.com/projetssd/ssdv2.git /home/${USER}/seedbox-compose

Pourquoi sudo ici ?

Selon le système, l’écriture dans le chemin cible peut nécessiter des droits élevés.
L’étape suivante remet tout proprement au bon propriétaire.

Appropriation des droits sur le dossier SSDV2

sudo chown -R ${USER}: /home/${USER}/seedbox-compose

Validation

Votre utilisateur doit être propriétaire du dossier : plus de galères de permissions lors de l’exécution.

Checklist finale (validation)

  • Connexion SSH OK
  • Utilisateur non-root créé
  • Utilisateur ajouté à sudo
  • Système à jour (apt update/upgrade)
  • Git installé
  • Session root abandonnée (vous travaillez en non-root)
  • Dépôt SSDV2 cloné dans /home/${USER}/seedbox-compose
  • Permissions corrigées (chown effectué)

Diagramme de séquence (résumé)

sequenceDiagram autonumber actor U as Admin participant P as PuTTY participant S as Serveur participant A as APT participant G as Git participant R as Repo SSDV2 U->>P: Ouvre session SSH (root) P->>S: Connexion U->>S: adduser nom_utilisateur U->>S: usermod -aG sudo nom_utilisateur alt Reconnexion (recommandé) U->>P: Ferme session root U->>P: Ouvre session non-root else su -l (rapide) U->>S: su -l nom_utilisateur end U->>A: sudo apt update && sudo apt upgrade -y U->>A: sudo apt install -y git U->>G: sudo git clone SSDV2 G->>R: Clone dépôt U->>S: sudo chown -R ${USER}: /home/${USER}/seedbox-compose S-->>U: Prêt pour la suite ✅

Félicitations 🎉

La configuration initiale est terminée ✅
Vous pouvez maintenant continuer SSDV2 dans de bonnes conditions : sécurité, permissions propres, base système saine.