How to fix npm ERR! code ELIFECYCLE npm ERR! errno 128 npm ERR! Exit status 128 in npm

What this error means

Exit code 128 is a Git-specific error code indicating that a Git operation failed during npm install. This commonly occurs when package.json includes dependencies hosted on Git repositories (using `git+ssh://` or `git+https://` URLs) and authentication fails. The most frequent cause is SSH key issues—either the SSH key isn't loaded, the SSH agent isn't running, or the key doesn't have access to the private repository. This error is especially common in CI/CD environments where SSH keys need explicit configuration.

Typical symptoms

• npm install fails on git+ssh:// or git+https:// dependencies
• Error message includes "Could not read from remote repository"
• Works on local machine but fails in CI/Docker
• Works for some team members but not others
• Intermittent failures with many git dependencies
• "Permission denied (publickey)" appears before ELIFECYCLE

Common causes

1. SSH key not loaded into SSH agent
2. SSH agent not running
3. SSH key lacks access to private repository
4. Git URL protocol blocked by firewall (git:// on port 9418)
5. package-lock.json references unavailable git commits
6. Incorrect authentication token for HTTPS Git URLs
7. Too many concurrent SSH connections in large monorepos

How to fix "npm ERR! code ELIFECYCLE npm ERR! errno 128 npm ERR! Exit status 128"

# Start SSH agent
eval "$(ssh-agent -s)"

# Add your SSH key
ssh-add ~/.ssh/id_rsa

# Or for newer ed25519 keys
ssh-add ~/.ssh/id_ed25519

# Verify key is loaded
ssh-add -l

# For GitHub
ssh -T [email protected]

# For GitLab
ssh -T [email protected]

# For Bitbucket
ssh -T [email protected]

# Configure Git to use HTTPS globally
git config --global url."https://".insteadOf git://

# For GitHub specifically
git config --global url."https://github.com/".insteadOf [email protected]:

# Clear npm cache
npm cache clean --force

# Remove lock file and modules
rm -rf node_modules package-lock.json

# Reinstall
npm install

- uses: webfactory/[email protected]
  with:
    ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

# Mount SSH socket
docker run -v $SSH_AUTH_SOCK:/ssh-agent -e SSH_AUTH_SOCK=/ssh-agent ...

# Or use BuildKit secrets
RUN --mount=type=ssh npm install

# Configure Git to use token
git config --global url."https://${GITHUB_TOKEN}@github.com/".insteadOf "https://github.com/"

# Or update package.json to use HTTPS
"dependencies": {
  "private-pkg": "https://${GITHUB_TOKEN}@github.com/org/repo.git"
}

Advanced notes

npm install --maxsockets=2

# ~/.ssh/config
Host github.com
  Hostname ssh.github.com
  Port 443
  User git

Frequently asked questions

What does "npm ERR! code ELIFECYCLE npm ERR! errno 128 npm ERR! Exit status 128" mean?

Exit code 128 is a Git-specific error code indicating that a Git operation failed during npm install. json includes dependencies hosted on Git repositories (using git+ssh:// or git+https:// URLs) and authentication fails. The most frequent cause is SSH key issues—either the SSH key isn't loaded, the SSH agent isn't running, or the key doesn't have access to the private repository.

How do I fix "npm ERR! code ELIFECYCLE npm ERR! errno 128 npm ERR! Exit status 128"?

Exit code 128 in npm typically indicates a Git-related failure, usually SSH authentication issues when installing dependencies from Git repositories. Check SSH key configuration and Git access.

What causes "npm ERR! code ELIFECYCLE npm ERR! errno 128 npm ERR! Exit status 128"?

SSH key not loaded into SSH agent SSH agent not running SSH key lacks access to private repository

Is the "npm ERR! code ELIFECYCLE npm ERR! errno 128 npm ERR! Exit status 128" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• npm ERR! code ELIFECYCLE npm ERR! errno 130 npm ERR! Exit status 130

  How to fix "Exit status 130 (SIGINT)" in npm

  LOW

• npm ERR! code ELIFECYCLE npm ERR! errno 127

  How to fix "ELIFECYCLE" exit code 127 in npm

  MEDIUM

• npm ERR! code ELIFECYCLE npm ERR! errno 134 npm ERR! Exit status 134

  How to fix "ELIFECYCLE errno 134 Exit status 134" in npm

  MEDIUM

• npm ERR! code ELIFECYCLE npm ERR! errno 126 npm ERR! Exit status 126

  How to fix npm ELIFECYCLE errno 126 (Permission denied) error

  MEDIUM

• npm ERR! code EAI_AGAIN

  How to fix "EAI_AGAIN" in npm

  MEDIUM

• npm ERR! code EPERM npm ERR! This operation requires administrator privileges

  How to fix "EPERM: This operation requires administrator privileges" in npm

  MEDIUM

Official resources & further reading

• 📚npm Official Documentation
• 💬
  Stack Overflow: npm install error code 128(Stack Overflow)
• 🐙
  GitHub #16980: npm/npm(GitHub)
• 💬
  Stack Overflow: how to solve npm error npm err code elifecycle(Stack Overflow)