Local WP bloqué : redémarrer un site WordPress local proprement

Local, anciennement Local by Flywheel, reste l’un des outils les plus pratiques pour lancer un site WordPress sur son ordinateur. En quelques clics, on obtient un WordPress local avec PHP, base de données, serveur web, SSL local et accès WP-CLI.

Mais parfois, Local reste bloqué. Le site ne démarre plus. L’interface affiche Starting site services. Le navigateur renvoie une erreur 502. Le domaine local ne répond plus. Ou l’application semble tourner, mais le site reste mort comme un plugin abandonné depuis 2014.

Avant, la solution consistait souvent à redémarrer la machine virtuelle local-by-flywheel dans VirtualBox. Aujourd’hui, cette méthode concerne surtout les anciennes installations. Sur Local WP moderne, il faut plutôt redémarrer le site, l’application, les services réseau et vérifier les logs.

Pourquoi l’ancien article parlait de VirtualBox ?

Les anciennes versions de Local by Flywheel utilisaient une machine virtuelle gérée par VirtualBox. Quand la VM local-by-flywheel se bloquait, fermer puis rouvrir Local ne suffisait pas toujours. Il fallait ouvrir VirtualBox et redémarrer la VM à la main.

La procédure historique ressemblait à ceci :

1. Ouvrir VirtualBox.
2. Repérer la machine virtuelle local-by-flywheel.
3. Faire un clic droit dessus.
4. Choisir Fermer, puis Redémarrage ACPI.
5. Attendre l’arrêt complet.
6. Fermer VirtualBox.
7. Relancer Local.

Cette astuce reste utile si vous maintenez une vieille version de Local by Flywheel. Cependant, sur une installation récente, vous ne verrez probablement plus cette VM dans VirtualBox. Dans ce cas, ne perdez pas votre temps à chercher un fantôme.

Local by Flywheel ou Local WP : vérifiez votre version

Commencez par identifier votre cas.

Votre situation	Diagnostic probable	Action
Vous voyez local-by-flywheel dans VirtualBox	Ancienne architecture Local	La procédure VirtualBox peut encore aider
Vous utilisez une version récente de Local	Architecture Local moderne	Redémarrer site, app, router et services
Le site bloque sur Starting site services	Service PHP, MySQL, nginx/Apache ou router bloqué	Redémarrage progressif + logs
Erreur “Local’s router is having trouble starting”	Conflit de port, pare-feu ou Router Mode	Changer Router Mode et vérifier ports 80/443
Erreur 502	PHP ou service web non démarré	Redémarrer le site et lire les logs

Le réflexe moderne : ne cherchez pas d’abord une VM. Cherchez d’abord le service qui coince.

Étape 1 : redémarrer seulement le site dans Local

Commencez par le redémarrage le moins brutal. Dans Local, chaque site possède ses propres services. Il n’est donc pas nécessaire de tuer toute l’application si un seul site bloque.

1. Ouvrez Local.
2. Sélectionnez le site concerné.
3. Cliquez sur Stop site.
4. Attendez que l’état du site passe à l’arrêt.
5. Cliquez sur Start site.
6. Ouvrez le site dans le navigateur.

Si le site redémarre, le problème venait probablement d’un service temporairement bloqué. C’est le cas le plus simple, donc savourons-le trois secondes avant de retourner au vrai monde.

Étape 2 : utiliser “Restart site” si disponible

Selon votre version de Local, vous pouvez avoir une action de redémarrage du site. Local permet notamment d’ouvrir le shell du site, d’exporter le site, d’accéder au dossier local et de redémarrer le site.

Si le bouton existe :

1. Sélectionnez le site dans Local.
2. Ouvrez le menu contextuel ou les actions du site.
3. Choisissez Restart ou l’équivalent.
4. Attendez la relance des services.
5. Rechargez le site sans cache navigateur.

Ce redémarrage suffit souvent après une modification de configuration PHP, une extension WordPress qui bloque ou un cache local un peu collant.

Étape 3 : fermer complètement Local

Si le site reste bloqué, fermez complètement Local. Ne vous contentez pas de fermer la fenêtre si l’application continue de tourner en arrière-plan.

Sur macOS

