Dépannage

Docker n'est pas lancé

failed to connect to the docker API at unix:///…/docker.sock; check if the path is correct and if the daemon is running

Les anciennes versions de Docker affichent plutôt « Cannot connect to the Docker daemon ». Dans les deux cas, le moteur Docker n'est pas démarré.

1. 01

   Ouvrez Docker Desktop

   Lancez Docker Desktop et attendez qu'il indique que le moteur est en marche. Sous Linux, démarrez le service : sudo systemctl start docker.
2. 02

   Vérifiez que Docker répond

   TerminalCopier

   docker info

   Résultat attendu: Une section Server s'affiche au lieu d'une erreur.
3. 03

   Relancez votre commande

   docker build -t analytics-landing ., puis docker run -p 3030:3030 analytics-landing.

Un port est déjà utilisé

Bind for 0.0.0.0:3030 failed: port is already allocated
ports are not available: exposing port TCP 0.0.0.0:3030 … bind: address already in use
Error: listen EADDRINUSE: address already in use :::3030

Les deux premières lignes viennent de Docker, la dernière de yarn dev ou yarn start. Un autre programme écoute déjà sur le port 3030 : souvent une exécution précédente de ce site, ou le serveur d'un autre projet.

1. 01

   Trouvez ce qui occupe le port

   Sous macOS ou Linux :

   TerminalCopier

   lsof -i :3030

   Sous Windows, dans PowerShell :

   TerminalCopier

   netstat -ano | findstr :3030
2. 02

   Arrêtez-le

   Fermez ce programme, ou arrêtez l'exécution précédente : Ctrl+C dans son terminal, ou docker stop avec l'identifiant du conteneur donné par docker ps. Puis relancez le site.
3. 03

   Ou utilisez un autre port

   Gardez l'autre programme et démarrez le site sur un port libre, ici 3041 :

   Comment vous la lancez	Commande
   Docker	docker run -p 3041:3030 analytics-landing
   Serveur de développement	yarn dev -p 3041
   Build de production	yarn start -p 3041

   Avec Docker, changez uniquement le nombre à gauche de -p : dans le conteneur, le site écoute toujours sur 3030.

   Résultat attendu: Le site répond sur localhost:3041/enLocal.

Le build échoue

docker build s'arrête avec « failed to solve » et l'étape qui a échoué ; yarn build s'arrête avec l'erreur elle-même. Les causes habituelles :

• Pas de connexion ou délai dépassé : le build télécharge les dépendances, ainsi que les polices DM Sans, Noto Sans Arabic et Almarai depuis Google Fonts. Un message comme « Failed to fetch DM Sans from Google Fonts. » signifie que le build n'a pas pu les atteindre. Relancez la commande une fois en ligne ; avec Docker, les étapes terminées sont mises en cache.
• `Invalid URL` : NEXT_PUBLIC_SITE_URL n'est pas une adresse complète. Écrivez-la avec https://, comme https://www.your-domain.com.
• No space left on device : libérez de l'espace dans Docker Desktop, ou vérifiez ce que Docker occupe avec docker system df.
• L'échec survient toujours à la même étape : reconstruisez sans le cache.

docker build --no-cache -t analytics-landing .

Sans Docker, supprimez les dossiers node_modules et .next, puis relancez yarn install et yarn build.

Yarn indique la version 1.22

This project's package.json defines "packageManager": "yarn@4.8.1…". However the current global version of Yarn is 1.22…

Le projet impose Yarn 4 via Corepack. Ce message signifie que Corepack n'est pas encore activé, donc un ancien Yarn global a répondu à sa place.

corepack enable

Puis relancez yarn install. Utilisez Yarn plutôt que npm : yarn.lock garde votre installation sur les versions avec lesquelles le template a été testé.

La commande corepack est introuvable

corepack: command not found

Node.js 25 et les versions suivantes n'incluent plus Corepack. Installez-le une fois avec npm, puis activez-le :

npm install -g corepack
corepack enable

Puis relancez yarn install. Les mêmes deux commandes règlent yarn: command not found.

Node.js est trop ancien

You are using Node.js 18.20.4. For Next.js, Node.js version ">=20.9.0" is required.

Next.js 16 a besoin de Node.js 20.9 ou plus récent. Vérifiez votre version avec node -v. Installez Node.js 22 ou 24, ouvrez un nouveau terminal, relancez corepack enable, puis yarn install et yarn dev.

Avec Docker, cela ne s'applique pas : l'image apporte son propre Node.js 24.

Un paramètre modifié n'a aucun effet

NEXT_PUBLIC_SITE_URL et les autres valeurs NEXT_PUBLIC_ sont intégrées au site lors du build. En changer une ne change rien tant que le site n'est pas reconstruit.

• Les paramètres

yarn start échoue, ou affiche une ancienne version

Could not find a production build in the '.next' directory. Try building your app with 'next build' before starting the production server.

yarn start sert le dernier build de production, depuis le dossier .next. Lancez d'abord yarn build, et de nouveau après chaque modification.

Si le site affiche des erreurs qui ne correspondent pas à votre code, souvent après avoir changé la version d'une dépendance ou BUILD_STANDALONE, supprimez le dossier .next et reconstruisez :

rm -rf .next
yarn build

Sous Windows, dans PowerShell, supprimez-le avec Remove-Item -Recurse -Force .next.

Un formulaire dit avoir été envoyé, mais rien n'arrive

C'est ainsi que le template est livré. Les formulaires vérifient ce que saisissent les visiteurs et affichent leur message de succès, mais n'envoient rien nulle part tant que vous ne reliez pas chacun de ceux que vous gardez à votre propre service.

• Les formulaires

Un nouveau thème de couleurs ne s'affiche pas en développement

Avec yarn dev, un panneau flottant permet d'essayer les quatre thèmes de couleurs, et le navigateur retient celui que vous y avez choisi. Ce choix l'emporte sur le thème défini dans le code. Choisissez le même thème dans le panneau, ou effacez les données du site localhost:3030 dans votre navigateur.

Un build de production, avec yarn start ou Docker, n'affiche jamais le panneau et utilise toujours le thème défini dans le code.

• Couleurs et thèmes

Le site s'ouvre en arabe

Ouvrir / envoie le visiteur vers /ar quand son navigateur préfère l'arabe, et vers /en sinon. Choisissez l'autre langue dans le menu de langue de l'en-tête, ou ouvrez /en directement.

• Langues

Un lien ne mène nulle part

Certains liens du pied de page, les icônes sociales et les liens sociaux de la page de contact pointent vers des # provisoires. C'est voulu : à vous de les faire pointer vers vos propres pages et profils. Les liens de l'en-tête, des tarifs, du blog et du contact, ainsi que les boutons d'inscription, fonctionnent déjà.

• Liens et boutons

Le dossier ne correspond pas

Lancez les commandes dans le dossier où le ZIP s'extrait, Nextjs-landing-page-template-2. Il contient Dockerfile, package.json, yarn.lock, messages, public et src. Si la commande unzip est absente, extrayez-le avec votre gestionnaire de fichiers ; certains outils ajoutent un dossier supplémentaire portant le nom du ZIP, entrez alors dans le dossier intérieur.