Skip to content

The uv installeruvインストーラー

Changing the installation pathインストールパスの変更

By default, uv is installed in the user executable directory.デフォルトでは、uvはユーザーの実行可能ディレクトリにインストールされます。

To change the installation path, use UV_INSTALL_DIR:インストールパスを変更するには、UV_INSTALL_DIRを使用します:

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

Note注意

Changing the installation path only affects where the uv binary is installed. uv will still store its data (cache, Python installations, tools, etc.) in the default locations. See the storage reference for details on these locations and how to customize them.インストールパスを変更しても、uvバイナリがインストールされる場所にのみ影響します。uvは引き続きデフォルトの場所にデータ(キャッシュ、Pythonインストール、ツールなど)を保存します。これらの場所やカスタマイズ方法の詳細については、ストレージリファレンスを参照してください。

Disabling shell modificationsシェルの変更を無効にする

The installer may also update your shell profiles to ensure the uv binary is on your PATH. To disable this behavior, use UV_NO_MODIFY_PATH. For example:インストーラーは、uvバイナリがPATHに含まれるようにシェルプロファイルを更新することがあります。この動作を無効にするには、UV_NO_MODIFY_PATHを使用します。例えば:

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

If installed with UV_NO_MODIFY_PATH, subsequent operations, like uv self update, will not modify your shell profiles.UV_NO_MODIFY_PATHでインストールされた場合、uv self updateのようなその後の操作は、シェルプロファイルを変更しません。

Unmanaged installations管理されていないインストール

In ephemeral environments like CI, use UV_UNMANAGED_INSTALL to install uv to a specific path while preventing the installer from modifying shell profiles or environment variables:CIのような一時的な環境では、UV_UNMANAGED_INSTALLを使用して、インストーラーがシェルプロファイルや環境変数を変更することなく、特定のパスにuvをインストールします:

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

The use of UV_UNMANAGED_INSTALL will also disable self-updates (via uv self update).UV_UNMANAGED_INSTALLを使用すると、自己更新(uv self updateを介して)も無効になります。

Passing options to the installation scriptインストールスクリプトにオプションを渡す

Using environment variables is recommended because they are consistent across platforms. However, options can be passed directly to the installation script. For example, to see the available options:環境変数を使用することが推奨されます。なぜなら、それらはプラットフォーム間で一貫性があるからです。しかし、オプションはインストールスクリプトに直接渡すこともできます。例えば、利用可能なオプションを確認するには:

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