배꼽파지 않도록 잘 개발해요

[Docker] 윈도우에서 도커 설치 후 로그인이 되지 않을 때 해결방법 본문

BackEnd/AWS / Docker / Git

[Docker] 윈도우에서 도커 설치 후 로그인이 되지 않을 때 해결방법

꼽파 2024. 8. 23. 15:00

Docker를 사용하기 위해 공식 웹사이트에서 올바르게 설치한다.

설치할 때는 우선 설치 파일을 다운 받고 관리자 권한으로 실행해야한다. 그렇지 않으면 에러가 날 수 있다.

 

https://docs.docker.com/engine/install/

 

Install Docker Engine

Learn how to choose the best method for you to install Docker Engine. This client-server application is available on Linux, Mac, Windows, and as a static binary.

docs.docker.com

 

설레는 마음으로 실행버튼을 클릭했을 때 아래 사진과 같이 'Group membership check'라는 에러가 떴다면 두 가지 원인이 있다.

  1. docker-users group에 사용자가 추가되지 않은 상태
  2. 로그아웃이 대기중인 상태


1. docker-users group에 사용자가 추가되지 않은 상태

Windows PowerShell을 열고 다음 명령을 실행한다.

Get-LocalGroup

 

 

docker-users만 바로 찾고 싶으면 다음과 같은 명령어를 사용하면 된다.

Get-LocalGroup | Where-Object { $_.Name -eq 'docker-users' }

 

Get-LocalGroup은 컴퓨터의 모든 로컬 그룹을 목록으로 가져온다.
이 목록은 파이프라인(|)을 통해 'Where-Object'에 전달된다.

  • | : 파이프라인 연산자, 왼쪽의 명령어(Get-LocalGroup)의 출력을 오른쪽 명령어(Where-Object)로 전달함.

{ $_.Name -eq 'docker-users' } 

  • $_ : 파이프라인에서 현재 객체를 나타냄.
  • $_ .Name : 현재 LocalGroup 객체의 Name 속성에 접근함.
  • -eq 'docker-users' : Name 속성이 'docker-users'와 같은지 비교함.


Where-Object는 각 그룹의 Name 속성이 docker-users와 일치하는지 검사한다.
만약 'docker-users'라는 이름의 그룹이 존재하면 해당 그룹이 출력된다. 존재하지 않으면 아무것도 출력되지 않는다.

 

Get-LocalGroup -Name 'docker-users'

  • -Name 파라미터(플래그) : 해당 파라미터 뒤에오는 이름을 가진 로컬 그룹만 반환함.

 

본인의 경우에는 이미 docker-users가 추가되어 있기 때문에 출력결과가 잘 나왔다.

만약 위를 입력하였을 때 아무것도 반환되지 않았다면 docker-users가 누락되었다는 것이다.

docker-users 그룹은 Get-LocalGroup에 기본적으로 존재하지 않는다. 도커가 설치되면 'docker-users' 로컬 그룹이 시스템에 추가된다. 이 그룹은 관리자가 아닌 사용자에게 docker와 관련된 권한을 부여하는 데 사용된다.

 

이 그룹에 Windows 계정을 추가해야하므로 다음과 같은 명령어를 입력하자.

 

net localgroup docker-users "당신의윈도우계정이름" /ADD

 

본인의 경우 이미 그룹에 계정이 추가되어 있어서 오류가 났다.

 

만약 본인의 Windows 계정 이름을 모르겠다면 다음과 같이 찾을 수 있다.
명령 프롬프트를 열고 다음 명령을 입력한다.

set user

USERNAME="당신의계정이름" 이므로 본인의 경우에는 airyt가 된다.

위 USERNAME을 여기 docker-users 뒤에 입력하면 된다.

net localgroup docker-users "당신의윈도우계정이름" /ADD

 

그럼 완료가 된다.


2. 로그아웃이 대기중인 상태

그냥 컴퓨터를 껐다 켜면 완료된다.

 

Docker 설치 후 로그아웃할지 묻는 메시지가 표시될 때 제대로 로그아웃하였으면 이런 오류가 발생하지 않는다.


출처

아래 영상을 참고하였다.

How to solve: you are not allowed to use Docker you must be in the "docker-users" group

https://youtu.be/kIpdpVbuBWA?feature=shared

 

 

 

728x90