1. Dans Local, arrêtez les sites actifs.
2. Dans la barre de menu, cliquez sur Local.
3. Choisissez Quit Local.
4. Vérifiez que l’icône Local n’est plus active.
5. Relancez Local.

Si Local ne répond plus, utilisez Forcer à quitter depuis macOS.

Sur Windows

1. Arrêtez les sites actifs dans Local.
2. Fermez Local depuis son menu.
3. Ouvrez le Gestionnaire des tâches.
4. Vérifiez qu’aucun processus Local ne reste bloqué.
5. Relancez Local en mode normal.

Si Local reste coincé, terminez les processus liés à Local depuis le Gestionnaire des tâches, puis relancez l’application.

Étape 4 : redémarrer l’ordinateur

C’est basique, mais efficace. Local peut laisser des services, ports ou processus dans un état incohérent. Un redémarrage complet de la machine remet souvent les compteurs à zéro.

Utilisez cette option si :

• Local ne se ferme pas correctement ;
• plusieurs sites restent bloqués ;
• le router ne démarre plus ;
• les ports semblent occupés ;
• le système sort de veille prolongée ;
• vous venez de changer de réseau, VPN ou pare-feu.

Sur les machines portables, beaucoup de problèmes Local apparaissent après veille, changement de Wi-Fi ou VPN. Le système croit que tout va bien. Local, lui, a manifestement perdu le plan de table.

Étape 5 : vérifier le Router Mode

Local utilise un router pour exposer vos sites locaux avec des domaines comme monsite.local, ou avec des ports. Si le router ne démarre pas, les sites peuvent être lancés côté services, mais rester inaccessibles dans le navigateur.

Dans Local :

1. Ouvrez Preferences.
2. Allez dans Advanced.
3. Trouvez Router Mode.
4. Testez Site Domains.
5. Si cela échoue, testez Localhost.
6. Redémarrez le site après changement.

Les discussions récentes du forum Local reviennent souvent sur ce point : en cas de site inaccessible ou de router bloqué, changer le Router Mode peut aider à isoler le problème.

Site Domains ou Localhost : que choisir ?

Mode	Avantage	Inconvénient
Site Domains	URLs propres comme site.local	Peut nécessiter ports 80/443 et modification du fichier hosts
Localhost	Moins sensible au fichier hosts	URLs avec ports, moins proches d’une prod réelle

Pour développer proprement, Site Domains est plus agréable. Pour dépanner vite, Localhost peut sauver la session. Ce n’est pas élégant, mais un site qui répond bat toujours une belle URL morte.

Étape 6 : vérifier les ports 80 et 443

Si Local utilise des domaines locaux, il doit pouvoir écouter sur les ports web standards. Or, Apache, nginx, Docker Desktop, Laravel Valet, MAMP, XAMPP, Skype, certains VPN ou des outils de sécurité peuvent déjà occuper ces ports.

Sur macOS ou Linux, vérifiez les ports avec :

sudo lsof -i :80
sudo lsof -i :443Code language: CSS (css)

Sur Windows PowerShell :

Get-NetTCPConnection -LocalPort 80,443 -ErrorAction SilentlyContinue

Si un autre service occupe le port 80 ou 443, arrêtez-le temporairement ou passez Local en mode Localhost. Dans un cas cité par la communauté, un serveur Apache déjà lancé pouvait empêcher le router de Local de démarrer correctement.

Étape 7 : vérifier le fichier hosts

En mode Site Domains, Local doit écrire des entrées dans le fichier hosts. Si le système, l’antivirus ou les permissions bloquent cette écriture, le domaine local peut ne pas résoudre.

Emplacements du fichier :

Système	Fichier hosts
macOS	/etc/hosts
Linux	/etc/hosts
Windows	C:\Windows\System32\drivers\etc\hosts

Pour tester la résolution d’un domaine local :

ping monsite.localCode language: CSS (css)

Si le domaine ne pointe pas vers l’adresse attendue, repassez dans Local, arrêtez le site, changez le Router Mode ou relancez Local avec les droits nécessaires. Sur Windows, les erreurs de type EPERM autour du fichier hosts apparaissent régulièrement dans les discussions Local.

Étape 8 : consulter les logs Local

