원라인 설치 (product.kopens.io)
인터넷이 되는 서버라면 명령 한 줄로 설치가 시작됩니다.
curl -fsSL https://product.kopens.io/plantpulse-studio/install.sh | sudo bash
폐쇄망이라면 에어갭 설치 를 보세요.
시작하기 전에
| 확인할 것 | 내용 |
|---|---|
| 권한 | root 로 실행해야 합니다 (sudo bash) |
| 네트워크 | product.kopens.io · docker.kopens.io 에 HTTPS 접근 가능 |
| 준비할 값 | 플랫폼 주소, 데이터 저장 경로 — 아래 참조 |
스크립트가 하는 일
- root 인지 확인합니다
git이 없으면 설치합니다(dnf/apt)- 번들 tarball 을 먼저 시도하고(인증 불필요), 실패하면 저장소에서 clone 합니다
- 설치 스크립트를 이어서 실행합니다
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
| 환경 변수 | 기본값 | 용도 |
|---|---|---|
INTERACTIVE | 0 | 1 이면 빈 값을 프롬프트로 물어봅니다 |
PLATFORM_API_TARGET | — | 플랫폼 API 주소 (실데이터·인증 위임) |
DATA_ROOT | /var/lib/pp-studio | 워크스페이스·빌드·DB 데이터 저장 위치 |
DEST | /opt/kopens/plantpulse-studio-docker | 설치 위치 |
BRANCH | main | 저장소에서 받을 때의 브랜치 |
GIT_USER · GIT_TOKEN | — | tarball 이 실패해 clone 으로 넘어갈 때의 인증 |
전체 변수 목록은 환경 변수 레퍼런스 에 있습니다.
설치가 끝나면
- 초기 비밀번호 변경 —
admin/admin123!을 바꿉니다. - 시작하기 — 첫 로그인과 화면 구성.
- 도메인으로 서비스한다면 → 도메인과 리버스 프록시.
관련 문서
- 설치 — 전체 절차와 값 채우기
- 에어갭 설치 — 폐쇄망
- 환경 변수 레퍼런스