Skip to content

docs: improve documentation on resolving EACCES #1711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 15, 2025
Merged

docs: improve documentation on resolving EACCES #1711

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 14 additions & 16 deletions ...istry/resolving-eacces-permissions-errors-when-installing-packages-globally.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,45 +24,43 @@ This is the best way to avoid permissions issues. To reinstall npm with a node v

</Note>

To minimize the chance of permissions errors, you can configure npm to use a different directory. In this example, you will create and use hidden directory in your home directory.
To minimize the chance of permissions errors, you can configure npm to use a different directory. In this example, you will create and use a hidden directory in your home directory.

1. Back up your computer.

2. On the command line, in your home directory, create a directory for global installations:
1. Configure npm to use the new directory path:

```
mkdir -p ~/.npm-global/lib
npm config set prefix ~/.local
```

3. Configure npm to use the new directory path:
2. In your preferred text editor, open or create a `~/.profile` file and add this line:

```
npm config set prefix ~/.npm-global
PATH=~/.local/bin:$PATH
```

4. In your preferred text editor, open or create a `~/.profile` file and add this line:
If you are using zsh (which you can find out by running `echo $0`), you will also need to add this line to `~/.zprofile`:

```
export PATH=~/.npm-global/bin:$PATH
source ~/.profile
```

5. On the command line, update your system variables:
3. On the command line, update your system variables:

```
source ~/.profile
```

6. To test your new configuration, install a package globally without using `sudo`:
4. To test your new configuration, install a package globally without using `sudo`:

```
npm install -g jshint
npm install -g npm-check-updates
```

Instead of steps 3-5, you can use the corresponding ENV variable (e.g. if you don't want to modify `~/.profile`):
And run it:

```
NPM_CONFIG_PREFIX=~/.npm-global
```
```
ncu -g
```

<Note>

Expand Down
Loading