본문으로 건너뛰기

WSL (Windows Subsystem for Linux) 설치

미꾸라지를 윈도우 WSL 환경에서 실행하기 위해서는, 우선 WSL (Windows Subsystem for Linux) 을 설치하여야 합니다.

WSL 설치 방법

WSL 설치를 위한 방법은 여러 블로그 및 글들이 인터넷에 존재합니다. 쉽게 설명된 많은 글들이 있으니 해당 글들을 참고 바랍니다. 참고 될만한 글들은 아래의 링크가 있습니다.

주의사항

Ubuntu 기반의 리눅스 배포판을 설치해 주세요. Ubuntu 20.04 LTS 가 현재 추천 버전입니다.

WSL interop 기능 활성화

미꾸라지 WSL 지원 기능이 제대로 동작하기 위해서는 반드시 interop 기능이 활성화되어 있어야 합니다.

WSL 를 실행한 환경에서 /etc/wsl.conf 파일에 [interop] 섹션이 있는지를 꼭 확인하시기 바랍니다. 제대로 설정되어 있다면 보통 아래와 같은 모습니다.

$ cat /etc/wsl.conf
[boot]
systemd=true

[interop]
enabled=true

만약 없다면 해당 섹션을 넣어 주셔야 합니다.

$ echo "[interop]" >> /etc/wsl.conf
$ echo "enabled=true" >> /etc/wsl.conf

WSL 체크 리스트

WSL 설치 및 세팅이 되었다면 아래의 항목들을 한번 더 체크해보시기 바랍니다.

  1. WSL 설치가 제대로 되었는가.
  2. Ubuntu 기반 리눅스를 설치하였는가. Ubuntu 20.04 LTS 가 현재 미꾸라지가 추천하는 배포판입니다. 비록 다른 버전도 상관없습니다.
  3. /etc/wsl.conf[interop] 섹션이 제대로 되어 있는가.