結論
Windows で WSL と Ubuntu を使えるようにする手順は、次の流れで進めれば大丈夫です。
-
wsl -l -vで現在の状態を確認する -
wsl --installで WSL を導入する - 必要に応じて
wsl --list --onlineとwsl --install -d Ubuntuで Ubuntu を入れる - Ubuntu を初回起動して Linux ユーザーを作成する
-
sudo apt update && sudo apt upgradeで更新する -
wsl -l -vでUbuntuとVERSION 2を確認する
今回は、wsl 自体は使えるのに Ubuntu が入っていない状態だったので、そこから Ubuntu を追加でインストールしました。
前提
この記事は、Windows 上で WSL と Ubuntu を使える状態にするまでをまとめたものです。
想定している読者は以下です。
- Windows で WSL を使いたい
- スタートメニューに
wslはあるがUbuntuが見当たらない -
wsl -l -vを実行したら、ディストリビューションが入っていないと言われた - とりあえず Ubuntu が使える状態まで最短で進めたい
1. まず WSL の状態を確認する
最初に PowerShell を開いて、以下を実行します。
wsl -l -v
このコマンドで確認できることは以下です。
- インストール済みの Linux ディストリビューション一覧
- WSL 1 / WSL 2 のどちらで動いているか
私の環境では、最初に以下のように表示されました。
Linux 用 Windows サブシステムにインストールされているディストリビューションはありません。
この問題を解決するには、以下の手順に従ってディストリビューションをインストールしてください:
'wsl.exe --list --online' を使用して利用可能な配布を一覧表示する
および 'wsl.exe --install <Distro>' を使用してインストールしてください。
つまり、この時点では以下の状態でした。
- WSL 本体は使える
- ただし Ubuntu などの Linux ディストリビューションは未インストール
2. WSL をインストールする
まだ WSL 自体を入れていない場合は、管理者権限の PowerShell で以下を実行します。
wsl --install
これで、WSL に必要な機能の有効化と既定の Linux ディストリビューションのインストールが行われます。
環境によっては、このあと再起動が必要になります。
補足
すでに WSL が入っている環境では、wsl --install だけでは Ubuntu が入らず、追加でディストリビューションを指定してインストールする必要がある場合があります。今回はそのパターンでした。
3. Ubuntu をインストールする
3-1. インストール可能なディストリビューションを確認する
まずは、導入できるディストリビューション一覧を確認します。
wsl --list --online
実行すると、例えば以下のような候補が表示されます。
NAME FRIENDLY NAME
Ubuntu Ubuntu
Ubuntu-24.04 Ubuntu 24.04 LTS
Ubuntu-22.04 Ubuntu 22.04 LTS
Ubuntu-20.04 Ubuntu 20.04 LTS
...
3-2. Ubuntu をインストールする
今回は標準的に Ubuntu をそのまま指定しました。
wsl --install -d Ubuntu
実行後、私の環境では以下のように表示されました。
ダウンロードしています: Ubuntu
インストールしています: Ubuntu
ディストリビューションが正常にインストールされました。'wsl.exe -d Ubuntu' を使用して起動できます
Ubuntu を起動しています...
Provisioning the new WSL instance Ubuntu
この表示が出れば、Ubuntu のインストール自体は成功です。
補足
もし Ubuntu ではなく Ubuntu-24.04 のような名前で使いたい場合は、一覧に表示された名前をそのまま指定します。
wsl --install -d Ubuntu-24.04
4. Ubuntu を初回起動して Linux ユーザーを作成する
Ubuntu の初回起動時には、Linux 側のユーザー作成が必要です。
以下のような入力を求められます。
Enter new UNIX username:New password:Retype new password:
ここで作るアカウントは、Windows のユーザーとは別です。
注意点
- これは Ubuntu 用の Linux ユーザー
- Windows のログイン情報とは別物
- パスワード入力中は画面に何も表示されなくても正常
作成が終わると、Ubuntu のシェルが開きます。
5. Ubuntu を更新する
Ubuntu に入れたら、最初にパッケージを更新しておきます。
sudo apt update && sudo apt upgrade
必要に応じて、以下も確認しておくと安心です。
whoami
lsb_release -a
確認できること
-
whoami- いまログインしている Linux ユーザー名
-
lsb_release -a- Ubuntu のバージョン情報
6. wsl -l -v で最終確認する
最後に、PowerShell へ戻って以下を実行します。
wsl -l -v
期待する状態は以下です。
NAME STATE VERSION
* Ubuntu Running 2
確認ポイントは次の2つです。
-
Ubuntuが表示されている -
VERSIONが2になっている
ここまで確認できれば、WSL + Ubuntu の導入は基本完了です。
今後の起動方法
今後 Ubuntu を起動する方法は主に2つあります。
既定ディストリビューションを起動する
wsl
Ubuntu を明示して起動する
wsl -d Ubuntu
Ubuntu しか入っていないなら、通常は wsl だけで十分です。
詰まりやすいポイント
wsl はあるのに Ubuntu が見当たらない
この場合、WSL 本体は入っていても、Linux ディストリビューションが未インストールの可能性があります。
まずは以下で確認します。
wsl -l -v
Ubuntu がなければ、以下の流れで進めます。
wsl --list --online
wsl --install -d Ubuntu
wsl --install を実行しても思った動きにならない
すでに WSL が入っている環境だと、wsl --install だけでは期待した結果にならないことがあります。
その場合は、ディストリビューションを明示指定して入れるのが分かりやすいです。
wsl --install -d Ubuntu
初回セットアップ中に止まって見える
Provisioning the new WSL instance Ubuntu の表示中は、初回セットアップ処理が走っている状態です。
少し待ってから進みましょう。
また、パスワード入力時は何も表示されないので、固まったように見えても正常なことがあります。
0.0% で止まる場合
環境によっては、通常の導入で進まないことがあります。
その場合は以下のような回避策が使えるケースもあります。
wsl --install --web-download -d Ubuntu
まとめ
今回の流れを最短でまとめると、以下です。
まだ WSL を入れていない場合
wsl --install
WSL はあるが Ubuntu が入っていない場合
wsl -l -v
wsl --list --online
wsl --install -d Ubuntu
Ubuntu に入れたら最初にやること
sudo apt update && sudo apt upgrade
最後の確認
wsl -l -v
wsl はあるのに Ubuntu が見当たらない場合でも、まず wsl -l -v で状態確認をすると、原因を切り分けしやすいです。
参考
-
Microsoft Learn: WSL をインストールする
https://learn.microsoft.com/ja-jp/windows/wsl/install -
Microsoft Learn: WSL の基本コマンド
https://learn.microsoft.com/ja-jp/windows/wsl/basic-commands -
Microsoft Learn: WSL 開発環境をセットアップする
https://learn.microsoft.com/ja-jp/windows/wsl/setup/environment -
Microsoft Learn: WSL の手動インストール手順
https://learn.microsoft.com/en-us/windows/wsl/install-manual