Error: EEXIST: file already exists, mkdir

Node tried to create a file/directory/symlink that already exists.

Exact message you may see EEXIST: file already exists
Seen on: Node.js

Meaning

fs.mkdir without { recursive: true }, symlink creation in repeated runs, or npm linking over an existing binary.

Common causes

  • mkdir on an existing directory
  • Re-running setup scripts
  • npm global install over an existing bin link

⚡ Quick fix

  1. Use fs.mkdirSync(dir, { recursive: true })
  2. Check existence first or ignore EEXIST
  3. npm: install with --force or remove the old link

Detailed fix by platform

Node.js

  1. fs.mkdirSync(outDir, { recursive: true });

How to diagnose

  1. Path — What already exists?
  2. Script — Idempotent?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

0x80070020 — 0x80070020: The process cannot access the file because it is being used by another process (Windows)0x800700200x80070570 — Error 0x80070570: The file or directory is corrupted and unreadable (Windows)0x80070570Access to the path is denied — System.UnauthorizedAccessException: Access to the path 'x' is denied (.NET)Access to the path is…AccessDeniedException — java.nio.file.AccessDeniedException: /path (Java)AccessDeniedExceptionArgument list too long — bash: /bin/rm: Argument list too long (Linux)Argument list too longEEXIST — npm ERR! code EEXIST — EEXIST: file already exists, symlink '../lib/node_modules/x/bin/x' -> '/usr/local/bin/x' (npm)EEXISTEISDIR — Error: EISDIR: illegal operation on a directory, read (Node.js)EISDIRENOENT — Error: ENOENT: no such file or directory (Node.js)ENOENTEEXIST

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.