Si le problème persiste, arrêtez de deviner et ouvrez les logs. Local propose un onglet Support avec une action pour télécharger les logs. Les modérateurs Local demandent régulièrement ce fichier pour diagnostiquer les sites qui ne démarrent pas.

1. Ouvrez Local.
2. Allez dans Support.
3. Cliquez sur Download Local Logs.
4. Décompressez l’archive si nécessaire.
5. Cherchez les erreurs liées au site, au router, à PHP, nginx/Apache ou MySQL.

Regardez surtout les mentions :

• router ;
• port ;
• hosts ;
• nginx ;
• apache ;
• php ;
• mysql ;
• mariadb ;
• permission ;
• EPERM ;
• EADDRINUSE.

Petit rappel utile : relisez les logs avant de les publier sur un forum. Local essaie de masquer les informations sensibles, mais il vaut mieux vérifier qu’aucun chemin privé, token, email ou mot de passe ne traîne dans les captures et fichiers partagés. La communauté Local rappelle aussi cette prudence.

Étape 9 : ouvrir le shell du site

Quand le site démarre partiellement, ouvrez le shell Local. Cela permet d’utiliser WP-CLI, PHP, MySQL et les outils fournis par l’environnement du site.

1. Sélectionnez le site dans Local.
2. Cliquez sur Open Site Shell.
3. Vérifiez que WordPress répond avec WP-CLI.

wp core version
wp option get siteurl
wp option get homeCode language: JavaScript (javascript)

Si WP-CLI répond, WordPress est probablement intact. Le problème se situe plutôt côté router, serveur web, SSL ou navigateur.

Étape 10 : désactiver un plugin WordPress bloquant

Un site Local peut démarrer, mais planter à cause d’un plugin, d’un thème ou d’un mu-plugin. Depuis le shell du site, testez rapidement :

wp plugin list
wp theme listCode language: PHP (php)

Pour désactiver tous les plugins temporairement :

wp plugin deactivate --all

Pour revenir sur un thème par défaut :

wp theme activate twentytwentyfour

Si le site revient après désactivation des plugins, le problème ne venait pas de Local. Il venait de WordPress. C’est une bonne nouvelle, même si votre plugin préféré vient de vous trahir.

Étape 11 : vérifier la base de données locale

Un blocage peut venir du service MySQL/MariaDB local. Dans Local, ouvrez la base via l’outil proposé, ou utilisez le shell du site si l’environnement le permet.

Depuis WP-CLI :

wp db check
wp db tables

Pour réparer les tables si nécessaire :

wp db repair

Sur un site local, cette commande peut dépanner après une fermeture brutale. Cependant, exportez la base avant toute opération lourde si le site contient un travail important.

Étape 12 : exporter le site avant les grosses manipulations

Si le site contient du travail client, exportez-le avant de supprimer quoi que ce soit. Local documente l’import/export des sites et la restauration depuis les fichiers locaux.

Dans Local :

1. Clic droit sur le site.
2. Choisissez Export.
3. Enregistrez l’archive dans un dossier sûr.
4. Copiez aussi le dossier du site si Local ne parvient pas à exporter.

Une fois l’archive créée, vous pouvez tenter des réparations plus franches : changement de Router Mode, réinstallation Local, réimport du site, suppression de configuration cassée. Sans export, chaque clic devient un mini pari. Et les paris avec des sites clients, bof.

Ancienne méthode : redémarrer la VM dans VirtualBox

Cette section concerne uniquement les anciennes versions de Local by Flywheel qui utilisent encore VirtualBox. Si vous ne voyez aucune machine local-by-flywheel dans VirtualBox, passez cette section.

1. Fermez Local.
2. Ouvrez VirtualBox.
3. Repérez la machine virtuelle local-by-flywheel.
4. Faites un clic droit sur la VM.
5. Choisissez Fermer, puis Redémarrage ACPI.
6. Attendez l’arrêt complet de la machine.
7. Si rien ne bouge après quelques minutes, choisissez Fermer > Éteindre.
8. Fermez VirtualBox.
9. Relancez Local.

Le redémarrage ACPI est plus propre qu’un arrêt brutal. L’extinction forcée doit rester un dernier recours. Si vous devez le faire régulièrement, il vaut mieux migrer vers une version récente de Local ou exporter vos sites.

