본문으로 건너뛰기

초기 비밀번호 변경 (커미셔닝 필수)

설치를 마치면 스튜디오에 부트스트랩 관리자 계정 하나가 만들어져 있습니다. 모든 설치본이 같은 값이므로, 현장에 인계하기 전에 반드시 바꾸세요.

항목값
아이디admin
비밀번호admin123!
사용자 테이블이 비어 있을 때만 만들어집니다

이 계정은 첫 기동에서 사용자가 하나도 없을 때만 시드됩니다. 이미 계정을 만들어 쓰고 있는 설치본에는 새로 생기지 않습니다. 그래서 재기동한다고 기본 비밀번호가 되살아나지는 않습니다.

바꾸는 법 — 화면에서​

가장 쉬운 경로입니다. 스튜디오에 로그인한 뒤:

  1. 좌측 아래 톱니바퀴 환경설정 → 사용자 관리 를 엽니다.
  2. admin 계정의 비밀번호를 재설정합니다.

운영자가 여럿이라면 이 김에 사람마다 계정을 따로 만들고 공용 admin 은 관리자만 쓰도록 두세요.

서버에서는 바꿀 수 없습니다​

스튜디오 관리자 계정은 앱이 관리합니다. 서버 쪽에 재설정 경로가 없습니다.

.env 를 고쳐도 아무 일도 일어나지 않습니다

서버는 로그인할 때 ①데이터베이스 → ②환경변수 순으로 봅니다. DB 에 계정이 잡히면 거기서 끝나므로, .env 의 값을 고쳐 봐야 죽은 값입니다. 바뀌지 않았는데 바꿨다고 믿게 되는 자리라 특히 조심하세요.

bin/passwd.sh 의 대상이 아닙니다

passwd.sh 가 관리하는 것은 DB 계정과 API 키입니다. 앱 로그인 계정은 목록에 없고, 넘기면 오타와 똑같이 거부됩니다 → 비밀번호 · API 키 변경.

⇒ 관리자 비밀번호를 잃어버렸다면 다른 관리자 계정으로 로그인해 재설정해야 합니다. 관리자가 한 명뿐인 설치에서 그 계정을 잃으면 복구가 어려우므로, 커미셔닝 때 관리자 계정을 둘 이상 만들어 두시길 권합니다.

인프라 계정과 API 키​

앱 로그인 계정과 달리, DB 계정과 API 키는 bin/passwd.sh 가 바꿉니다.

cd /opt/kopens/plantpulse-studio/bin

./passwd.sh --list          # 무엇을 바꿀 수 있는지 (현재값은 마스킹)
./passwd.sh --list --show   # 현재값 전체
./passwd.sh PG_PASSWORD     # 값은 프롬프트로 입력
키무엇어디에
PG_PASSWORD번들 PostgreSQL (PG_USER 계정)DB 계정 자체를 ALTER ROLE 로 변경
ANTHROPIC_API_KEYAnthropic 키.env — agent-server 기동 시 로드
AI_API_KEYOpenAI 호환 키.env — agent-server 기동 시 로드
값을 명령줄에 붙이지 마세요

ps 출력과 셸 히스토리에 남습니다. 값을 생략하고 프롬프트로 입력하는 것이 권장 경로입니다.

플랫폼의 PP_* 는 여기 목록에 없습니다

스튜디오가 소유한 것만 나옵니다. 플랫폼 비밀번호는 스튜디오의 것이 아니므로 넘기면 오타와 똑같이 거부됩니다 — 플랫폼 크리덴셜 회전 에서 바꾸세요.

함께 점검할 것​

스튜디오는 비밀번호 말고도 키를 여럿 씁니다. 커미셔닝 때 한 번에 훑으세요.

대상어디에
플랫폼 · AI · Git · 레지스트리 키비밀 관리
키 회전 절차 (bin/passwd.sh)비밀번호 · API 키 변경
PostgreSQL 비밀번호설치 — 처음 정한 값을 유지해야 합니다

확인​

로그아웃한 뒤 admin123! 로 로그인이 안 되는지 확인하세요. 된다면 바뀌지 않은 것입니다.

관련 문서​