Terminal SSH - Guide d'utilisation

Documentation

  • webo-facto
  • Hébergement
SSH

Terminal SSH

Guide d'utilisation

 

À quoi sert le Terminal SSH ?

Le Terminal SSH est un terminal en ligne de commande accessible directement depuis votre navigateur, sans installation ni logiciel tiers (pas besoin de PuTTY, FileZilla ou d'un client SSH classique). Il vous permet d'exécuter des commandes directement sur votre projet : gérer des fichiers, lancer des scripts, installer des dépendances, déboguer une application, etc.

1. Accéder à l'onglet SSH

Le Terminal SSH se trouve directement sur la fiche du projet concerné, dans un onglet dédié nommé SSH.

  1. Ouvrez la fiche du projet souhaité.
  2. Cliquez sur l'onglet SSH.

Fiche projet ouverte, avec la liste des onglets visible et l'onglet « SSH » mis en évidence (avant de cliquer dessus).

Si l'onglet SSH n'apparaît pas

L'onglet SSH n'est visible que si :

  • le projet est hébergé sur un serveur dédié (non mutualisé) ;
  • votre espace de travail a activé la fonctionnalité SSH.

Si un message « Droit requis » s'affiche

Si vous obtenez le message suivant en ouvrant l'onglet :

« Droit requis — Demandez à votre administrateur de configurer ce droit dans la section Groupes et Droits (menu Accès) : éditer votre groupe, section Projets, puis cocher « Accéder à l'onglet SSH ». »

cela signifie que votre compte utilisateur n'a pas encore l'autorisation d'utiliser le terminal. Contactez l'administrateur de votre espace de travail pour qu'il active le droit « Accéder à l'onglet SSH » dans Accès > Groupes et Droits, section Projets.


Écran affiché par l'onglet SSH pour un utilisateur qui n'a pas le droit (message « Droit requis »).


Écran Accès > Groupes et Droits, édition d'un groupe, section « Projets », avec la case « Accéder à l'onglet SSH » visible (cochée ou non).

2. Première utilisation : accepter les conditions d'utilisation

Lors de la toute première ouverture du terminal SSH (par utilisateur, une seule fois), un écran de conditions d'utilisation s'affiche avant de pouvoir continuer. Trois cases doivent être cochées :

  1. Vous êtes seul responsable des commandes exécutées et disposez d'une formation adéquate — webo-facto ne fournit pas d'assistance sur l'usage des commandes du terminal.
  2. Tout usage jugé illégitime par webo-facto peut entraîner une suspension du service, temporaire ou définitive, sans préavis.
  3. Le terminal donne accès uniquement à une sandbox de votre projet, pas au serveur d'hébergement.

Le bouton « J'accepte les conditions d'utilisation » reste grisé tant que les trois cases ne sont pas cochées.


Écran des conditions d'utilisation avec les 3 cases à cocher visibles, et le bouton « J'accepte les conditions d'utilisation » (à l'état grisé, cases non cochées).


Même écran, les 3 cases cochées et le bouton devient actif/cliquable.

3. Initialiser le compte SSH (une seule fois par projet)

Après acceptation des conditions, si aucun compte SSH n'a encore été créé pour ce projet, un écran vous invite à l'initialiser.

  1. Cliquez sur « Initialiser le compte SSH ».
  2. Un indicateur de progression s'affiche pendant la création du compte (génération des accès, préparation de l'environnement). Cette étape peut prendre quelques instants — la page se met à jour automatiquement, aucune action de votre part n'est nécessaire.
  3. Une fois prêt, un message de confirmation apparaît : « Compte SSH prêt. Vous pouvez vous connecter. »


Écran « Compte SSH non initialisé » avec le bouton « Initialiser le compte SSH ».


Écran avec l'indicateur de chargement / libellé « Installation du compte SSH en cours ».


Écran juste après la fin de l'installation, avec le message de confirmation (toast) « Compte SSH prêt. Vous pouvez vous connecter. » et l'écran de connexion disponible.

4. Se connecter au terminal

Une fois le compte SSH prêt :

  1. Cliquez sur « Se connecter ».
  2. Le terminal s'ouvre directement dans la page.


Écran « Connexion SSH » avec le bouton « Se connecter » (compte déjà initialisé).


Terminal ouvert et connecté pour montrer un résultat à l'écran.

En cas d'échec de connexion

Si la connexion échoue, plusieurs nouvelles tentatives sont effectuées automatiquement. Si elle échoue malgré tout, le message suivant s'affiche :

« Une erreur est survenue lors de la connexion SSH. Veuillez réessayer. »

Dans ce cas, patientez quelques instants puis réessayez. Si le problème persiste, contactez le support.

5. Utiliser le terminal