Si Local reste bloqué sur “Starting site services”

Le message Starting site services indique que Local tente de lancer les services nécessaires au site : serveur web, PHP, base de données et router. Des utilisateurs signalent encore ce blocage sur des versions récentes, notamment après changement d’OS, sécurité locale ou conflit de services.

Procédez dans cet ordre :

1. Arrêtez le site.
2. Quittez Local complètement.
3. Redémarrez l’ordinateur.
4. Relancez Local.
5. Changez le Router Mode.
6. Vérifiez ports 80 et 443.
7. Désactivez temporairement VPN, proxy ou pare-feu tiers pour tester.
8. Téléchargez les logs depuis l’onglet Support.
9. Exportez le site si possible.
10. Réinstallez Local seulement après sauvegarde/export.

Ne supprimez pas le dossier du site au hasard. Vos fichiers WordPress et votre base locale peuvent encore être récupérables même si Local ne démarre plus correctement.

Si Local affiche une erreur 502

Une erreur 502 indique souvent que le router ou le serveur web répond, mais que le service PHP ou le backend du site ne suit pas.

• Redémarrez le site.
• Changez de version PHP dans Local, puis revenez à la version souhaitée.
• Consultez les logs PHP.
• Désactivez les plugins via WP-CLI.
• Vérifiez qu’aucun fichier .user.ini ou php.ini.hbs cassé ne bloque PHP.
• Vérifiez les erreurs fatales WordPress.

Local documente aussi des réglages liés au fichier php.ini.hbs : il faut arrêter le site, modifier le fichier, puis redémarrer le site pour que Local prenne les nouveaux paramètres en compte.

Si SSL local ne fonctionne plus

Local peut générer et faire confiance à des certificats SSL locaux. Si le site fonctionne en HTTP mais pas en HTTPS, le problème n’est pas forcément le serveur WordPress.

• Vérifiez que le site démarre bien en HTTP.
• Dans Local, ouvrez l’onglet SSL du site.
• Relancez la confiance du certificat si disponible.
• Redémarrez le navigateur.
• Videz le cache HSTS si nécessaire.
• Testez dans un autre navigateur.

Pour un simple développement local, ne perdez pas deux heures sur HTTPS si votre tâche ne le nécessite pas. Mais pour WooCommerce, OAuth, cookies sécurisés ou callbacks, testez bien avec SSL local.

Si le navigateur garde une ancienne erreur

Parfois Local a redémarré correctement, mais le navigateur garde un cache, un HSTS ou une résolution DNS locale ancienne.

• Ouvrez le site en navigation privée.
• Testez un autre navigateur.
• Videz le cache DNS du système.
• Désactivez temporairement les extensions navigateur.
• Vérifiez que l’URL correspond au Router Mode actuel.

Sur macOS, vider le cache DNS :

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

Sur Windows :

ipconfig /flushdns

Quand mettre Local à jour ?

Si vous utilisez encore une ancienne version liée à VirtualBox/Docker Machine, prévoyez une migration. Local publie toujours des versions et tient un historique des releases. Les anciennes versions mentionnaient explicitement Docker, Boot2Docker et VirtualBox, ce qui montre bien l’évolution de l’architecture au fil du temps.

Avant mise à jour :

• exportez les sites importants ;
• copiez les dossiers locaux ;
• notez les versions PHP et base de données ;
• exportez les bases de données critiques ;
• gardez l’ancienne installation tant que les sites ne sont pas validés.

Une mise à jour peut corriger des bugs, mais ne faites pas ça cinq minutes avant une démo client. C’est précisément le moment où l’univers choisit de tester votre spiritualité.

Alternative : utiliser un autre environnement local

Local reste très confortable, surtout pour les sites WordPress classiques et les workflows avec WP Engine ou Flywheel. Local Connect permet notamment de pousser et tirer des sites avec WP Engine ou Flywheel.

Cela dit, si Local devient un goulot d’étranglement dans votre workflow, vous pouvez tester d’autres stacks :

• DDEV ;
• Lando ;
• Docker Compose maison ;
• Laravel Valet sur macOS ;
• Valet Linux ;
• MAMP ou XAMPP pour des besoins simples.

