uv 설치 프로그램 설정하기¶

설치 경로 변경하기¶

기본적으로 uv는 ~/.local/bin에 설치된다. XDG_BIN_HOME이 설정되어 있다면 해당 경로가 사용된다. 마찬가지로 XDG_DATA_HOME이 설정된 경우, 대상 디렉터리는 XDG_DATA_HOME/../bin으로 추론된다.

설치 경로를 변경하려면 UV_INSTALL_DIR을 사용한다:

=== "macOS와 Linux"

```console
$ curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR="/custom/path" sh
```

=== "Windows"

```powershell
powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "C:\Custom\Path";irm https://astral.sh/uv/install.ps1 | iex}
```

설치 프로그램은 PATH에 uv 바이너리를 추가하기 위해 셸 프로필을 업데이트할 수 있다. 이 동작을 비활성화하려면 INSTALLER_NO_MODIFY_PATH를 사용한다. 예를 들어:

$ curl -LsSf https://astral.sh/uv/install.sh | env INSTALLER_NO_MODIFY_PATH=1 sh

INSTALLER_NO_MODIFY_PATH와 함께 설치하면, uv self update와 같은 후속 작업에서 셸 프로필을 수정하지 않는다.

CI와 같은 일시적인 환경에서는 UV_UNMANAGED_INSTALL을 사용하여 uv를 특정 경로에 설치할 수 있다. 이 방법은 설치 과정에서 셸 프로필이나 환경 변수를 수정하지 않도록 방지한다.

$ curl -LsSf https://astral.sh/uv/install.sh | env UV_UNMANAGED_INSTALL="/custom/path" sh

UV_UNMANAGED_INSTALL을 사용하면 자동 업데이트 기능(uv self update를 통한)도 비활성화된다.

환경 변수를 사용하는 것이 플랫폼 간 일관성을 유지하기 때문에 권장된다. 하지만 옵션을 직접 설치 스크립트에 전달할 수도 있다. 예를 들어, 사용 가능한 옵션을 확인하려면 다음 명령어를 실행한다:

$ curl -LsSf https://astral.sh/uv/install.sh | sh -s -- --help