WSLでDockerの環境構築しようとしたらハマるポイント3選
はじめに
WSLでDockerの環境構築しようとしたらハマるポイントをまとめました。どんなエラー文が出て、どうやって問題を切り分けて解決するかも記載したので、これからWSLでDockerの環境構築しようとする方は必読です。
tl;dv
クソでかい問題としてRancher DesktopのkubeconfigとWSLのdockerのとで競合していた。(自分の場合)

環境
- Windows 11
- WSL2 上の Ubuntu 24.04
- Rancher Desktop
コンテナエンジンは dockerd (moby) を利用
その1:パーミッションの問題
ワイ「なんやこのエラー」
ワイ「/var/run/docker.sockにパーミッションの問題でアクセスできてない、、、?」
docker compose up -d
unable to get image 'postgres:15.0-alpine': permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.51/images/postgres:15.0-alpine/json": dial unix /var/run/docker.sock: connect: permission denied
ワイ「ほんまや、/var/run/docker.sockはrootかdockerグループのユーザしかアクセスできないよ設定になっとる」
ls -l /var/run/docker.sock
id
srw-rw---- 1 root docker 0 Nov 25 19:51 /var/run/docker.sock
uid=1000(ninkanman) gid=1000(ninkanman) groups=1000(ninkanman),4(adm),...,107(netdev)
ワイ「こんなんdockerのグループを作ってあげて、、、」
sudo groupadd docker 2>/dev/null || true
ワイ 「自分を docker グループに追加すれば終わりや!」
sudo usermod -aG docker $USER
その2:kubeconfigそのものの競合
ワイ「権限周り直してあげたらそもそもアクセスできないって出てきたで」
ワイ「しかもRauncher Desktop側に変なエラーでとる」
docker ps
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
さらに Rancher Desktop 側の UI では、WSL Integration の画面に次のようなエラーが表示されていた。
Error managing distribution Ubuntu-24.04: kubeconfig: C:\WINDOWS\system32\wsl.exe exited with code 1
Rancher Desktop cannot automatically convert the provided kubeconfig file to a symlink due to existing configurations within that file. To resolve this issue, you will need to manually create the symlink to ensure existing configurations are preserved and to prevent any loss of configuration.
Rauncher Desktop「Rancher Desktop は、提供された kubeconfig ファイル内に既存の設定が含まれているため、シンボリックリンクへの自動変換ができません。この問題を解決するには、既存の設定が保持され、設定の損失を防ぐために、シンボリックリンクを手動で作成する必要があります。」
ワイ「既存のkubeconfigと競合してる?なんやねんそれ」
ワイ「WSLのUbuntuのdocker.serviceとRauncher DesktopのDockerでごちゃごちゃになってるんかな」
ワイ「WSL内で docker.service の状態を確認するか」
sudo systemctl status docker
× docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
Drop-In: /etc/systemd/system/docker.service.d
└─http-proxy.conf
Active: failed (Result: exit-code) ...
...
Failed to start docker.service - Docker Application Container Engine.
WSL の Ubuntu にも Docker Engine を入れていたため、systemd 管理の docker.service が存在していたが、これは失敗している。
一方で、実際に使いたいのは Rancher Desktop 側の dockerdなので、WSL 内の docker.serviceを以下のように無効化した。
ワイ「これで完璧や!」
sudo systemctl disable --now docker.service docker.socket
ワイ「よし、Rauncher Desktopを再起動して確認するで〜」
ワイ「あかんやん」
Error managing distribution Ubuntu-24.04: kubeconfig: C:\WINDOWS\system32\wsl.exe exited with code 1
Rancher Desktop cannot automatically convert the provided kubeconfig file to a symlink due to existing configurations within that file. To resolve this issue, you will need to manually create the symlink to ensure existing configurations are preserved and to prevent any loss of configuration.
このあたりの設定を揃えても、まだ WSL側からはdockerに繋がらない状態だった。
その3:kubeconfigを作り直させる!
エラーメッセージを見ると、Rancher DesktopがWSL連携の中でkubeconfigをsymlinkに変換しようとして、既存設定が邪魔して失敗していることがわかる。
つまりUbuntu側のkubeconfigに何かしらの既存設定が入っていて、それをどう扱うか判断できず変換処理が止まっている構図になっている。
ワイ「なるほど…既存のkubeconfigがあるせいでRancher Desktopがシンボリックリンクにできずにコケとるんやな」
ワイ「ほなkubeconfigをいったん退避して、Rancher Desktopに作り直させればええやろ」
そこで、WSL の kubeconfig をいったん退避して空にした。
まず kubeconfig避難所を用意する。
mkdir -p ~/.kube
ワイ「念のためバックアップ取っとこ。戻せんと詰むしな」
if [ -f ~/.kube/config ]; then
cp ~/.kube/config ~/.kube/config.bak-$(date +%Y%m%d-%H%M)
fi
if [ -f ~/.kube/.config ]; then
cp ~/.kube/.config ~/.kube/dot-config.bak-$(date +%Y%m%d-%H%M)
fi
ワイ「よし、いったんまっさらにするで」
rm -f ~/.kube/config ~/.kube/.config
その後、WSL を完全に落としてから Rancher Desktop を再起動する。
WSL ではなく PowerShell で以下を実行。
wsl --shutdown
Rancher Desktop を一度 Quit
Rancher Desktop を起動
その後 WSL (Ubuntu) を起動
ワイ「さて、これで WSL 側から docker が繋がるようになったか確認や。docker ps 叩くで」
docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
ワイ「空でもええ。エラーが出てないのが大事や」
結論
docker.serviceとRancher Desktopが競合する環境をまず作るなというハナシ。
知らぬ間に競合する環境を作る可能性がある人はご参考までに!
Discussion