Skip to content

Commit d7dc184

Browse files
Explicitly mention --user in compatibility guide (#3666)
See: #2352
1 parent e3ae876 commit d7dc184

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

PIP_COMPATIBILITY.md

+11
Original file line numberDiff line numberDiff line change
@@ -282,6 +282,17 @@ In some cases, `uv pip check` will surface diagnostics that `pip check` does not
282282
For example, unlike `uv pip check`, `pip check` will _not_ warn when multiple versions of a package
283283
are installed in the current environment.
284284

285+
## `--user` and the `user` install scheme
286+
287+
uv does not support the `--user` flag, which installs packages based on the `user` install scheme.
288+
Instead, we recommend the use of virtual environments to isolate package installations.
289+
290+
Additionally, pip will fall back to the `user` install scheme if it detects that the user does not
291+
have write permissions to the target directory, as is the case on some systems when installing into
292+
the system Python. uv does not implement any such fallback.
293+
294+
For more, see [#2077](https://github.com/astral-sh/uv/issues/2077).
295+
285296
## Strictness and spec enforcement
286297

287298
uv tends to be stricter than `pip`, and will often reject packages that `pip` would install.

0 commit comments

Comments
 (0)