본문으로 건너뛰기

원라인 설치 (권장)

인터넷이 되는 서버라면 명령 한 줄로 설치가 시작됩니다.

curl -fsSL https://product.kopens.io/plantpulse-studio/install.sh | sudo bash
⌨️ Studio 원라인 설치 — 스테이징 서버에서 실제로 녹화했습니다

폐쇄망이라면 폐쇄망 설치 를 보세요.

시작하기 전에​

확인할 것내용
권한root 로 실행해야 합니다 (sudo bash)
네트워크product.kopens.io · docker.kopens.io 에 HTTPS 접근 가능
준비할 값플랫폼 주소, 데이터 저장 경로 — 아래 참조

스크립트가 하는 일​

  1. root 인지 확인합니다
  2. git 이 없으면 설치합니다(dnf / apt)
  3. 번들 tarball 을 먼저 시도하고(인증 불필요), 실패하면 저장소에서 clone 합니다
  4. 설치 스크립트를 이어서 실행합니다
Studio 는 tarball 경로가 기본입니다

CDN 에 번들이 올라가 있어 저장소 인증 없이 받아집니다. 사내 방화벽이 저장소 접근을 막고 있어도 설치가 진행됩니다.

값을 지정해서 설치하기​

환경 변수는 bash 앞에 둡니다. curl 앞에 두면 파이프를 타고 넘어가지 않습니다.

curl -fsSL https://product.kopens.io/plantpulse-studio/install.sh \
  | sudo PLATFORM_API_TARGET=https://192.168.0.41 DATA_ROOT=/data1/pp-studio bash

빈 값을 하나씩 물어보게 하려면 대화형으로 실행하세요. 처음 설치할 때 권장합니다.

curl -fsSL https://product.kopens.io/plantpulse-studio/install.sh | sudo INTERACTIVE=1 bash
환경 변수기본값용도
INTERACTIVE01 이면 빈 값을 프롬프트로 물어봅니다
PLATFORM_API_TARGET—플랫폼 API 주소 (실데이터·인증 위임)
DATA_ROOT/var/lib/pp-studio워크스페이스·빌드·DB 데이터 저장 위치
DEST/opt/kopens/plantpulse-studio-docker설치 위치
BRANCHmain저장소에서 받을 때의 브랜치
GIT_USER · GIT_TOKEN—tarball 이 실패해 clone 으로 넘어갈 때의 인증

전체 변수 목록은 환경 변수 레퍼런스 에 있습니다.

설치가 끝나면​

  1. 초기 비밀번호 변경 — admin / admin123! 을 바꿉니다.
  2. 시작하기 — 첫 로그인과 화면 구성.
  3. 도메인으로 서비스한다면 → 도메인과 리버스 프록시.

관련 문서​