@@ -35,8 +35,8 @@ systemctl --user enable --now code-server
 
 ### npm
 
-**note:** Installing via `npm` requires building native module dependencies. See [./doc/npm.md](./doc/npm.md)
-for the dependency install process depending on your OS.
+**note:** Installing via `npm` requires certain dependencies for the native module builds.
+See [./doc/npm.md](./doc/npm.md) for installing these dependencies.
 
 ```bash
 npm install -g code-server
 
@@ -4,18 +4,34 @@ set -eu
 main() {
   cd lib/vscode
 
+  case "${npm_config_user_agent-}" in npm*)
+    # We are running under npm.
+    if [ "${npm_config_unsafe_perm-}" != "true" ]; then
+      echo "Please pass --unsafe-perm to npm to install code-server"
+      echo "Otherwise the postinstall script does not have permissions to run"
+      echo "See https://docs.npmjs.com/misc/config#unsafe-perm"
+      echo "See https://stackoverflow.com/questions/49084929/npm-sudo-global-installation-unsafe-perm"
+      exit 1
+    fi
+    ;;
+  esac
+
   # We have to rename node_modules.bundled to node_modules.
   # The bundled modules were renamed originally to avoid being ignored by yarn.
-  local node_modules
   node_modules="$(find . -depth -name "node_modules.bundled")"
-  local nm
   for nm in $node_modules; do
     rm -Rf "${nm%.bundled}"
     mv "$nm" "${nm%.bundled}"
   done
 
+  # $npm_config_global makes npm rebuild return without rebuilding.
+  unset npm_config_global
   # Rebuilds native modules.
-  npm rebuild
+  if ! npm rebuild; then
+    echo "You may not have the required dependencies to build the native modules."
+    echo "Please see https://github.com/cdr/code-server/blob/master/doc/npm.md"
+    exit 1
+  fi
 }
 
 main "$@"
@@ -75,4 +75,7 @@ download_artifact() {
   curl -sSL "$(get_artifact_url "$artifact_name")" > "$tmp_file"
   unzip -o "$tmp_file" -d "$dst"
   rm "$tmp_file"
+
+  # https://github.com/actions/upload-artifact/issues/38
+  chmod +x $(grep -rl '^#!/.\+' "$dst")
 }
@@ -10,8 +10,6 @@ main() {
   fi
 
   download_artifact npm-package ./release
-  # https://github.com/actions/upload-artifact/issues/38
-  chmod +x $(grep -rl '^#!/.\+' release)
   yarn publish --non-interactive release
 }
 
 
@@ -1,7 +1,7 @@
 {
   "name": "code-server",
   "license": "MIT",
-  "version": "3.3.0-rc.21",
+  "version": "3.3.0-rc.24",
   "description": "Run VS Code on a remote server.",
   "homepage": "https://github.com/cdr/code-server",
   "bugs": {
Original file line number	Diff line number	Diff line change
@@ -75,4 +75,7 @@ download_artifact() {
75	75	curl -sSL "$(get_artifact_url "$artifact_name")" > "$tmp_file"
76	76	unzip -o "$tmp_file" -d "$dst"
77	77	rm "$tmp_file"
	78	+
	79	+ # https://github.com/actions/upload-artifact/issues/38
	80	+ chmod +x $(grep -rl '^#!/.\+' "$dst")
78	81	}
Original file line number	Diff line number	Diff line change
@@ -10,8 +10,6 @@ main() {
10	10	fi
11	11
12	12	download_artifact npm-package ./release
13		- # https://github.com/actions/upload-artifact/issues/38
14		- chmod +x $(grep -rl '^#!/.\+' release)
15	13	yarn publish --non-interactive release
16	14	}
17	15
Original file line number	Diff line number	Diff line change
@@ -1,7 +1,7 @@
1	1	{
2	2	"name": "code-server",
3	3	"license": "MIT",
4		- "version": "3.3.0-rc.21",
	4	+ "version": "3.3.0-rc.24",
5	5	"description": "Run VS Code on a remote server.",
6	6	"homepage": "https://github.com/cdr/code-server",
7	7	"bugs": {