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 agency-portfolio ., puis docker run -p 3030:3030 agency-portfolio.

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 run, 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 du site, ou le serveur de développement 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

   Un conteneur précédent apparaît dans docker ps.
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. Puis redémarrez le site.
3. 03

   Ou lancez le site sur un autre port

   Avec Docker, changez le nombre à gauche de -p. Le nombre à droite reste 3030 : c'est le port à l'intérieur du conteneur.

   Terminaldans landing-page-template-1Copier

   docker run -p 3041:3030 agency-portfolio

   Sans Docker, passez le port au script :

   Terminaldans landing-page-template-1Copier

   yarn dev -p 3041

   Pour un build de production, yarn start -p 3041.

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

Le build Docker échoue

Le premier build télécharge l'image de base Node.js et toutes les dépendances, puis fait le build du site. Il s'arrête avec « failed to solve » et l'étape en échec quand quelque chose bloque.

• Pas de connexion ou délai dépassé : le build a besoin d'un accès à internet. Relancez la commande une fois en ligne ; les étapes terminées sont en cache.
• No space left on device : libérez de l'espace dans Docker Desktop, ou vérifiez ce que Docker occupe avec docker system df.
• Il échoue toujours à la même étape : refaites le build sans le cache.

docker build --no-cache -t agency-portfolio .

Le dossier ne correspond pas

failed to read dockerfile: open Dockerfile: no such file or directory

La commande a été lancée hors du dossier du template. Le ZIP contient un seul dossier, landing-page-template-1, avec le Dockerfile à sa racine. Certains navigateurs décompressent le téléchargement d'eux-mêmes : le dossier est alors déjà dans vos téléchargements.

cd landing-page-template-1
ls

ls (ou dir sous Windows) affiche Dockerfile, package.json, messages, public et src. Lancez les commandes depuis cet endroit.

Yarn indique la version 1.22

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

Le projet fixe Yarn 4 via Corepack. Ce message signifie que Corepack n'est pas encore activé, et c'est donc l'ancien Yarn global qui a répondu.

corepack enable

Puis relancez yarn install. Si votre Node.js n'a pas Corepack, installez-le d'abord avec npm install -g corepack.

Un réglage modifié n'a aucun effet

NEXT_PUBLIC_SITE_URL et NEXT_PUBLIC_API_BASE_URL sont inscrits dans le site au moment du build. Un build en marche garde les valeurs avec lesquelles il a été construit.

• Sans Docker : placez-les dans .env.local dans le dossier du projet, pas dans .env.example. Redémarrez yarn dev, ou relancez yarn build avant yarn start.
• Avec Docker : passez-les avec --build-arg à docker build et refaites le build. docker run -e ne les change pas.
• Sur Vercel ou un autre hébergeur : modifiez la variable, puis redéployez.

• Les deux réglages

Les liens partagés et les aperçus pointent vers localhost

Le lien canonique, les liens de langue ou une carte d'aperçu affichent http://localhost:3030. Le site a été construit sans NEXT_PUBLIC_SITE_URL, qui revient alors à cette adresse. Donnez-lui votre adresse publique, par exemple https://www.your-domain.com, et refaites le build.

Le formulaire de contact

• Il indique que le message est envoyé, mais rien n'arrive : NEXT_PUBLIC_API_BASE_URL est vide, donc le formulaire affiche seulement son message de réussite et n'envoie rien. Donnez-lui l'adresse de votre API et refaites le build.
• Il affiche « Something went wrong. Please try again. » : la requête vers le chemin /contact de votre API a échoué. Les outils de développement du navigateur en donnent la raison dans l'onglet Réseau : l'API est injoignable, le chemin n'existe pas, elle a répondu par une erreur, ou elle n'accepte pas les requêtes venant de l'adresse de votre site (CORS).

• Le formulaire de contact

Le site s'ouvre en arabe

Une adresse sans langue, comme /, suit la langue du navigateur : un navigateur réglé en arabe obtient donc /ar. Dans une même session du navigateur, elle revient aussi à la dernière langue ouverte, gardée dans un cookie NEXT_LOCALE. Ouvrez /en pour l'anglais, ou utilisez le sélecteur de langue dans la barre de navigation.

Le pointeur de la souris disparaît

C'est le curseur propre à la page : sur les écrans de 768 pixels de large et plus, il masque le pointeur du système et dessine à la place un point et un anneau. Pour garder le pointeur normal, voyez le curseur personnalisé.

• Le curseur personnalisé

yarn lint avertit que next lint est obsolète

L'avertissement vient de Next.js 15.5 lui-même. yarn lint lance toujours ESLint sur le code et affiche ses résultats comme d'habitude.