À quoi sert l'accès SSH ?

SSH (Secure Shell) est une façon sécurisée de se connecter à votre site depuis votre ordinateur, en passant par des commandes textuelles plutôt que par une interface graphique.

Concrètement, c'est comme avoir une télécommande directe pour votre site : au lieu de cliquer dans WordPress ou de transférer des fichiers un par un en SFTP, vous tapez une commande et le serveur l'exécute immédiatement.

L'accès SSH est particulièrement utile si vous souhaitez :

• Optimiser ou retravailler des centaines de fichiers en une seule commande
• Lancer des outils en ligne de commande comme WP-CLI pour piloter WordPress (search-replace, gestion en masse des extensions, etc.)
• Déboguer un site quand l'administration WordPress n'est plus accessible
• Automatiser des tâches via des scripts

C'est une fonctionnalité avancée, principalement utilisée par les développeurs et les intégrateurs.

Si vous avez l'habitude de gérer votre site uniquement depuis WordPress, vous n'aurez probablement pas besoin du SSH : dans beaucoup de situations, ce n'est pas un indispensable 🙂

Avant de commencer : ce dont vous avez besoin

Pour utiliser le SSH, il vous faut :

1. Un client SSH sur votre ordinateur (un programme qui permet de se connecter)
2. Une clé SSH (l'équivalent d'une serrure et d'une clé : la serrure est posée sur le serveur Copilhost, la clé reste sur votre ordinateur)

Bonne nouvelle : votre ordinateur intègre déjà le client SSH dont vous avez besoin, vous n'avez rien à installer.

Sur Mac, ouvrez l'application Terminal : vous la trouverez dans Applications > Utilitaires, ou en tapant "Terminal" dans la recherche Spotlight (raccourci Cmd + Espace).

Sur Windows (10 ou 11), ouvrez l'application Terminal Windows ou PowerShell : tapez "PowerShell" dans la barre de recherche Windows et cliquez sur l'application.

Si vous préférez une interface graphique, Termius est une bonne alternative gratuite.

Étape 1 : Générer votre clé SSH

👉 Si vous avez déjà une clé SSH sur votre ordinateur, vous pouvez passer directement à l'étape 2.

⚠️ À savoir avant de commencer

Le terminal fonctionne différemment d'une interface classique : il faut taper (ou coller) les commandes une par une, en appuyant sur Entrée après chacune et en attendant la réponse du terminal avant de passer à la suivante. Si vous collez plusieurs commandes d'un coup, ça ne fonctionnera pas comme prévu.

Première commande dans le terminal

Dans votre terminal, tapez ou copiez-collez la commande suivante (en remplaçant l'email par le vôtre), puis appuyez sur Entrée :

ssh-keygen -t ed25519 -C "votre-email@exemple.com"

💡 Que veut dire cette commande ?

ssh-keygen est l'outil qui génère la clé.

-t ed25519 indique le type de clé à créer (Ed25519, le format moderne recommandé).

-C "votre-email" ajoute simplement votre email comme libellé pour identifier la clé plus tard.

Attention, n'oubliez pas les guillemets !

Le terminal vous proposera un emplacement par défaut pour enregistrer la clé : appuyez simplement sur Entrée pour valider.

Les questions posées par le terminal

Une fois la commande lancée, le terminal va vous poser trois questions à la suite. Voici ce qu'elles veulent dire et comment y répondre :

Enter file in which to save the key → le terminal vous demande où enregistrer la clé. Appuyez juste sur Entrée pour accepter l'emplacement par défaut (c'est très bien).

Enter passphrase (empty for no passphrase) → le terminal vous propose de protéger votre clé avec un mot de passe supplémentaire. C'est facultatif. Appuyez sur Entrée pour ne pas en mettre, ou tapez un mot de passe si vous préférez plus de sécurité (vous devrez le retaper à chaque connexion).

Enter same passphrase again → confirmation du mot de passe précédent. Appuyez sur Entrée (ou retapez le même mot de passe si vous en avez choisi un).

ℹ️ Si une clé existe déjà : si vous aviez déjà tenté de générer une clé auparavant, le terminal vous demandera Overwrite (y/n)? (« écraser ? »). Tapez y puis Entrée pour générer une nouvelle clé propre.

Ce que vous devez voir à la fin

Quand votre clé est correctement créée, vous verrez s'afficher :

• Un message du type Your identification has been saved in... et Your public key has been saved in...
• Un curieux dessin en ASCII (avec des *, des o, des +...) appelé randomart. Pas de panique, c'est tout à fait normal : c'est juste une signature visuelle unique de votre clé, sans aucune importance pratique 🎨

Votre clé est maintenant créée. Deux fichiers ont été générés sur votre ordinateur :

• id_ed25519 → votre clé privée (à garder secrète, ne la partagez jamais !)
• id_ed25519.pub → votre clé publique (le .pub à la fin signifie "public", c'est celle-ci que vous allez ajouter à Copilhost)

💡 id_ed25519 est juste le nom de fichier par défaut, le même pour tout le monde qui génère une clé de ce type. Ce qui rend votre clé unique, c'est le contenu du fichier, pas son nom. Un peu comme si tout le monde avait un fichier passeport.pdf sur son ordinateur : le nom est commun, mais le contenu est propre à chacun.

Récupérer le contenu de votre clé publique

Pour pouvoir la coller dans Copilhost à l'étape suivante, il faut afficher le contenu de votre clé publique. Deux méthodes au choix selon ce qui vous semble plus simple :

Méthode A : depuis le terminal

Tapez la commande suivante (la commande cat permet d'afficher le contenu d'un fichier dans le terminal) :

cat ~/.ssh/id_ed25519.pub

Une longue suite de caractères va s'afficher, qui commence par ssh-ed25519 et se termine par votre adresse email.

⚠️ Sur Windows : pour copier le texte affiché dans PowerShell, sélectionnez-le avec votre souris puis faites un clic droit (le raccourci Ctrl + C est utilisé pour annuler une commande en cours, pas pour copier).

Méthode B : en ouvrant le fichier directement

Si vous préférez, vous pouvez aussi retrouver la clé publique directement depuis votre explorateur de fichiers :

• Sur Windows : ouvrez l'Explorateur de fichiers et rendez-vous dans C:\Users\votre-nom\.ssh. Faites clic droit sur id_ed25519.pub > Ouvrir avec > Bloc-notes.
• Sur Mac : ouvrez le Finder, faites Cmd + Maj + G, tapez ~/.ssh et appuyez sur Entrée. Faites clic droit sur id_ed25519.pub > Ouvrir avec > TextEdit.

⚠️ Le dossier .ssh est caché par défaut. Si vous ne le voyez pas dans votre explorateur, activez l'affichage des éléments masqués : sur Windows via le menu "Affichage" > cocher "Éléments masqués" ; sur Mac avec le raccourci Cmd + Maj + . (point) dans le Finder.

Sélectionnez tout le contenu du fichier et copiez-le. C'est cette clé publique que vous allez coller dans Copilhost à l'étape suivante.

🔐 Pas d'inquiétude au moment de la copier : votre clé publique peut être communiquée librement (à Copilhost, à un prestataire, par email...). Elle est faite pour être partagée. Ce qui doit absolument rester secret, c'est votre clé privée (le fichier id_ed25519 sans le .pub), qui reste discrètement sur votre ordinateur.

Étape 2 : Ajouter votre clé SSH dans Copilhost

Rendez-vous dans le Copanel, sélectionnez votre site, puis cliquez sur l'onglet "Avancé" et descendez jusqu'à la partie "Clés SSH".

Cliquez sur "Ajouter une clé SSH", puis collez votre clé publique dans le champ prévu.

Donnez-lui un nom qui vous permettra de l'identifier facilement (par exemple : "Mon Mac perso" ou "Ordinateur du bureau").

Cliquez sur "Créer" pour enregistrer ✅

Étape 3 : Récupérer vos informations de connexion

Toujours dans l'onglet "Avancé" > "Clés SSH", vous trouverez vos informations de connexion :

💡 À quoi correspondent les éléments de la commande ?

• site-XXX est un identifiant unique propre à votre site (exemple : site-1op)
• ssh.eu2.copilhost.cloud est l'adresse du serveur SSH de Copilhost
• -p 2222 indique le port à utiliser (Copilhost utilise le port 2222, pas le port SSH par défaut)

Étape 4 : Se connecter à votre site

Ouvrez votre Terminal et tapez la commande suivante (en remplaçant site-XXX par votre nom d'utilisateur) :

ssh site-XXX@ssh.copilhost.com -p 2222

Lors de votre première connexion, votre ordinateur vous demandera de confirmer la connexion.

Tapez yes puis appuyez sur Entrée.

Vous voilà connecté à votre site ! Vous pouvez désormais lancer toutes les commandes que vous souhaitez 🎉

Pour vous déconnecter, tapez simplement :

exit

Vous avez besoin d'aide ?

Si vous rencontrez une difficulté pour vous connecter ou si vous avez une question sur une commande spécifique, n'hésitez pas à nous écrire via le chat 🙂

Mis à jour le : 30/04/2026