| name | raspberry-pi-setup |
| description | Configuration et projets Raspberry Pi incluant OS, GPIO, serveurs et domotique. Se déclenche avec "Raspberry Pi", "RPi", "Raspbian", "GPIO", "domotique", "serveur Raspberry". Also triggers on "Raspberry Pi setup", "GPIO project", "home automation server". |
Raspberry Pi Setup
1. Choix du modèle
| Besoin | Modèle recommandé | Raison |
|---|
| Serveur, IA edge, desktop | Pi 5 (4/8 Go) | PCIe, NVMe, double 4K |
| Projet headless léger | Pi 4 (2 Go) | Bon rapport perf/prix |
| Caméra, capteurs simple | Pi Zero 2 W | Ultra compact, Wi-Fi |
| Microcontrôleur (pas Linux) | Pi Pico 2 | MicroPython, bare-metal |
| NAS/stockage | Pi 5 + HAT NVMe | Bande passante PCIe 2.0 |
Critère décisif : si le projet nécessite Docker, Python avec libs ML ou un serveur web → Pi 4/5. Si batterie/consommation prime → Zero 2 W ou Pico.
2. Installation OS
Choix OS :
- Raspberry Pi OS Lite 64-bit : headless, léger, recommandé pour serveurs/GPIO
- Ubuntu Server 24.04 LTS : si besoin snap, cloud-init, écosystème standard
- DietPi : footprint minimal (~500 Mo RAM), optimisé IoT
- Home Assistant OS : uniquement si dédiée domotique (ne pas mélanger)
3. Configuration réseau et SSH
ssh pi@monpi.local
ssh pi@192.168.x.x
sudo nmcli con mod "Wired connection 1" \
ipv4.addresses 192.168.1.100/24 \
ipv4.gateway 192.168.1.1 \
ipv4.dns "8.8.8.8 1.1.1.1" \
ipv4.method manual
sudo nmcli con up "Wired connection 1"
4. Sécurisation (obligatoire avant exposition réseau)
sudo adduser khalil
sudo usermod -aG sudo khalil
sudo sed -i 's/^#PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config
sudo sed -i 's/^#PermitRootLogin.*/PermitRootLogin no/' /etc/ssh/sshd_config
sudo systemctl restart ssh
sudo apt install -y ufw
sudo ufw default deny incoming
sudo ufw allow ssh
sudo ufw allow 80/tcp
sudo ufw enable
sudo apt install -y fail2ban
sudo systemctl enable --now fail2ban
sudo apt install -y unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades
5. GPIO — commandes et bibliothèques
sudo apt install -y python3-lgpio python3-gpiozero
sudo raspi-config nonint do_i2c 0
sudo raspi-config nonint do_spi 0
i2cdetect -y 1
from gpiozero import LED
from time import sleep
led = LED(17)
while True:
led.on(); sleep(0.5)
led.off(); sleep(0.5)
from gpiozero import Button
btn = Button(18, pull_up=True)
btn.when_pressed = lambda: print("Appui détecté")
import board, adafruit_dht
dht = adafruit_dht.DHT22(board.D4)
print(f"Temp: {dht.temperature}°C Hum: {dht.humidity}%")
6. Services système avec systemd
[Unit]
Description=Mon application Pi
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=khalil
WorkingDirectory=/home/khalil/monapp
ExecStart=/usr/bin/python3 main.py
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now monapp
journalctl -u monapp -f
7. Sauvegarde carte SD
ssh pi@monpi.local "sudo dd if=/dev/mmcblk0 bs=4M status=progress" \
| gzip > backup-$(date +%Y%m%d).img.gz
git clone https://github.com/billw2/rpi-clone.git
sudo rpi-clone sda
0 3 * * 0 root rpi-clone -f sda >> /var/log/rpi-clone.log 2>&1
8. Cas d'usage courants — commandes clés
curl -sSL https://install.pi-hole.net | bash
curl -Lo haos_rpi4.img.xz https://github.com/home-assistant/operating-system/releases/...
bash <(curl -sL https://raw.githubusercontent.com/node-red/linux-installers/master/deb/update-nodejs-and-nodered)
sudo systemctl enable --now nodered
sudo apt install -y htop glances
glances --webserver --port 61208
vcgencmd measure_temp
cat /sys/class/thermal/thermal_zone0/temp
Garde-fous / Anti-patterns / Pièges
- Sous-tension : le Pi 5 exige 5V/5A (27W). Un chargeur USB standard provoque des throttlings silencieux. Vérifier
vcgencmd get_throttled — 0x0 = OK.
- Carte SD bon marché : les cartes SD A1/A2 de faible qualité se corrompent sous écriture intensive (logs, bases de données). Utiliser SSD USB ou NVMe via HAT pour tout projet critique.
- Ne pas couper l'alimentation brutalement : toujours
sudo shutdown -h now. Mettre en place un onduleur ou un bouton GPIO avec script systemd pour Pi headless.
- GPIO 3.3V uniquement : les GPIOs Pi tolèrent max 3.3V. Un signal 5V (Arduino, capteur non adapté) détruit le SoC. Utiliser un level shifter.
- Ne pas utiliser RPi.GPIO sur Pi 5 : RPi.GPIO ne supporte pas le Pi 5 (RP1 chip). Utiliser
lgpio ou gpiozero avec backend lgpio.
- Overlocking sans refroidissement : le Pi 5 peut dépasser 85°C sans dissipateur. Activer
arm_freq=2400 uniquement avec refroidissement actif.
- Ne pas exposer SSH sur IP publique sans fail2ban + clés. Préférer un VPN WireGuard ou Tailscale.
- Raspberry Pi Imager efface : vérifier deux fois le device cible — une erreur formate le mauvais disque.
Bonnes pratiques 2026
- Utiliser NVMe HAT (Pi 5) plutôt que carte SD pour tout projet en production.
- Préférer gpiozero + backend
lgpio à RPi.GPIO (déprécié sur Pi 5+).
- Tailscale pour accès distant sécurisé sans ouvrir de ports :
curl -fsSL https://tailscale.com/install.sh | sh.
- Logger vers journald (systemd), pas vers fichiers texte, pour rotation automatique.
- Versionner scripts et configs dans git ; utiliser Ansible dès qu'on gère plusieurs Pi.
- Monitorer température et voltage avec Glances ou Netdata dès la mise en production.
