[Env] WSL 기본 명령어 정리.

wsl 자체 관련 

wsl update or rollback (wsl 자체에 대한)

wsl --update # wsl version update

wsl --update rollback # 이전 버전으로

상태 확인 

wsl --status

Help

wsl --help

---

Distribution 실행 관련

wsl로 default distribution 실행하기

bash

• wsl -l 로 확인할 때 기본으로 설정된 distribution이 실행됨.
• 기본으로 설정된 distribution을 바꾸고 싶다면 "기본 distribution 변경"을 참조
• 여러 distribution을 설치한 경우, 다음처럼 실행할 distribution을 지정하여 시작함.

특정 distribution으로 지정하여 실행.

wsl --distribution <Distirbution_Name>

• <Distirbution_Name> 부분을 현재 장비에 설치된 distribution이름으로 변경.

특정 사용자로 실행

wsl -u <username>

• 수행될 user를 지정.
• -d option을 통해 실행할 distribution을 지정할 수 있음.

기본사용자 변경.

<DistributionName> config --defualt-user <Username>
ubuntu2004 config --default-user mmmil

• 위 명령어에서 mmmil 가 ubuntu20.04를 시작할 때 기본으로 사용되는 user로 지정됨.
• wsl의 특정 distribution을 export로 백업하고 이를 import한 경우 default user를 다시 지정해야함.

wsl -d <Distribution_Name> -u root 로 우선 실행후 /etc/wsl.conf 에 다음을 추가(또는 수정)하면 됨

[user]
default=원하는계정명

 단, "원하는계정명"이 시스템에 있는 계정이어야 함.

자세한 건 다음 url에서 복원 부분을 읽어볼 것:

2026.01.05 - [Linux] - WSL 배포판(distro) 백업 및 복원하기: export, import

WSL 배포판(distro) 백업 및 복원하기: export, import

---

기본 WSL 버전 설정

wsl --set-default-version <distribution> <1 or 2>

• 특정 distribution의 wsl 버전을 설정. (2를 권장함.)

shutdown

wsl --shutdown

• 이 명령은 메모리 사용 제한 변경 또는 .wslconfig 파일 변경처럼 WSL 2 가상 머신 환경을 다시 시작해야 하는 경우 필요.
• 모든 distribution이 종료.

종료 or 실행 중지

wsl --terminate <Distribution_Name>

• 지정한 distribution만 종료.

---

Distribution 관리 및 백업

설치가능한 distribution 보기 (online으로 제공되는 distribution 확인)

wsl -l -o

• -l : list
• -o : online

distribution 설치.

wsl.exe --install -d Ubuntu-22.04

• wsl -l -o 로 확인한 설치가능한 distribution 중 로컬에 설치원하는 것을 -d 옵션으로 지정.

기본 distribution 변경.

wsl --set-default Debian

• 설치된 distribution 중 Debian으로 default distribution을 변경.

설치된 distribution 보기 (local에 설치된 것들)

wsl -l -v

• -v : verbose
• --all : 모두 출력
• --quiet : distribution 이름만 출력
• --running : 실행중인 distribution만

distribution (배포판) 등록 취소 or 제거

wsl --unregister <DistributionName>

• 완전히 제거하는 것이라고 보면 됨.
• 주의: 등록이 취소되면 해당 배포와 관련된 모든 데이터, 설정 및 소프트웨어가 영구적으로 손실됨.

---

백업 및 복원

배포판 TAR로 백업

wsl --export <Distribution Name> <FileName>

백업 tar파일로 복원

wsl --import <Distribution Name> <InstallLocation> <FileName>

• 기본이 root로 로그인 됨.
• 이를 사용자 계정으로 변경하는 처리 필요.

2026.01.05 - [Linux] - WSL 배포판(distro) 백업 및 복원하기: export, import

WSL 배포판(distro) 백업 및 복원하기: export, import

---

같이 보면 좋은 자료들

2026.01.05 - [Linux] - WSL (WSL2 포함) 정리

WSL (WSL2 포함) 정리

---