본문으로 건너뛰기

원라인 설치 (product.kopens.io)

인터넷이 되는 서버라면 명령 한 줄로 설치가 시작됩니다. 설치 스크립트는 배포 서버 product.kopens.io 에서 받아옵니다.

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo bash

폐쇄망이라면 이 경로를 쓸 수 없습니다 → 설치 및 설정 의 오프라인 절차를 보세요.


시작하기 전에

확인할 것내용
권한root 로 실행해야 합니다 (sudo bash)
네트워크product.kopens.io · docker.kopens.io 에 HTTPS 접근 가능
하드웨어GPU 포함 요구사항 → 시스템 요구사항

⚠ AI 는 이 한 줄로 끝나지 않습니다

형제 저장소 두 개가 더 필요합니다

AI 스택의 compose 는 세 저장소가 나란히 있어야 동작합니다. 원라인 스크립트는 그중 하나만 받아옵니다.

  • plantpulse-ai-docker ← 원라인이 받아오는 것
  • plantpulse-ai-inference-server
  • plantpulse-timeseries-insight-server

뒤의 둘이 형제 디렉터리로 없으면, 설치 스크립트는 환경 파일 준비까지만 하고 기동을 거부합니다(START=1 을 줘도 마찬가지). 조용히 반쪽으로 뜨지 않게 막는 것이라 정상 동작입니다.

⇒ 두 저장소를 직접 준비한 뒤 설치를 다시 실행하세요.

Platform·Studio 와 달리 AI 는 CDN 에 tarball 을 게시하지 않습니다. 스크립트 두 개만 올라가 있고 본체는 저장소에서 받아옵니다. 사설 저장소라 인증이 필요할 수 있습니다 (아래 GIT_USER · GIT_TOKEN).


값을 지정해서 설치하기

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

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh \
| sudo START=1 DOCKER_PLATFORM_DB_HOST=192.168.0.41 bash

빈 값을 하나씩 물어보게 하려면 대화형으로 실행하세요.

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo INTERACTIVE=1 bash
환경 변수기본값용도
INTERACTIVE01 이면 빈 값을 프롬프트로 물어봅니다
START1 이면 설치 후 바로 기동합니다
DEST/opt/kopens/plantpulse-ai-docker설치 위치
BRANCHmaster받아올 브랜치
REPO_HOSTdev.kopens.io저장소 호스트
REPO_PATHplantpulse-ai/plantpulse-ai-docker.git저장소 경로
GIT_USER · GIT_TOKEN사설 저장소 인증

설치가 끝나면

  1. 초기 비밀번호 변경 — 관리 콘솔 계정을 정합니다. ADMIN_AUTH_PASSWORD 가 비어 있으면 콘솔이 아예 뜨지 않습니다.
  2. AI 관리 콘솔 에 접속해 홈에서 전체 상태를 확인합니다.
  3. 서비스 포트 맵 으로 방화벽을 정리합니다.

관련 문서