GitLab에서 사용자 비밀번호를 초기화(변경)하는 방법

GitLab에서 사용자 비밀번호를 초기화(변경)하는 방법은 관리자가 변경해주는 경우와 사용자 본인이 변경하는 경우 두 가지로 나뉩니다.

상황에 맞는 메뉴 경로를 확인하세요.


1. 관리자가 특정 사용자의 비밀번호를 강제 초기화할 때 (Admin)

관리자 계정(root 등)으로 로그인한 상태여야 합니다.

메뉴 경로:

  1. Admin Area (관리자 영역) 접속

    • 상단 메뉴 바(또는 사이드바)의 Menu > Admin (스패너 아이콘 🔧) 클릭

  2. Overview (개요) > Users (사용자)

    • 왼쪽 사이드바에서 Overview 선택 후 Users 클릭

  3. 사용자 선택

    • 비밀번호를 변경할 사용자를 검색하거나 목록에서 선택하여 클릭

  4. Edit (편집)

    • 사용자 상세 페이지 우측 상단의 Edit 버튼 클릭

  5. Password (비밀번호) 입력

    • 스크롤을 내려 Password 섹션을 찾음

    • Password와 Password confirmation 칸에 새 비밀번호 입력

  6. Save changes (변경사항 저장)

    • 페이지 하단의 Save changes 버튼 클릭


2. 로그인된 상태에서 본인이 비밀번호를 변경할 때 (User)

현재 비밀번호를 알고 있고, 로그인된 상태에서 변경하는 경로입니다.

메뉴 경로:

  1. 사용자 아바타 클릭

    • 화면 좌측 사이드바 하단(또는 우측 상단)의 프로필 아이콘 클릭

  2. Edit profile (프로필 편집) 클릭

  3. Password (비밀번호) 메뉴 선택

    • 설정 화면 왼쪽 사이드바 메뉴 중 Password 클릭

  4. 정보 입력 후 저장

    • Current password (현재 비번), New password (새 비번) 입력 후 Save password 클릭


3. (참고) 웹 UI 접속이 불가능할 때 (서버 CLI)

GitLab에서 사용자 비밀번호를 초기화(변경)하는 방법

비밀번호를 분실하여 관리자 계정으로도 접속이 안 되거나 서버 관리자인 경우, 터미널에서 초기화할 수 있습니다.

  1. 서버 터미널 접속

  2. GitLab Rails 콘솔 실행:

    Bash

    sudo gitlab-rails console -e production
  3. 사용자 찾기 및 비밀번호 변경 (예: root 계정):

    Ruby

    user = User.find_by_username('root')  # 또는 변경할 사용자 ID
    user.password = '새로운비밀번호123!'
    user.password_confirmation = '새로운비밀번호123!'
    user.save!
  4. true가 반환되면 변경 완료. exit로 종료.