← Retour au site AssAI · Guide d'installation · Tous les guides
Avant de commencer
- Il faut un compte chez l'hébergeur et un moyen de paiement. La facture doit être faite au nom de l'entreprise (voir l'étape 3).
- Ne jamais écrire un mot de passe, une phrase secrète ni la clé privée SSH dans un message, un mail ou une photo.
- Ce guide ne donne aucune adresse réelle. Dans les exemples : IP-DE-VOTRE-VPS = l'adresse donnée par l'hébergeur, NOM-DU-SERVEUR = le nom donné par l'hébergeur, NOM = votre nom d'utilisateur, MA-CLE = le nom de votre clé SSH.
1 · Choisir l'offre
- Sur le site de l'hébergeur, ouvrir la rubrique VPS.
- Choisir l'offre KVM 2 (la même offre que celle prévue pour AssAI Cloud).
- Ne pas ajouter d'options payantes au départ : elles peuvent toujours être ajoutées plus tard.
2 · Choisir le data center
- Choisir la France, le data center le plus proche des utilisateurs. Les données restent ainsi en Europe, et les temps de réponse sont courts.
3 · Facturer au nom de l'entreprise
- Pendant la commande, renseigner les coordonnées de l'entreprise (nom, adresse) et non celles d'une personne.
- Ajouter le numéro de TVA intracommunautaire de l'entreprise, pour que la facture soit correcte.
- Garder la facture : elle sert à la comptabilité de l'entreprise, et elle est rangée avec les autres factures.
4 · Système d'exploitation
- Choisir Ubuntu 26.04 LTS, sans panneau d'administration : AssAI s'installe directement sur le système. Les mises à jour de sécurité sont assurées jusqu'en 2031.
5 · Renouvellement et rappel
- L'hébergeur renouvelle l'abonnement automatiquement. Le prix et la date sont indiqués dans l'espace client.
- Mettre un rappel dans son agenda quelques jours avant la date de renouvellement, pour vérifier l'offre et le moyen de paiement.
- Un rappel AssAI peut aussi être créé dans Secrétariat › Rappels.
6 · Les mots de passe et la clé SSH
Il y a deux secrets, à garder dans le gestionnaire de mots de passe (par exemple Proton Pass), avec des noms clairs :
- « VPS-root » : le mot de passe root du serveur. Il sert seulement dans l'espace de l'hébergeur (réinstallation, console web). La console web ne sait pas coller : choisir un mot de passe facile à taper.
- « VPS-Keys » : la phrase de la clé du PC (dans le texte) et les fichiers de la clé (en pièce jointe). Elle sert partout ailleurs (ssh, scp, ssh-add). Lettres et chiffres, sans accents.
La clé SSH se crée sur le PC. Une clé par PC. La clé privée reste sur le PC et ne se partage jamais ; seule la clé publique est envoyée à l'hébergeur.
Règle d'or : enregistrer la phrase dans le gestionnaire avant de l'utiliser, et la re-copier depuis le gestionnaire juste avant chaque demande « Enter passphrase » (le presse-papier peut contenir autre chose, par exemple la clé publique).
Une clé ne se modifie pas : pour en changer, on en ajoute une nouvelle dans l'espace de l'hébergeur, puis on supprime l'ancienne.
7 · Procédure complète, en 10 étapes
Cette procédure refait le serveur à zéro. Elle a marché tel quel.
- Gestionnaire de mots de passe : créer ou vérifier les 2 entrées de l'étape 6.
- PC, PowerShell : créer la clé si besoin, la tester, puis afficher la clé publique :
ssh-keygen -t ed25519 -C "nom-de-mon-pc" -f $env:USERPROFILE\.ssh\MA-CLE
ssh-keygen -y -f $env:USERPROFILE\.ssh\MA-CLE # test : doit afficher une ligne ssh-ed25519
Get-Content $env:USERPROFILE\.ssh\MA-CLE.pub # ligne à coller chez l'hébergeur
- Espace de l'hébergeur › VPS › Clés SSH : la liste des clés du VPS n'est pas la même que celle du compte. Supprimer les anciennes clés, puis ajouter la nouvelle (le nom = le commentaire de la clé).
- Espace de l'hébergeur › VPS › Système d'exploitation › Réinstaller : Ubuntu 26.04 sans panneau, mot de passe root = entrée 1 du gestionnaire, cocher la clé. Confirmer en tapant le nom du serveur.
- Console web de l'hébergeur (connexion root, mot de passe tapé à la main) : l'image fournie par l'hébergeur interdit la connexion root par SSH. On l'ouvre provisoirement, avec la clé seulement :
echo "PermitRootLogin prohibit-password" > /etc/ssh/sshd_config.d/00-a.conf && systemctl restart ssh
sshd -T | grep -i permitroot # doit afficher prohibit-password
Le script d'installation (étape 7) supprime ce fichier à la fin.
- PC, PowerShell en administrateur : donner la phrase une seule fois au porte-clés de Windows :
Get-Service ssh-agent | Set-Service -StartupType Manual
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\MA-CLE # doit répondre « Identity added »
- Lancer l'installation depuis PowerShell (pas en double-clic : le collage y marche mal). Le script installe tout le serveur en une fois :
& "CHEMIN-DU-PROJET\_VPS-Setup\installer-vps.bat"
Répondre O, puis attendre la ligne « FINI ». Le mot de passe sudo n'est pas demandé.
- Espace de l'hébergeur › Pare-feu : rallumer le pare-feu « base ». Il se coupe après une réinstallation.
- Vérifier l'état du serveur (le script etat-vps.bat du dossier VPS le montre), puis redémarrer si on le demande.
- Mettre le site en ligne : publier-site.bat (copie par scp, sans WinSCP). Vérifier la page avec Ctrl + F5.
À détailler plus tard : couper la connexion root et les mots de passe en SSH, fail2ban, les mises à jour automatiques, Docker et Caddy. Ces étapes seront ajoutées par la session qui s'occupe du VPS.
8 · Domaine : enregistrements DNS
Cette étape permet d'atteindre le serveur avec le nom du site (et non avec l'adresse de l'hébergeur). Elle ne sert que si le domaine est bien géré par l'hébergeur.
- Vérifier que les serveurs de noms du domaine sont ceux de l'hébergeur. Si oui, la zone DNS se règle dans Espace de l'hébergeur › Domaines › DNS.
- Créer 3 enregistrements A qui pointent vers l'adresse du VPS (IP-DE-VOTRE-VPS) :
@ (le domaine nu), www et cloud (le sous-domaine d'AssAI Cloud). TTL : 300.
- Supprimer l'enregistrement CNAME de
www, s'il existe, pour qu'il ne fasse pas doublon avec le A.
- Ne pas cliquer « Réinitialiser les enregistrements DNS » : cela efface les autres réglages du domaine (mail, etc.).
9 · Première connexion, pas à pas
- Depuis PowerShell sur le PC, se connecter au serveur :
ssh root@IP-DE-VOTRE-VPS
Le mot de passe root n'est plus accepté en SSH : c'est la clé qui sert. Si la connexion root est refusée, voir les pièges ci-dessous.
- À la question Are you sure you want to continue connecting (yes/no)?, taper yes. C'est l'empreinte du serveur, ce n'est pas un secret.
- Tester une connexion avec l'utilisateur normal, dans une 2e fenêtre sur le PC :
ssh NOM@IP-DE-VOTRE-VPS
Si ça ne marche pas
| Symptôme | Cause | Solution |
| « Enter passphrase » revient 3 fois | Mauvaise phrase : souvent le presse-papier contient autre chose, ou la phrase n'a pas été enregistrée | Tester avec ssh-keygen -y -f … ; retrouver la phrase dans le gestionnaire ; la re-copier juste avant |
| Une seule demande de phrase, puis « Permission denied » | Phrase vide : le collage n'a pas marché | Lancer le script depuis PowerShell, ou faire ssh-add avant |
Permission denied (publickey) sans demande de phrase | Le serveur ne connaît pas la clé : mauvaise clé cochée à la réinstallation, ou la liste du VPS n'a pas la clé | Corriger Espace de l'hébergeur › VPS › Clés SSH, puis refaire l'étape 4 |
| Même erreur, mais la clé est acceptée ailleurs | L'image fournie par l'hébergeur interdit la connexion root (PermitRootLogin no) | Étape 5 de la procédure |
Connection reset au début de la connexion | Adresse IP bloquée après trop d'essais | Ne pas réessayer en boucle : changer de VPN (une autre sortie), ou passer par la console web et redémarrer le service SSH |
sudo demande un mot de passe | Ancienne configuration | Ne plus le cas avec l'installation : sudo ne demande pas de mot de passe |
| WinSCP refuse la clé (« decryption check failed ») | Conversion de la clé refusée | Ne plus utiliser WinSCP : publier-site.bat (scp) |
No such file pour une commande Linux | Commande serveur tapée sur le PC | PS C:\…> = le PC ; NOM@…$ = le serveur |
| Des « y » s'écrivent sans fin | yes tapé sur la ligne du serveur | Faire Ctrl + C |
| Un test de ports montre tout « ouvert » depuis le PC | Le VPN répond à tous les ports | Vérifier depuis le serveur (sudo ss -tlnp) |
| Le site est en erreur 502 sur cloud | Le service AssAI Cloud n'est pas encore installé | Normal pour l'instant : la page « bientôt » suffit |
| Le serveur est en Amérique ou en Asie | Mauvais data center à la commande | Demander le changement à l'hébergeur avant de mettre des données dessus |
| Le paiement est refusé | Moyen de paiement ou coordonnées de l'entreprise | Vérifier les deux |
| Le pare-feu bloque tout après la réinstallation | Le pare-feu de l'hébergeur se coupe après une réinstallation | Le rallumer (étape 8 de la procédure) |
Coller dans PowerShell se fait avec le clic droit. Pour un mot de passe, rien ne s'affiche : c'est normal.