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

설치 직후의 PlantPulse 는 모든 설치본이 똑같은 기본 계정을 갖고 있습니다. 이 값들은 소스에 적혀 있어 누구나 알 수 있습니다. 고객사에 인계하기 전에 반드시 전부 바꾸세요.

이 페이지는 바꿔야 하는 계정 전체 목록과 각각의 변경 경로를 한 곳에 모은 체크리스트입니다. 운영 중 정기 교체는 비밀번호 변경 (크리덴셜 회전) 을 보세요.

하나라도 남기면 그 하나가 문입니다

아래 계정은 서로 다른 화면·서로 다른 저장소를 씁니다. 웹 콘솔 비밀번호만 바꾸고 컨트롤 센터를 그대로 두면, 플랫폼 전체를 기동·정지할 수 있는 화면이 기본 비밀번호로 열려 있게 됩니다.

바꿔야 하는 것 — 전체 목록

#	계정	기본값	어디서 바꾸나
1	웹 콘솔 관리자	`admin` / `admin123!`	콘솔 화면 → 아래
2	컨트롤 센터(`:9700`)	`admin` / `admin123!`	환경 변수 → 아래
3	PlantPulse Dashboard(`:3000`)	`admin` / `admin`	PlantPulse Dashboard 화면 안에서 → 아래
4	Kestra(`:8380`)	`admin@plantpulse.io` / `Kopens123!`	환경 변수 → 아래
5	인프라 서비스 (DB·MQ·스토리지 등)	설치본마다 다름	`passwd.sh` → 아래

1~4 는 사람이 로그인하는 화면이라 여기서 다룹니다. 5 는 서비스끼리 쓰는 자격증명이라 회전 절차가 따로 있습니다.

1. 웹 콘솔 관리자

가장 먼저 바꿉니다. 화면 안에서 끝납니다.

admin / admin123! 으로 로그인합니다.
좌측 메뉴 System > 사용자 를 엽니다.
admin 행의 🔑 열쇠 아이콘(툴팁 "비밀번호 변경")을 클릭합니다.
현재 비밀번호(admin123!)와 새 비밀번호를 입력하고 저장합니다.

본인 계정은 현재 비밀번호가 필요합니다

남의 비밀번호를 바꿀 때는 ADMIN 권한만 있으면 되지만, 본인 계정은 현재 비밀번호를 함께 넣어야 합니다. 자세한 규칙과 REST API 사용법은 사용자 관리 — 비밀번호 변경 에 있습니다.

2. 컨트롤 센터 (`:9700`)

플랫폼 전체를 root 권한으로 기동·정지·제어하는 별도 웹 화면입니다. 웹 콘솔과 계정이 완전히 다르고, 콘솔에서 비밀번호를 바꿔도 여기는 그대로입니다.

환경 변수 두 개로 정합니다. 값을 주면 기본값 대신 그 값이 쓰입니다.

환경 변수	용도
`PP_CONTROL_USER`	로그인 사용자명
`PP_CONTROL_PASSWORD`	로그인 비밀번호

설정하지 않으면 모든 설치에서 동일한 개발용 기본 계정으로 로그인됩니다. 자세한 적용 절차는 크리덴셜 회전 — 컨트롤 센터 를 보세요.

9700 을 외부에 열지 마세요

비밀번호를 바꿨더라도 이 포트는 운영자 대역에서만 닿게 방화벽으로 막는 것이 원칙입니다 → 포트 구성.

3. PlantPulse Dashboard (`:3000`)

시계열 시각화 대시보드입니다. 기본 계정은 PlantPulse Dashboard 내장 기본값 admin / admin 입니다.

환경 변수로 바꿀 수 없습니다

🔴 PP_GRAFANA_ADMIN_USER · PP_GRAFANA_ADMIN_PASSWORD 라는 변수는 없습니다. PlantPulse Dashboard 의 관리자 계정은 PlantPulse Dashboard 자신의 저장소에 살고, 설정 파일의 값은 저장소에 사용자가 하나도 없을 때만 참고됩니다 — 한 번 생긴 뒤에는 저장소가 이기고 그 사실을 알려 주는 오류도 없습니다. 그래서 아예 적지 않습니다(2026-09-08 결정).

바꾸는 자리는 둘입니다.

방법	언제
PlantPulse Dashboard 화면 → 프로필 → Change password	평소
`dashboard-cli --homepath <dashboard> admin reset-admin-password --password-from-stdin`	로그인이 안 될 때

함께 넣어야 하는 값 — `PP_GRAFANA_DB_PASSWORD`

2026-09-08 부터 PlantPulse Dashboard 의 저장소가 PostgreSQL 입니다(대시보드 · 데이터소스 · 사용자 · 알림 규칙). 그 접속 정보가 필요합니다.

환경 변수	기본값
`PP_GRAFANA_DB_USER`	`grafana` (고정 — 스키마가 이 이름으로 역할을 만듭니다)
🔑 `PP_GRAFANA_DB_PASSWORD`	없음 — 기동 필수

🔴 비어 있으면 pd start 가 exit 3 으로 멈춥니다. 호스트의 시크릿 사이드카 (/etc/kopens/plantpulse-platform.env)에 적고 bin/restart.sh 로 재기동합니다.

4. Kestra (`:8380`)

워크플로우 엔진입니다. 기본 계정은 admin@plantpulse.io / Kopens123! 입니다.

