Configurer le Wi-Fi sur Raspberry Pi sans se prendre la tête

Connecter un Raspberry Pi au Wi-Fi devrait prendre deux minutes. En pratique, ça prend parfois deux heures — parce qu’on cherche le bon fichier de configuration, parce que le réseau 5 GHz est invisible, ou parce qu’on tente de tout faire sans écran. Voilà un tour complet des méthodes qui fonctionnent vraiment, du plus simple au plus technique.

Que tu utilises un Pi 4, un Pi 5 ou un vieux Pi 3 B+, les principes restent les mêmes. Seuls les outils changent légèrement selon la version de Raspberry Pi OS installée.

Avant de commencer : ce qu’il faut vérifier

Les prérequis matériels

Les modèles Pi 3, Pi 4 et Pi 5 intègrent une puce Wi-Fi 802.11ac. Pas besoin de dongle USB. Le Pi Zero W et Zero 2 W aussi. En revanche, un Pi 2 ou un Pi 1 n’a pas de Wi-Fi natif — il faudra un adaptateur USB compatible.

Autre point souvent négligé : le Pi ne voit que les réseaux 2,4 GHz sur les modèles anciens. Le Pi 4 et le Pi 5 supportent le 5 GHz, mais certains routeurs masquent ce réseau ou l’appellent différemment. Si ton réseau n’apparaît pas dans la liste, commence par vérifier la bande fréquence.

Choisir la bonne méthode selon ta situation

Trois situations courantes :

• Tu as un écran et un bureau graphique → méthode clics, la plus rapide.
• Tu travailles en ligne de commande (SSH ou terminal) → raspi-config ou nmcli.
• Tu veux configurer le Wi-Fi avant même le premier démarrage → fichier wpa_supplicant.conf ou Raspberry Pi Imager.

Configuration Wi-Fi via l’interface graphique

Sur Raspberry Pi OS avec bureau, clique sur l’icône réseau en haut à droite de la barre des tâches. La liste des réseaux détectés s’affiche. Sélectionne ton réseau, saisis le mot de passe, valide. C’est réglé.

Si l’icône réseau est absente ou grisée, le service dhcpcd ou NetworkManager n’est pas actif. Lance un terminal et tape :

sudo systemctl enable –now NetworkManager

Depuis Raspberry Pi OS Bookworm (sorti fin 2023), NetworkManager remplace dhcpcd par défaut. Si tu es sur une version antérieure, les commandes différent légèrement — garde ça en tête.

Configuration en ligne de commande

Avec raspi-config (méthode rapide)

Ouvre un terminal et lance :

sudo raspi-config

Va dans System Options → Wireless LAN. L’outil te demande le SSID (nom du réseau), puis le mot de passe. Il écrit les bonnes lignes dans le bon fichier automatiquement. Redémarre, c’est connecté.

C’est la méthode que je recommande en premier quand on n’a pas d’interface graphique. Simple, sans risque d’erreur de syntaxe.

Avec nmcli pour aller plus loin

nmcli est l’outil en ligne de commande de NetworkManager. Plus puissant, utile pour gérer plusieurs réseaux ou automatiser des scripts.

Commandes de base :

1. Lister les réseaux disponibles : nmcli device wifi list
2. Se connecter : nmcli device wifi connect « NomDuReseau » password « MotDePasse »
3. Vérifier l’état : nmcli connection show

Si tu obtiens une erreur Error: No Wi-Fi device found, vérifie que l’interface wlan0 existe avec ip link show. Un pilote manquant ou un module désactivé peut bloquer la détection.

Configurer le Wi-Fi avant le premier démarrage

C’est le cas le plus fréquent pour un usage sans tête (headless) : on veut que le Pi se connecte automatiquement dès qu’il démarre, sans avoir branché clavier ni écran.

Deux approches :

• Raspberry Pi Imager : lors de la gravure de la carte SD, clique sur l’icône paramètres (roue dentée). Tu saisis directement le SSID, le mot de passe, le pays Wi-Fi (FR pour la France). L’Imager configure tout avant même que la carte soit insérée dans le Pi. C’est de loin la méthode la plus fiable en 2024.
• Fichier wpa_supplicant.conf : méthode héritée, toujours fonctionnelle sur les anciennes versions de l’OS. Crée un fichier wpa_supplicant.conf à la racine de la partition boot avec ce contenu :

country=FR
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
  ssid= »NomDuReseau »
  psk= »MotDePasse »
  key_mgmt=WPA-PSK
}

Au premier démarrage, le système copie ce fichier au bon endroit et supprime l’original. Note que sur Raspberry Pi OS Bookworm, cette méthode ne fonctionne plus — il faut passer par l’Imager ou par nmcli une fois connecté via câble Ethernet.

Résoudre les problèmes courants

Le Pi ne se connecte pas ? Voici les causes les plus fréquentes, dans l’ordre de probabilité :

• Mauvais code pays : sans country=FR dans la configuration, certaines fréquences sont bloquées par la réglementation. C’est souvent la cause n°1 sur les nouvelles installations.
• Erreur de mot de passe ou de SSID : un espace en trop, une majuscule manquante. La casse est respectée à la lettre.
• Réseau 5 GHz non supporté : le Pi 3 B+ ne voit pas le 5 GHz sur tous les canaux. Force le routeur sur le canal 36 ou bascule en 2,4 GHz.
• Adresse IP non attribuée : vérifie avec ip addr show wlan0. Si tu vois 169.254.x.x, le serveur DHCP n’a pas répondu. Redémarre le routeur ou assigne une IP statique.
• Interface Wi-Fi bloquée (rfkill) : tape rfkill list. Si wlan est marqué blocked, débloque avec rfkill unblock wifi.

Un diagnostic rapide passe par journalctl -u NetworkManager –since « 5 minutes ago » — les logs sont souvent explicites sur la cause réelle du problème.

Questions fréquentes