# Se connecter en SSH

SSH (Secure Shell) permet d'accéder directement au terminal de votre serveur pour exécuter des commandes, gérer des fichiers ou lancer des scripts. C'est l'outil de prédilection des développeurs pour les opérations avancées.

![Onglet Configuration - Section SSH/SFTP](https://3571417815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZZZbh9symRKJgO883eKl%2Fuploads%2Fgit-blob-28b4071d35c0192ac6ded87c5325247d47155900%2FE-01-configuration.png?alt=media)

***

## Prérequis

Avant de pouvoir vous connecter en SSH, vous devez :

1. **Disposer d'une paire de clés SSH** (clé publique + clé privée).
2. **Avoir enregistré votre clé publique** dans votre profil Faaaster.

> **Pas encore de clé SSH ?** Consultez le tutoriel "Générer une paire SSH" dans la section Profil et accès techniques.

***

## Étape 1 — Ajouter sa clé SSH au profil

1. Cliquez sur votre **avatar** en haut à droite.
2. Accédez à votre **Profil**.
3. Dans la section **Clés SSH**, collez votre clé publique (contenu du fichier `~/.ssh/id_ed25519.pub` ou `~/.ssh/id_rsa.pub`).
4. Enregistrez.

***

## Étape 2 — Récupérer les identifiants SSH du site

1. Depuis le tableau de bord de votre site, cliquez sur l'onglet **configuration**.
2. Dans la section **SSH / SFTP**, notez les informations suivantes :
   * **Hôte** (ex : `ssh.faaaster.io`)
   * **Port** (ex : `22` ou un port non standard)
   * **Utilisateur**

***

## Étape 3 — Se connecter

Ouvrez un terminal et tapez :

```bash
ssh utilisateur@hote -p port
```

Exemple :

```bash
ssh mon-site@ssh.faaaster.io -p 2222
```

Si votre clé privée n'est pas dans le chemin par défaut, précisez-la explicitement :

```bash
ssh -i ~/.ssh/ma-cle-privee utilisateur@hote -p port
```

***

## Commandes utiles

Une fois connecté, vous êtes positionné à la racine de votre site WordPress. Voici quelques commandes courantes :

```bash
# Lister les fichiers
ls -la

# Naviguer dans les dossiers
cd wp-content/plugins

# Voir les logs d'erreur
tail -f /var/log/nginx/error.log

# Exécuter WP-CLI
wp plugin list
wp core update
```

> **Bon à savoir** : [WP-CLI](https://wp-cli.org/) est préinstallé sur tous les sites Faaaster. C'est un outil en ligne de commande très puissant pour gérer WordPress sans interface graphique.

***

## Erreurs fréquentes

| Erreur                          | Cause probable                              | Solution                                              |
| ------------------------------- | ------------------------------------------- | ----------------------------------------------------- |
| `Permission denied (publickey)` | Clé publique non enregistrée dans le profil | Ajouter la clé depuis le profil Faaaster              |
| `Connection refused`            | Port ou hôte incorrect                      | Vérifier les identifiants dans l'onglet configuration |
| `Host key verification failed`  | Première connexion ou hôte changé           | Taper `yes` pour valider l'empreinte du serveur       |

***

## En résumé

| Étape | Action                                                              |
| ----- | ------------------------------------------------------------------- |
| 1     | Ajouter la clé publique dans le profil Faaaster                     |
| 2     | Récupérer hôte, port et utilisateur dans l'onglet **configuration** |
| 3     | Se connecter avec `ssh utilisateur@hote -p port`                    |