환경 변수	기본값
`PP_KESTRA_ADMIN_EMAIL`	`admin@plantpulse.io`
`PP_KESTRA_ADMIN_PASSWORD`	`Kopens123!`

예전에 여기 있던 「바꾸면 아카이브가 멈춘다」 경고는 걷었습니다

2026-09-04 이전에는 웨어하우스가 Kestra 에 HTTP 로 붙었고 기동 스크립트가 그 계정을 하드코딩하고 있어서, Kestra 비밀번호를 바꾸면 S3 아카이브가 조용히 멈췄습니다.

지금은 그 경로가 없습니다. 아카이브·최적화는 Temporal 워커가 돌립니다 (PP-S3-ARCHIVER-DAILY 매일 01:30 · PP-S3-OPTIMIZER-WEEKLY 일요일 04:00). 웨어하우스는 Kestra 자격증명을 읽지도, 갖고 있지도 않습니다.

⇒ Kestra 비밀번호는 마음 놓고 바꾸십시오. 아카이브에 영향이 없습니다.

5. 인프라 계정과 API 키

데이터베이스·메시징·스토리지처럼 서비스끼리 쓰는 자격증명입니다. 사람이 로그인하지 않지만, 기본값 그대로면 사내망 안에서 누구나 데이터에 닿을 수 있습니다.

bin/passwd.sh 가 앞문입니다. 레지스트리에 등록된 변수만 회전할 수 있고, 등록되지 않은 값을 주면 조용히 빠뜨리지 않고 거부합니다.

cd /opt/kopens/plantpulse-platform-docker

bin/passwd.sh --list                 # 무엇을 바꿀 수 있는지 (현재값은 마스킹)
bin/passwd.sh --list --show          # 현재값을 그대로 보기
bin/passwd.sh PP_PG_PASSWORD         # 값은 프롬프트로 입력 (argv·셸 히스토리에 남지 않습니다)
bin/passwd.sh PP_PG_PASSWORD=... PP_S3_PASSWORD=...   # 여러 개를 한 번에 → 재시작 1회
bin/passwd.sh --dry-run PP_MQ_PASSWORD                   # 계획만 출력

커미셔닝 시점에 등록된 값 전부를 무작위로 돌리려면 회전 엔진을 직접 부릅니다. --all 은 passwd.sh 가 아니라 rotate-secret.sh 의 옵션입니다.

bin/rotate-secret.sh --dry-run --all --generate   # 계획 확인
bin/rotate-secret.sh --all --generate             # 실행

환경 변수	대상
`PP_PG_PASSWORD`	PostgreSQL `plantpulse`
`PP_TEMPORAL_PASSWORD`	PostgreSQL `temporal`
`PP_HIVE_PASSWORD`	PostgreSQL `hive`
`PP_CASSANDRA_PASSWORD`	Aster TSDB
`PP_REDIS_PASSWORD`	Valkey (Redis)
`PP_S3_PASSWORD`	RustFS
`PP_MQ_PASSWORD`	Kafka · HiveMQ (두 서비스가 한 값을 공유합니다)
`PP_CEP_API_KEY`	CEP API
`PP_DATA_GATEWAY_API_KEY`	데이터 게이트웨이 API

이 9개로 끝이 아닙니다

PP_API_KEY · PP_FLOW_WEBHOOK_API_KEY · PP_SPARK_PASSWORD · PP_OPCUA_PASSWORD TLS keystore/truststore 비밀번호는 아직 레지스트리에 없어 스크립트가 거부합니다. 등록되지 않은 키를 주면 조용히 빠뜨리지 않고 «레지스트리에 없는 변수» 로 거부합니다. 전부 크리덴셜 회전 — 수동 절차 를 따르세요.

순서를 지키세요

서버측 계정을 바꾸고 보관소를 갱신하지 않으면 다음 재시작에서 플랫폼이 뜨지 않습니다. passwd.sh 는 이 순서를 대신 밟아 주지만, 수동으로 할 때는 왜 순서가 중요한가 를 먼저 읽으세요.

바꾼 뒤 확인

각 화면에 기본 비밀번호로 로그인이 안 되는지 직접 확인하세요. "바꿨다고 생각했는데 설정 파일이 안 읽혔다" 가 가장 흔한 실패입니다.

확인할 것	방법
웹 콘솔	로그아웃 후 `admin123!` 로 로그인 시도 → 실패해야 정상
PlantPulse Dashboard	`:3000` 에서 `admin` / `admin` 로그인 시도 → 실패해야 정상
Kestra	`:8380` 에서 `Kopens123!` 로그인 시도 → 실패해야 정상
S3 아카이브	Kestra 를 바꿨다면 다음 스케줄 실행이 성공했는지 확인

인계 문서에 남기세요

바꾼 계정 목록과 누가 새 비밀번호를 보관하는지를 인계 문서에 적으세요. 값 자체를 적지는 마세요.

바꿔야 하는 것 — 전체 목록​

1. 웹 콘솔 관리자​

2. 컨트롤 센터 (:9700)​

3. PlantPulse Dashboard (:3000)​

함께 넣어야 하는 값 — PP_GRAFANA_DB_PASSWORD​

4. Kestra (:8380)​

5. 인프라 계정과 API 키​

바꾼 뒤 확인​

관련 문서​