← Retour au site AssAI · Guide d'installation · Tous les guides

Créer un VPS

Commander le serveur virtuel qui accueillera AssAI Cloud · version 0.8 · 17 novembre 2026

Avant de commencer

1 · Choisir l'offre

  1. Sur le site de l'hébergeur, ouvrir la rubrique VPS.
  2. Choisir l'offre KVM 2 (la même offre que celle prévue pour AssAI Cloud).
  3. Ne pas ajouter d'options payantes au départ : elles peuvent toujours être ajoutées plus tard.

2 · Choisir le data center

  1. 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

  1. Pendant la commande, renseigner les coordonnées de l'entreprise (nom, adresse) et non celles d'une personne.
  2. Ajouter le numéro de TVA intracommunautaire de l'entreprise, pour que la facture soit correcte.
  3. Garder la facture : elle sert à la comptabilité de l'entreprise, et elle est rangée avec les autres factures.

4 · Système d'exploitation

  1. 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

  1. L'hébergeur renouvelle l'abonnement automatiquement. Le prix et la date sont indiqués dans l'espace client.
  2. Mettre un rappel dans son agenda quelques jours avant la date de renouvellement, pour vérifier l'offre et le moyen de paiement.
  3. 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 :

  1. « 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.
  2. « 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.

  1. Gestionnaire de mots de passe : créer ou vérifier les 2 entrées de l'étape 6.
  2. 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
  3. 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é).
  4. 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.
  5. 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.
  6. 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 »
  7. 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é.
  8. Espace de l'hébergeur › Pare-feu : rallumer le pare-feu « base ». Il se coupe après une réinstallation.
  9. Vérifier l'état du serveur (le script etat-vps.bat du dossier VPS le montre), puis redémarrer si on le demande.
  10. 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.

  1. 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.
  2. 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.
  3. Supprimer l'enregistrement CNAME de www, s'il existe, pour qu'il ne fasse pas doublon avec le A.
  4. Ne pas cliquer « Réinitialiser les enregistrements DNS » : cela efface les autres réglages du domaine (mail, etc.).

9 · Première connexion, pas à pas

  1. 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.
  2. À 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.
  3. 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ômeCauseSolution
« Enter passphrase » revient 3 foisMauvaise phrase : souvent le presse-papier contient autre chose, ou la phrase n'a pas été enregistréeTester 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 phraseLe 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 ailleursL'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 connexionAdresse IP bloquée après trop d'essaisNe 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 passeAncienne configurationNe 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éeNe plus utiliser WinSCP : publier-site.bat (scp)
No such file pour une commande LinuxCommande serveur tapée sur le PCPS C:\…> = le PC ; NOM@…$ = le serveur
Des « y » s'écrivent sans finyes tapé sur la ligne du serveurFaire Ctrl + C
Un test de ports montre tout « ouvert » depuis le PCLe VPN répond à tous les portsVérifier depuis le serveur (sudo ss -tlnp)
Le site est en erreur 502 sur cloudLe 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 AsieMauvais data center à la commandeDemander le changement à l'hébergeur avant de mettre des données dessus
Le paiement est refuséMoyen de paiement ou coordonnées de l'entrepriseVérifier les deux
Le pare-feu bloque tout après la réinstallationLe pare-feu de l'hébergeur se coupe après une réinstallationLe 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.