Une fois connecté, une barre d'actions est disponible en haut du terminal :

  • Se déconnecter — ferme la session en cours.
  • Plein écran — bascule le terminal en mode plein écran pour plus de confort (un bouton « Quitter le plein écran » permet d'en sortir).
  • A- / A+ — réduit ou agrandit la taille du texte affiché dans le terminal.
  • Copier / coller — utilisable via le clic droit ou les raccourcis clavier habituels (Ctrl+C / Ctrl+V).


Gros plan sur la barre d'actions en haut du terminal (boutons Se déconnecter, Plein écran, A-, A+).


Terminal affiché en mode plein écran, avec le bouton « Quitter le plein écran » visible.

6. Se déconnecter

Cliquez sur « Se déconnecter » dans la barre d'actions pour fermer proprement la session. Un message de confirmation s'affiche : « Déconnexion effectuée avec succès. »


Message de confirmation après clic sur « Se déconnecter », retour à l'écran de connexion.

ℹ️ Il n'y a pas de fenêtre de confirmation avant la déconnexion : le clic ferme immédiatement la session.

Exemples d’utilisation

Connexion à la base de données

Il est possible d’utiliser l’outil ligne de commande pour se connecter à la base de données. Une fois connecté vous utiliser une environnement interactif appelé mysql.
Vous devez maitriser l’outil mysql avant de vous connecter.

  1. connexion à la base de données :
mysql -u nom_d_utilisateur_bdd -p

Le nom_d_utilisateur_bdd est à copier dans l’onglet Hébèrgement & Accès. Il s’agit du nom d’utilisateur de la base de données. Le mot de passe de l’utilisateur de la base sera demandé. à copier également dans l’onglet Hébèrgement & Accès.

Pour quitter l’outil interactif mysql et revenir à la ligne de commande, utiliser l’instruction suivante :

MariaDB [(none)] > quit
Bye

La gestion des versions php

Par défaut la version est PHP 8.4.

Plusieurs versions PHP sont disponibles au sein de l’accès SSH Webo-facto allant de la version PHP 5.6 à la version PHP 8.4.

Pour voir la version actuellement utilisée il faut utiliser la commande php -v.
Pour changer la version actuellement utilisée dans le shell, il faut utiliser la commande php-switch.

  1. Exemple d’affichage de la version de PHP utilisée.
php -v

PHP 8.4.23 (cli) (built: Jul  3 2026 10:04:34) (NTS)
Copyright (c) The PHP Group
Built by Debian
Zend Engine v4.4.23, Copyright (c) Zend Technologies
    with Zend OPcache v8.4.23, Copyright (c), by Zend Technologies
  1. Exemple de changement de version vers PHP 7.4 puis vers PHP 5.6
php-switch 7.4

update-alternatives: using /usr/bin/php7.4 to provide /usr/bin/php (php) in manual mode
update-alternatives: warning: skip creation of /usr/share/man/man1/php.1.gz because associated file /usr/share/man/man1/php7.4.1.gz (of link group php) doesn't exist

php -v

PHP 7.4.33 (cli) (built: Jul  3 2026 10:36:02) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.33, Copyright (c), by Zend Technologies

php-switch 5.6

update-alternatives: using /usr/bin/php5.6 to provide /usr/bin/php (php) in manual mode
update-alternatives: warning: skip creation of /usr/share/man/man1/php.1.gz because associated file /usr/share/man/man1/php5.6.1.gz (of link group php) doesn't exist

php -v

PHP 5.6.40-103+0~20260703.133+debian12~1.gbpfcb859 (cli) 
Copyright (c) 1997-2016 The PHP Group
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies
    with Zend OPcache v7.0.6-dev, Copyright (c) 1999-2016, by Zend Technologies

Définir des commandes personnalisées

Des utilitaires comme wp-cli, composer et autres outils indépendants peuvent être installés dans le dossier binary de la session ssh afin de bénéficier de la commande à tout moment.

Il faut attribué un droit d’exécution pour les utilitaires installés.
Dans l’exemple suivant nous allons créer une commande wp qui permettra d’utiliser l’utilitaire wp-cli :

  1. Se positionner sur le dossier binary
cd binary/
  1. Téléchargement du binaire si ce n’est pas déjà fait et positionner l’executable dans le dossier.
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
  1. Ajout du droit d’exécution
chmod +x wp-cli.phar
  1. Pour avoir la commande wp, modifier wp-cli.phar à wp
mv wp-cli.phar wp

L’emplacement des logs apache pour différents domaines associés au projet

Les logs apache se trouve dans le dossier logApache (qui se trouve dans le dossier utilisateur) classé par nom de domaine.

Enregistrement des commandes (historique des commandes utilisateurs)

Un dossier logs se trouve également dans le dossier utilisateur. Dans ce dossier, on trouve un fichier en lecture seul pour l’utilisateur qui répertorie tous ses commandes lancés dans la console ssh.

Foire aux questions (FAQ)

Dois-je fournir un mot de passe ou une clé SSH ?
Non. La connexion est entièrement gérée automatiquement par webo-facto, aucune information technique n'est demandée.

Dois-je réinitialiser le compte SSH à chaque connexion ?
Non, l'initialisation (étape 3) ne se fait qu'une seule fois par projet. Ensuite, il suffit de cliquer sur « Se connecter ».

Dois-je réaccepter les conditions d'utilisation à chaque fois ?
Non, l'acceptation est mémorisée par utilisateur, une seule fois.

Pourquoi je ne vois pas l'onglet SSH sur mon projet ?
Vérifiez que le projet est hébergé sur un serveur dédié (non mutualisé) et que la fonctionnalité SSH est activée pour votre espace de travail.

Article précédent Article suivant