Skip to content

インストーラー

Voltaは、さまざまなプラットフォームでの簡単なインストールを提供するため、複数のインストール方法を提供しています。

Unix(macOS、Linux)

Bashスクリプト(推奨)

Unix系システムでVoltaをインストールする最も簡単な方法は、公式インストールスクリプトを使用することです:

bash
curl https://get.volta.sh | bash

このスクリプトは以下を実行します:

  • 最新バージョンのVoltaをダウンロードしてインストール
  • 適切なシェル設定ファイル(.bashrc.zshrcなど)にVoltaを追加
  • 新しいターミナルセッションでVoltaを利用可能にする

手動インストール

より詳細な制御が必要な場合、手動でVoltaをインストールできます:

  1. リリースのダウンロード

    bash
    # 最新リリースを取得
    curl -sSLf https://github.com/volta-cli/volta/releases/latest/download/volta-1.1.1-linux.tar.gz | tar -xz
    
    # ファイルを適切な場所に移動
    sudo mv volta /usr/local/bin/
  2. シェル設定の更新

    bash
    # ~/.bashrc または ~/.zshrc に追加
    export VOLTA_HOME="$HOME/.volta"
    export PATH="$VOLTA_HOME/bin:$PATH"
  3. 設定の再読み込み

    bash
    source ~/.bashrc  # または source ~/.zshrc

Windows

PowerShellスクリプト(推奨)

WindowsでVoltaをインストールする推奨方法は、PowerShellスクリプトを使用することです:

powershell
# PowerShellでVoltaをインストール
winget install Volta.Volta

または、手動インストール用のスクリプト:

powershell
# PowerShellでスクリプトを実行
iex ((New-Object System.Net.WebClient).DownloadString('https://get.volta.sh'))

手動Windowsインストール

  1. インストーラーのダウンロード

  2. インストーラーの実行

    • ダウンロードした.msiファイルをダブルクリック
    • インストールウィザードの指示に従う
  3. 環境変数の確認: インストール後、以下の環境変数が設定されていることを確認:

    VOLTA_HOME=%LOCALAPPDATA%\Volta
    PATH=%VOLTA_HOME%\bin;%PATH%

パッケージマネージャー

Homebrew(macOS)

bash
brew install volta

Scoop(Windows)

powershell
scoop install volta

Chocolatey(Windows)

powershell
choco install volta

Cargo(Rust)

Rustツールチェーンがインストールされている場合:

bash
cargo install volta

Docker

Dockerコンテナ内でVoltaを使用するには:

dockerfile
FROM node:16

# Voltaをインストール
RUN curl https://get.volta.sh | bash && \
    export VOLTA_HOME="/root/.volta" && \
    export PATH="$VOLTA_HOME/bin:$PATH" && \
    volta install node@16 npm@8

# 環境変数を設定
ENV VOLTA_HOME="/root/.volta"
ENV PATH="$VOLTA_HOME/bin:$PATH"

カスタムインストール

特定バージョンのインストール

特定のVoltaバージョンをインストールしたい場合:

bash
# Unix
curl -sSLf https://github.com/volta-cli/volta/releases/download/v1.1.1/volta-1.1.1-linux.tar.gz | tar -xz

# Windows PowerShell
$version = "1.1.1"
Invoke-WebRequest -Uri "https://github.com/volta-cli/volta/releases/download/v$version/volta-$version-windows-x86_64.msi" -OutFile "volta-installer.msi"

プロキシ環境でのインストール

企業プロキシ環境でインストールする場合:

bash
# プロキシ設定でcurlを使用
curl --proxy http://proxy.company.com:8080 https://get.volta.sh | bash

# または、環境変数を設定
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
curl https://get.volta.sh | bash

インストール後の確認

インストールが成功したことを確認するには:

bash
# Voltaバージョンを確認
volta --version

# 利用可能なツールを確認
volta list all

# Nodeの最新バージョンをインストール
volta install node

アンインストール

Unix

bash
# Voltaホームディレクトリを削除
rm -rf ~/.volta

# シェル設定からVolta設定を削除
# ~/.bashrc, ~/.zshrc などから以下の行を削除:
# export VOLTA_HOME="$HOME/.volta"
# export PATH="$VOLTA_HOME/bin:$PATH"

Windows

  1. プログラムと機能からVoltaをアンインストール
  2. または、PowerShellで:
    powershell
    # Volta ディレクトリを削除
    Remove-Item -Recurse -Force $env:LOCALAPPDATA\Volta
    
    # 環境変数を削除(システム設定で手動、またはレジストリ編集)

トラブルシューティング

権限エラー

Unix系システムで権限エラーが発生した場合:

bash
# Voltaホームディレクトリの権限を修正
sudo chown -R $USER:$USER ~/.volta

PATH設定の問題

Voltaがコマンドとして認識されない場合:

bash
# 現在のPATHを確認
echo $PATH

# Voltaパスが含まれていることを確認
echo $VOLTA_HOME

# シェル設定を再読み込み
source ~/.bashrc  # または適切な設定ファイル

ネットワーク問題

ダウンロードに失敗する場合:

bash
# DNSを確認
nslookup get.volta.sh

# 手動でファイルをダウンロード
wget https://github.com/volta-cli/volta/releases/latest/download/volta-1.1.1-linux.tar.gz