Pour du développement WordPress avancé, DDEV est souvent très propre : Docker standard, configuration versionnable, PHP/MySQL faciles à aligner avec la production, et moins de magie noire dans l’interface.

Checklist rapide : Local WP ne démarre plus

• Arrêter puis relancer le site dans Local.
• Utiliser Restart site si disponible.
• Quitter Local complètement.
• Redémarrer l’ordinateur.
• Changer le Router Mode.
• Vérifier les ports 80 et 443.
• Vérifier le fichier hosts.
• Désactiver VPN, proxy, antivirus ou pare-feu pour tester.
• Lire les logs depuis l’onglet Support.
• Ouvrir le shell du site et tester WP-CLI.
• Désactiver les plugins si WordPress plante.
• Exporter le site avant toute réinstallation.
• Redémarrer la VM VirtualBox uniquement sur une ancienne version de Local.

Articles liés sur SkyMinds

Pour compléter ce guide Local WP et développement WordPress, ces articles peuvent aider :

• Récupérer l’ID d’un post ou d’une page sous WordPress
• WordPress : changer le mot de passe d’un utilisateur depuis SQL
• Plugin WordPress pas dans la liste des plugins
• WordPress : valider le code HTML des embeds oEmbed
• Optimiser les requêtes SQL des plugins WordPress

FAQ : Local WP bloqué ou site qui ne démarre plus

Faut-il encore ouvrir VirtualBox pour redémarrer Local ?

Seulement si vous utilisez une ancienne version de Local by Flywheel qui crée une machine virtuelle local-by-flywheel. Sur Local WP moderne, commencez par redémarrer le site, l’application, le router et les services.

Que faire si Local reste bloqué sur “Starting site services” ?

Arrêtez le site, quittez Local, redémarrez l’ordinateur, changez le Router Mode, vérifiez les ports 80/443, puis consultez les logs depuis l’onglet Support.

Pourquoi Local affiche-t-il une erreur 502 ?

Une erreur 502 indique souvent que le router répond, mais que PHP, nginx, Apache ou WordPress ne répond pas correctement. Redémarrez le site, consultez les logs PHP et testez les plugins via WP-CLI.

Quel Router Mode choisir dans Local ?

Utilisez Site Domains pour des URLs propres comme monsite.local. Passez temporairement en Localhost si les domaines locaux, le fichier hosts ou les ports 80/443 posent problème.

Comment savoir si un port bloque Local ?

Sur macOS ou Linux, utilisez sudo lsof -i :80 et sudo lsof -i :443. Sur Windows, utilisez PowerShell avec Get-NetTCPConnection -LocalPort 80,443.

Les sites Local sont-ils perdus si l’application ne démarre plus ?

Pas forcément. Les fichiers du site et la base peuvent encore être récupérables. Avant de réinstaller Local ou de supprimer quoi que ce soit, exportez le site ou copiez son dossier local.

Comment récupérer les logs Local ?

Ouvrez Local, allez dans l’onglet Support, puis utilisez Download Local Logs. Relisez l’archive avant de la partager publiquement pour éviter de publier des informations privées.

Faut-il remplacer Local par DDEV ?

Pas obligatoirement. Local reste excellent pour un workflow WordPress simple. DDEV devient plus intéressant si vous voulez un environnement Docker versionnable, reproductible et plus proche d’une stack de production.

Conclusion

L’ancienne astuce VirtualBox reste valable uniquement pour les vieilles versions de Local by Flywheel. Si vous utilisez Local WP aujourd’hui, redémarrez d’abord le site, puis l’application, puis le système. Ensuite, vérifiez Router Mode, ports, fichier hosts, pare-feu et logs.

La bonne méthode est progressive : ne tuez pas la machine virtuelle si un simple service PHP bloque. Ne réinstallez pas Local si un plugin WordPress fait une fatale. Et surtout, exportez vos sites avant les grosses manipulations. Local est pratique, mais votre travail client mérite mieux qu’un clic nerveux sur “Delete”.

Sources

• Local WP : documentation officielle
• Local WP : release notes
• Local WP : importer, exporter et restaurer un site
• Local WP : warnings, erreurs et redémarrage après modification de configuration
• Local Community : télécharger les logs Local depuis l’onglet Support
• Local Community : problèmes de sites après démarrage et Router Mode

Report a typo