시스템 요구사항
하드웨어 요구사항
최소 사양
| 항목 | 사양 |
|---|---|
| CPU | 8코어 이상 |
| RAM | 32GB 이상 |
| 스토리지 | SSD 500GB 이상 |
| GPU | NVIDIA GPU (CUDA 지원) |
| 네트워크 | 1Gbps 이상 |
권장 사양
| 항목 | 사양 |
|---|---|
| CPU | 16코어 이상 |
| RAM | 64GB 이상 |
| 스토리지 | NVMe SSD 1TB 이상 |
| GPU | NVIDIA DGX Spark 또는 동급 |
| 네트워크 | 10Gbps |
PlantPulse AI는 NVIDIA DGX Spark 등 저사양 GPU 환경에서도 운영 가능하도록 최적화되어 있습니다.
소프트웨어 요구사항
| 항목 | 내용 |
|---|---|
| OS | Ubuntu 22.04 · RHEL / Rocky / Alma 8·9 · Amazon Linux 2 |
| 컨테이너 | Docker CE + compose v2 플러그인 — 설치기가 깝니다. 이미 있으면 그대로 씁니다 |
| GPU 드라이버 | NVIDIA 드라이버 + container toolkit — 설치기가 깝니다(SKIP_GPU=1 로 건너뜀). 드라이버를 새로 깔면 재부팅이 필요할 수 있습니다 |
모든 서비스가 컨테이너로 돕니다. 호스트에 필요한 것은 위 셋뿐입니다.
NVIDIA 장치가 없으면 설치기는 드라이버 단계를 건너뛰고, runtime: nvidia 를 쓰는 서비스(vLLM
생성 · 임베딩 · 재순위)는 뜨지 않는다고 경고합니다.
GPU 메모리 몫
vLLM 셋과 녹취 vLLM, 시계열 추론 서버가 같은 GPU 를 나눠 씁니다. 각자 가져갈 몫
(LLM_GPU_UTIL · EMB_GPU_UTIL · RERANK_GPU_UTIL · TS_GPU_UTIL · ASR_GPU_UTIL)의 합이 한계
PP_GPU_BUDGET_CEILING 을 넘으면 기동 전에 멈춥니다. 몫과 한계는 호스트 env 가 아니라
하드웨어 프로파일(compose/profiles/<모양>.env)에 있고, 호스트 env 의 PP_HW_PROFILE 이 그것을 고릅니다.
녹취(ASR_GPU_UTIL)는 기본으로 꺼져 있지만 켜는 날 넘지 않도록 합에 미리 넣습니다 — 영상 · 음성을 켜도(PI_MEDIA_ENABLED=true)
GPU 몫을 다시 계산할 일이 없습니다. 켜면 녹취 모델 Aura-ASR-Turbo 가 디스크를 약 1.6 GB 더 씁니다 → 영상 · 음성 수집
| 하드웨어 | 템플릿 · PP_HW_PROFILE | 몫의 합 (LLM + EMB + RERANK + TS + ASR) | 한계 |
|---|---|---|---|
| GB10 계열 (arm64, 통합 메모리) | env.gb10.example · gb10 | 0.4 + 0.10 + 0.08 + 0.13 + 0.03 = 0.74 | 0.75 |
| AWS g7e (amd64, 전용 VRAM) | env.g7e.example · g7e | 0.53 + 0.13 + 0.10 + 0.15 + 0.04 = 0.95 | 0.95 |
GB10 은 GPU 메모리가 시스템 RAM 과 같은 풀이라, 모델이 다 가져가면 OS 와 다른 서비스가 쓸 것이 없습니다. 자세한 것은 환경 변수 설정 에 있습니다.
네트워크 요구사항
PlantPulse AI는 다음 포트를 사용합니다. 방화벽 정책에서 해당 포트를 허용해야 합니다.
외부 접근 필요 포트
| 포트 | 서비스 | 설명 |
|---|---|---|
| 80 / 443 | AI Chat Web | 웹 채팅 인터페이스 (유일한 외부 노출) |
호스트에 함께 열리는 포트
프록시를 거치지 않고 LAN 에 그대로 열립니다. 사내망 밖에서 닿지 않도록 방화벽으로 막으십시오.
| 포트 | 서비스 |
|---|---|
| 4000 | LiteLLM — 모델 게이트웨이 (PI_LITELLM_PORT 로 변경) |
| 7115 | RAG 관문 |
| 8970 | 시계열 인사이트 |
| 5959 | 관리 콘솔 HTTP (PI_ADMIN_WEB_PORT 로 변경) |
| 5960 | 관리 콘솔 HTTPS — 프록시 경유 (PI_ADMIN_WEB_TLS_PORT 로 변경) |
| 7474 / 7687 | Neo4j 브라우저 · Bolt |
설치기는 방화벽을 열 때 compose 가 실제로 발행하는 포트를 읽으므로, 위 변수로 바꾼 값이 그대로 열립니다.
2026.09 까지의 9080 은 닫혔습니다. 북마크와 방화벽 규칙을 5959(HTTP) · 5960(HTTPS)으로 옮기십시오.
🔴 예전에 LightRAG 를 7114 로 직접 열었지만 지금은 rag-api(7115) 가 유일한 관문
이고 LightRAG 자체는 컨테이너 안에만 있습니다. 방화벽에 7114 를 열 필요가 없습니다.
문서 이해(7120) · 비전(7130) · vLLM(8000) · 임베딩(8003) · 리랭커(8004) · 녹취(영상 · 음성을 켠 설치) · docling(5001) · Qdrant(6333) · 시계열 추론(8980) · admin-api(9081) · 디지털 스레드(7140) 와 그 전용 Neo4j 는 호스트 포트를 발행하지 않습니다 (2026-08-21). Phoenix(6006) 도 2026.09 부터 발행하지 않습니다 — 인증이 없는 트레이스 UI 이기 때문입니다. 컨테이너끼리만 부르므로 방화벽 대상이 아닙니다.
PostgreSQL(5432) · Aster TSDB(9042) · Redis(6379) · RustFS(9000/9001) 은 플랫폼 것을 빌려 씁니다 — AI 서버가 아니라 플랫폼 서버에서 열려 있어야 합니다.
AI 컨테이너는 기동할 때 플랫폼 데이터레이크 관리 API(https://<플랫폼 호스트>:4950)에서 계정 · 비밀번호를
받습니다. AI 호스트에서 그 포트로 나갈 수 있어야 하고, AI 호스트 IP 가 플랫폼 허용목록에 있어야 합니다 →
설치 개요
포트 전체 지도와 확인 명령은 서비스 포트 맵 에 있습니다.
MCP·온톨로지 도구는 PlantPulse 플랫폼 server-web 통합 MCP(/api/v5/mcp)에서 제공됩니다 (구 MCP Server 50000·Ontology 8888 독립 서비스는 아카이브됨).
PlantPulse IIoT 서버 연동
PlantPulse AI는 PlantPulse IIoT 플랫폼의 실시간 데이터에 접근합니다. 다음 연결이 필요합니다:
| 항목 | 설명 |
|---|---|
| PlantPulse 서버 | IIoT 플랫폼 API 서버 (HTTPS) |
| Aster TSDB 클러스터 | 시계열 데이터 저장소 |
| PostgreSQL | PlantPulse 메타데이터 DB |
통합 MCP는 PlantPulse IIoT 서버에 대해 읽기 전용 접근만 수행합니다. 쓰기 작업은 지원하지 않습니다.