본문으로 건너뛰기
PromptQuorum인간을 위해 설계. AI를 위해 구조화.
홈/고급 로컬 LLM
Local AI Agents & Tool Use

Self-Hosted AI Starter Kit 리뷰: 하나의 Compose 파일로 만나는 n8n + Ollama + Qdrant

·12분 읽기Hans Kuepper 저 · PromptQuorum 창립자 · 오픈 웨이트·오픈소스 AI 디스커버리 엔진

경고: Self-hosted AI Starter Kit는 2026년 7월 23일 이후 업데이트가 없어 유지보수되지 않을 수 있습니다. n8n이 제공하는 무료 Docker Compose 템플릿으로, n8n, Ollama, Qdrant, PostgreSQL을 로컬 AI 스택 하나로 묶어 docker compose 명령 하나로 시작합니다.

핵심 요점

  • Docker Compose 템플릿이며 독립 애플리케이션이 아님 — 새로운 자체 코드를 배포하는 대신 기존 네 가지 오픈소스 도구를 서로 연결함
  • n8n(워크플로 자동화, 400개 이상의 통합), Ollama(로컬 LLM 추론), Qdrant(벡터 데이터베이스), PostgreSQL(데이터 저장)을 번들
  • Apache-2.0 라이선스로 무료이며 계정이나 API 키가 필요 없음
  • CPU 전용, Nvidia GPU, AMD GPU(Linux) 모델 추론을 위한 별도의 Docker Compose 프로필 제공
  • 데모 워크플로 하나(Chat Trigger, Basic LLM Chain, Ollama llama3.2)를 불러오고 n8n에 Ollama와 Qdrant 자격 증명을 만들어 둡니다. 데모는 Qdrant를 사용하지 않으므로 RAG 파이프라인은 직접 구축해야 합니다
  • GitHub 저장소의 스타는 15,000+이며 릴리스나 태그는 게시하지 않습니다
  • n8n 플랫폼 자체를 만든 로우코드 워크플로 자동화 기업인 n8n이 큐레이션하고 유지관리
  • n8n 문서는 이 키트를 '테스트 전용'이며 프로덕션에 완전히 최적화되지 않았다고 설명합니다. 프로덕션에서 사용하기 전에 보안을 강화하세요

📍 한 문장으로

Self-hosted AI Starter Kit는 n8n이 제공하는 무료의 Apache-2.0 라이선스 Docker Compose 템플릿으로, n8n, Ollama, Qdrant, PostgreSQL을 하나의 명령으로 묶어 클라우드 의존 없는 로컬 AI 워크플로를 구축할 수 있게 합니다.

💬 쉽게 말하면

워크플로 도구, 로컬 모델 실행기, 벡터 데이터베이스를 따로 설치해 직접 연결하는 대신, 이 키트는 네 가지를 서로 통신하도록 미리 구성해 제공합니다. docker-compose 명령 하나로 데모 채팅 워크플로가 이미 불러와진 로컬 AI 자동화 환경을 얻을 수 있으며, Qdrant 기반 RAG 파이프라인은 직접 구축해야 합니다.

⚠️경고: 2026년 7월 23일 이후 업데이트가 없습니다. 프로젝트가 유지보수되지 않을 수 있습니다. compose 파일 자체의 마지막 변경은 2026년 1월 6일이며, 이미지 네 개 중 세 개는 latest로 받아옵니다. 의존하기 전에 스택이 여전히 시작되는지 확인하세요.

Self-hosted AI Starter Kit(github.com/n8n-io/self-hosted-ai-starter-kit)는 n8n이 큐레이션한 오픈소스 Docker Compose 템플릿으로, n8n의 워크플로 자동화 플랫폼과 로컬 모델 추론용 Ollama, 벡터 데이터베이스인 Qdrant, 그리고 PostgreSQL을 하나의 docker compose up 명령으로 묶어 제공합니다. 이는 독립된 애플리케이션이 아니라, 클라우드 의존 없이 로컬 AI 에이전트, RAG 파이프라인, 자동화 워크플로를 구축하기 위해 미리 연결해 둔 출발점입니다. 이 리뷰에서는 실제로 무엇을 번들로 포함하는지, 어떻게 설치하는지, 그리고 이 도구들을 개별적으로 운영하는 것과 어떻게 비교되는지를 다룹니다.

n8n Self-Hosted AI Starter Kit란 무엇인가?

Self-hosted AI Starter Kit는 새로운 소프트웨어가 아니라 Docker Compose 템플릿입니다 — 자체 GitHub 설명에서도 이를 "포괄적인 로컬 AI 및 로우코드 개발 환경을 신속하게 초기화"하는 데 도움을 주는 "개방형 docker compose 템플릿"이라고 부릅니다. 개별적으로 유지관리되는 4개의 오픈소스 프로젝트(n8n, Ollama, Qdrant, PostgreSQL)를 미리 연결된 하나의 구성으로 결합하여, 각 요소를 직접 설치하고 네트워크로 연결하지 않아도 동작하는 로컬 AI 스택을 얻을 수 있습니다.

  • 핵심 기능: n8n, Ollama, Qdrant, PostgreSQL을 함께 시작하고 서로 통신할 수 있도록 사전 네트워킹하는 docker-compose.yml 및 관련 설정 파일
  • n8n: 400개 이상의 통합과 에이전트 및 자동화 구축을 위한 전용 AI/LangChain 노드를 갖춘 로우코드 워크플로 자동화 플랫폼
  • Ollama: 오픈 웨이트 언어 모델을 로컬에서 실행하며, n8n 워크플로에 모델 제공자로 노출됨
  • Qdrant: RAG 방식 워크플로에서 임베딩을 저장하고 검색하는 데 사용되는 오픈소스 벡터 데이터베이스
  • PostgreSQL: n8n 자체의 워크플로와 자격 증명 저장을 뒷받침하는 관계형 데이터베이스
  • 유지관리자: n8n 워크플로 자동화 플랫폼을 만든 기업 n8n
  • 정식 저장소: github.com/n8n-io/self-hosted-ai-starter-kit — 이 리뷰에서 사용한 설치 절차와 버전 이력의 출처

스타터 키트의 프로젝트 이력과 최근 변경 사항

이 키트에는 버전이 매겨진 릴리스가 없으며, 커밋 로그가 유일한 변경 이력입니다. GitHub 저장소는 릴리스나 태그를 게시하지 않으므로, 아래 기본 브랜치의 날짜가 표시된 커밋이 확인할 수 있는 전부입니다.

  1. 1
    네 가지 서비스의 기본 구성
    Why it matters: compose 파일은 n8n, Ollama, Qdrant, PostgreSQL을 연결하고, 첫 시작 시 데모 워크플로와 미리 만든 자격 증명 두 개('Local Ollama service', 'Local QdrantApi database')를 가져오며, `llama3.2` 모델을 자동으로 받아옵니다.
  2. 2
    GPU Compose 프로필
    Why it matters: 기본 `cpu` 프로필 외에 `gpu-nvidia`와 `gpu-amd` 프로필이 따로 있어, Ollama가 모든 모델을 CPU로 실행하는 대신 지원되는 GPU를 사용할 수 있습니다.
  3. 3
    2025년 9월 1일 — 데모 워크플로 업데이트
    Why it matters: 커밋 메시지는 'Use latest version of Basic LLM Chain, to avoid fallback model issues'입니다.
  4. 4
    2026년 1월 6일 — compose 파일의 마지막 변경
    Why it matters: 커밋 'Skip demo import if workflows already exist'는 `docker-compose.yml`을 수정하여, 재시작할 때 이미 워크플로가 있는 n8n 인스턴스에 데모를 다시 가져오지 않도록 했습니다.
  5. 5
    2026년 7월 23일 — 기본 브랜치의 최신 커밋
    Why it matters: 커밋 'Fixed broken link in the readme. No significant changes'는 `README.md`만 변경했습니다.

Starter Kit로 무엇을 할 수 있는가?

스타터 키트의 가치는 자체적인 새로운 기능이 아니라 번들된 서비스들이 함께 수행하는 작업에 있습니다. 공식 GitHub README에 따라 각 부분이 실제로 하는 일을 살펴보겠습니다.

  • 로컬 API 서버 — 번들된 각 n8n 인스턴스는 n8n 자체의 REST API를 제공하므로, n8n UI뿐 아니라 다른 로컬 서비스에서도 워크플로를 프로그래밍 방식으로 트리거하거나 관리할 수 있음
  • 로컬 워크플로 자동화 — n8n의 비주얼 에디터에서 400개 이상의 통합과 에이전트 구축용 전용 AI/LangChain 노드를 활용해 자동화를 구축하고 실행
  • 로컬 LLM 추론 — Ollama가 오픈 웨이트 모델(Llama, Qwen, Gemma 등)을 로컬에서 실행하며, 외부 API 키 없이 n8n 워크플로의 모델 제공자로 사용할 수 있습니다. compose 파일은 첫 시작 시 llama3.2를 자동으로 받아옵니다
  • RAG용 로컬 벡터 저장소 — Qdrant가 임베딩을 저장하고 검색하며, 키트는 n8n에 'Local QdrantApi database' 자격 증명을 미리 만들어 둡니다. 함께 제공되는 데모 워크플로는 이를 사용하지 않으므로, RAG 파이프라인은 직접 만든 워크플로에 Qdrant를 벡터 저장소로 추가하여 구축합니다
  • 영구적인 워크플로 및 자격 증명 저장소 — PostgreSQL이 n8n 자체의 데이터베이스를 뒷받침하여, 워크플로와 자격 증명, 실행 기록이 컨테이너 재시작 후에도 유지됨
  • GPU 가속 프로필 — 별도의 Compose 프로필(cpu, gpu-nvidia, gpu-amd)을 통해 지원되는 환경에서 Ollama가 사용 가능한 GPU 하드웨어를 활용해 더 빠른 로컬 추론을 수행할 수 있음
  • 공유 파일 접근 — 마운트된 /data/shared 폴더를 통해 n8n이 Read/Write Files from Disk, Local File Trigger, Execute Command 같은 노드로 로컬 파일을 읽고 쓸 수 있어, 문서 수집 워크플로에 유용합니다
  • 미리 불러온 데모 워크플로 — 키트는 첫 시작 시 워크플로 하나('Demo workflow': Chat Trigger, Basic LLM Chain, llama3.2:latest로 설정된 Ollama Chat Model)를 가져옵니다. 열어서 Chat 버튼으로 로컬 모델과 대화할 수 있습니다

사용 예시: Starter Kit를 활용하는 세 가지 방법

첫 번째 예시는 키트 자체의 데모 워크플로입니다. 나머지 두 가지는 README가 언급하는 노드를 사용해 번들 구성 요소로 직접 만드는 패턴이며, 키트가 완성된 워크플로로 제공하지는 않습니다.

미리 불러온 데모 채팅 워크플로 실행하기

docker compose --profile cpu up을 실행한 뒤 http://localhost:5678에서 n8n을 열고 최초 1회 설정을 마칩니다. 포함된 워크플로를 열고 캔버스 하단의 Chat을 눌러 메시지를 보냅니다. 처음 실행할 때는 Ollama가 llama3.2 다운로드를 마칠 때까지 기다리세요. 진행 상황은 Docker 로그에서 확인할 수 있습니다. 클라우드 API 키는 사용하지 않습니다.

공유 폴더를 이용한 문서 수집 파이프라인 구축하기

마운트된 /data/shared 폴더에 파일을 넣고, 이 폴더를 감시하는 n8n 워크플로(예: Local File Trigger 노드)를 만듭니다. 새 문서를 로컬 Ollama 임베딩 모델로 임베딩하고 나중에 검색할 수 있도록 Qdrant에 색인합니다. 이 파이프라인은 직접 조립하며, 키트가 제공하는 것은 서비스와 자격 증명이지 워크플로가 아닙니다.

n8n의 400개 이상의 통합으로 기본 워크플로 확장하기

미리 불러온 데모 채팅 워크플로에서 시작해 이미 사용 중인 서비스(이메일, Slack, CRM, 맞춤 웹훅)의 노드를 추가하면, 로컬 모델이 생성한 응답이 다른 곳에서 동작을 일으키도록 할 수 있습니다. 키트의 로컬 AI 기반 위에서 n8n의 폭넓은 통합 카탈로그를 활용합니다.

Self-Hosted AI Starter Kit 설치하기

스타터 키트는 git clone과 Docker Compose로 설치합니다 — 별도로 다운로드하는 앱은 없습니다. 아래 단계는 공식 GitHub README에서 가져온 것입니다. 정확한 명령은 업데이트에 따라 바뀔 수 있으므로 항상 해당 페이지에서 직접 확인하십시오.

단계
명령어 / 링크
1. 저장소 클론git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git
2. 디렉터리로 이동cd self-hosted-ai-starter-kit
3. 환경 파일 복사cp .env.example .env (이후 임시 비밀번호와 시크릿을 변경)
4a. 시작(CPU 전용)docker compose --profile cpu up
4b. 시작(Nvidia GPU)docker compose --profile gpu-nvidia up
4c. 시작(AMD GPU, Linux)docker compose --profile gpu-amd up
4d. 시작(Mac / Apple Silicon)docker compose up (Ollama는 Mac에서 실행, 참고 사항 확인)
소스 코드github.com/n8n-io/self-hosted-ai-starter-kit

스택이 시작되면 n8n은 http://localhost:5678에서 사용할 수 있습니다. 필요한 하드웨어는 Ollama에서 실행하는 모델에 따라 달라집니다. 작은 모델은 CPU만 있는 평범한 머신에서도 동작하고, 큰 모델은 Nvidia 또는 AMD GPU 프로필의 이점을 얻습니다. 받기 전에 Ollama 라이브러리에서 모델 크기를 확인하세요. Apple Silicon Mac에서는 Docker가 GPU를 사용할 수 없습니다. README는 CPU 전용 실행, 또는 Mac에 Ollama를 직접 설치하는 방법을 제시합니다. 후자는 .env에 OLLAMA_HOST=host.docker.internal:11434를 설정하고, n8n의 'Local Ollama service' 자격 증명을 http://host.docker.internal:11434/로 지정한 뒤, 프로필 없이 docker compose up을 실행합니다. .env.example에는 임시 시크릿이 들어 있으며(데이터베이스 비밀번호는 password) README는 이를 변경하라고 안내합니다. Docker와 Docker Compose가 필요하며, 키트 자체에는 OS별 빌드가 없습니다.

가격과 라이선스

스타터 키트 자체는 무료이며 오픈소스로, Apache-2.0 라이선스를 따릅니다. 다른 오픈소스 프로젝트를 번들로 포함하고 있으므로, 각 번들 구성 요소 자체의 라이선스와 비용 모델도 알아둘 가치가 있습니다.

Self-hosted AI Starter Kit(본 템플릿)

라이선스:
저장소 LICENSE 파일에 따른 Apache-2.0
비용:
무료

n8n(번들)

라이선스:
셀프호스트 사용을 위한 Sustainable Use License(소스 공개형, OSI 미승인); 전체 라이선스 세부사항은 n8n 리뷰 참조
비용:
n8n 라이선스 조건에 따라 셀프호스트 사용은 무료

Ollama(번들)

라이선스:
MIT
비용:
무료

Qdrant(번들)

라이선스:
Apache-2.0
비용:
무료

PostgreSQL(번들)

라이선스:
PostgreSQL License(관대한 라이선스)
비용:
무료

전체 스택을 운영하는 데 소프트웨어 라이선스 비용은 전혀 들지 않습니다 — 유일한 실제 비용은 자신의 인프라(컴퓨팅, 스토리지, 선택적으로 GPU)뿐입니다. 미리 로드된 n8n 워크플로를 확장해 유료 클라우드 LLM API나 유료 타사 통합을 호출한다면 해당 제공업체 자체의 가격이 적용됩니다. 스타터 키트 자체는 어떠한 마크업이나 구독료도 추가하지 않습니다.

Self-Hosted AI Starter Kit 대 일반 n8n

스타터 키트는 n8n의 대체품이 아니라, n8n에 미리 연결된 로컬 AI 스택을 더한 것입니다. 그 차이를 이해하는 가장 명확한 방법은 처음부터 바로 얻는 것과 직접 구성해야 하는 것을 비교하는 것입니다.

설치하는 것

Self-Hosted AI Starter Kit:
n8n + Ollama + Qdrant + PostgreSQL이 하나의 docker-compose.yml에 사전 네트워킹되어 있음
일반 n8n 셀프호스트:
n8n만 — 자체 설치 단계는 n8n 리뷰 참조

로컬 LLM 추론

Self-Hosted AI Starter Kit:
번들된 Ollama를 통해 기본으로 포함됨
일반 n8n 셀프호스트:
포함되지 않음; 사용자가 직접 자신의 모델 제공자(로컬 또는 클라우드)를 수동으로 연결해야 함

RAG용 벡터 데이터베이스

Self-Hosted AI Starter Kit:
번들된 Qdrant를 통해 기본으로 포함됨
일반 n8n 셀프호스트:
포함되지 않음; 사용자가 직접 벡터 데이터베이스를 추가하고 연결해야 함

예제 워크플로

Self-Hosted AI Starter Kit:
데모 채팅 워크플로 하나(Chat Trigger, Basic LLM Chain, Ollama)와 미리 만든 Ollama·Qdrant 자격 증명
일반 n8n 셀프호스트:
빈 캔버스로 시작; 템플릿은 n8n 템플릿 라이브러리에서 별도로 이용 가능

적합한 대상

Self-Hosted AI Starter Kit:
서비스들을 수동으로 연결하지 않고 몇 분 만에 완전한 로컬 AI 워크플로 환경을 가동하고 싶은 경우
일반 n8n 셀프호스트:
이미 자체 모델 또는 벡터 인프라를 운영하고 있으며 자동화 계층만 필요한 팀

인프라 내 다른 곳에서 이미 Ollama나 벡터 데이터베이스를 운영하고 있다면, 일반 n8n을 설치하고 기존 서비스에 연결하는 편이 스타터 키트의 번들 버전을 도입하는 것보다 더 간단할 수 있습니다. 처음부터 시작하는 경우라면 스타터 키트가 통합 작업을 대신 처리해 줍니다.

디렉터리에서 비교

Starter Kit는 누구에게 적합한가?

스타터 키트가 적합한지 여부는 즉시 사용 가능한 로컬 AI 워크플로 환경을 원하는지, 아니면 동일한 구성 요소를 직접 조립하고 싶은지에 따라 달라집니다.

다음의 경우 Self-Hosted AI Starter Kit를 사용하십시오

  • 워크플로 도구, 모델 러너, 벡터 데이터베이스를 각각 수동으로 설치하고 연결하지 않고도 로컬 에이전트형 AI 워크플로(RAG, 모델 기반 자동화)를 시도해보고 싶은 경우
  • 이미 n8n에 관심이 있으며 빈 워크플로 캔버스가 아니라 AI에 초점을 맞춘 출발점을 원하는 경우
  • 처음부터 만드는 대신, 동작하는 로컬 Ollama 채팅 워크플로를 학습하고 수정할 출발점으로 삼고 싶은 경우
  • 시작할 때 클라우드 API 키가 전혀 필요 없이 스택의 모든 구성 요소가 자신의 인프라에서 실행되어야 하는 경우
  • GPU(Nvidia 또는 Linux의 AMD)가 있고 이를 로컬 추론에 활용하는 사전 구성된 Compose 프로필을 원하는 경우

다음의 경우 보류하거나 다른 대안을 찾아보십시오

  • 이미 n8n, Ollama, 또는 벡터 데이터베이스를 독립적으로 운영하고 있으며, 스타터 키트의 번들 버전이 기존 설정과 중복되거나 충돌하는 것을 원하지 않는 경우
  • 워크플로 자동화 도구가 제공하는 것보다 더 깊은 문서 처리 기능을 갖춘 전용 RAG 프레임워크가 필요한 경우 — 목적에 특화된 대안으로 RAGFlow 리뷰 또는 Haystack 리뷰 참조
  • 모든 번들 구성 요소에 대해, n8n의 셀프호스트 라이선스 조건(OSI 미승인의 소스 공개형 Sustainable Use License)이 아니라 단순한 관대한 오픈소스 라이선스를 원하는 경우 — 이 차이가 조직에 중요하다면 n8n 자체의 라이선스를 직접 확인하십시오
  • 엔터프라이즈 지원이나 프로덕션 수준의 배포가 필요한 경우 — 지원 채널은 n8n 포럼이며, n8n 문서는 이 키트를 '테스트 전용'으로 표시합니다

Starter Kit 대 다른 로컬 AI 워크플로 도구

Self-hosted AI Starter Kit는 워크플로 자동화 및 RAG 프레임워크 영역에서 셀프호스팅 가능한 다른 여러 옵션과 나란히 위치합니다. 인접한 도구와의 비교는 다음과 같습니다 — 전체 카탈로그는 로컬 LLM 소프트웨어 디렉터리를, 가장 근접한 일대일 비교는 위의 전용 Starter Kit 대 일반 n8n 비교 섹션을 참조하십시오.

  • n8n — 이 키트가 구축된 바탕이 되는 워크플로 자동화 플랫폼; 위의 전용 비교 섹션과, 독립적인 설치 및 라이선스 세부사항을 다루는 전체 n8n 리뷰를 참조하십시오.
  • LangChain-Chatchat — 범용 워크플로 자동화 캔버스가 아니라 자체 내장 UI를 갖춘 셀프호스트형 RAG 및 지식베이스 애플리케이션; 워크플로 빌더보다 전용 문서 채팅 앱이 필요에 더 잘 맞는다면 LangChain-Chatchat 리뷰를 참조하십시오.
  • RAGFlow — 범용 워크플로 도구보다 더 철저하게 복잡한 문서(표, 레이아웃)를 파싱하는 데 초점을 맞춘 심층 문서 이해형 RAG 엔진; RAGFlow 리뷰를 참조하십시오.
  • Haystack — 비주얼 워크플로 빌더 대신 파이프라인 코드를 직접 작성하고 싶은 개발자를 위한 Python 중심 RAG 프레임워크; Haystack 리뷰를 참조하십시오.

디렉터리에서 비교

Starter Kit 평가 시 흔한 실수

Self-hosted AI Starter Kit에 대한 혼란은 대부분 이를 독립 애플리케이션으로 취급하거나, 실제로 무엇을 번들로 포함하는지 오해하거나, 잘못된 Compose 프로필을 선택하는 데서 비롯됩니다.

실수 1: n8n과 별개의 독립 앱으로 취급하기

스타터 키트는 그 자체로 독립된 제품이 아니라, n8n을 Ollama, Qdrant, PostgreSQL과 함께 설치하고 네트워킹하는 Docker Compose 템플릿입니다. n8n 자체에 대한 리뷰(기능, 라이선스, 릴리스 주기)는 이 키트 안에서 실행되는 n8n 인스턴스에도 그대로 적용됩니다. 자세한 내용은 n8n 리뷰를 참조하십시오.

실수 2: 클라우드 LLM 제공자가 포함되어 있다고 가정하기

스타터 키트에 기본으로 번들된 모델 제공자는 Ollama이며, 모델은 전적으로 로컬에서 실행됩니다. 클라우드 LLM API 키는 포함되어 있지도 필요하지도 않습니다 — 클라우드 제공자를 추가하고 싶다면 n8n 워크플로 내에서 별도로 구성해야 합니다.

실수 3: 성능이 충분한 GPU를 갖춘 머신에서 기본 cpu 프로필을 실행하기

Compose 파일에는 cpu, gpu-nvidia, gpu-amd 세 가지 프로필이 있으며, 명령줄에서 지정하지 않으면 어느 것도 활성화되지 않습니다. Nvidia 또는 AMD GPU가 있는 머신에서 docker compose --profile cpu up을 실행하면 사용 가능한 가속을 놓치게 되므로, 해당하는 GPU 프로필을 사용하세요. Apple Silicon Mac에서는 어떤 프로필로도 Docker가 GPU에 접근할 수 없으며, README는 Mac에서 Ollama를 직접 실행할 것을 제안합니다.

실수 4: 스타터 키트 자체가 독립적인 버전 릴리스 주기를 갖는다고 기대하기

이 키트는 자체 코드베이스를 가진 애플리케이션이 아니라 설정 템플릿이므로 릴리스나 태그를 게시하지 않습니다. 고정된 스택을 기대하지 마세요. n8nio/n8n, ollama/ollama, qdrant/qdrant는 latest로 받아오므로 버전은 pull하는 날짜에 따라 달라지며, PostgreSQL(postgres:16-alpine)만 고정되어 있습니다.

실수 5: 데모 구성을 프로덕션용으로 착각하기

n8n 문서는 이 키트를 '테스트 전용'으로 표시하며, README도 프로덕션 환경에 완전히 최적화되지 않았다고 밝힙니다. 함께 제공되는 .env.example은 임시 시크릿을 사용하고, compose 파일은 호스트의 5678, 11434, 6333 포트를 공개합니다. 스택을 내 컴퓨터 밖에서 접근 가능하게 만들기 전에 시크릿을 변경하고 공개된 포트를 검토하세요.

자주 묻는 질문

n8n Self-hosted AI Starter Kit란 무엇입니까?

n8n이 관리하고 github.com/n8n-io/self-hosted-ai-starter-kit에 공개된 오픈소스 Docker Compose 템플릿으로, n8n, Ollama, Qdrant, PostgreSQL을 하나의 명령으로 묶어 클라우드 의존 없이 로컬 AI 워크플로를 만들 수 있게 합니다. 검색에서는 흔히 'n8n AI starter kit'라고 부릅니다.

Self-hosted AI Starter Kit는 무료입니까?

예. 템플릿 자체는 Apache-2.0 라이선스로 제공되며, 실행에 비용이 들지 않습니다. 번들된 구성 요소(n8n, Ollama, Qdrant, PostgreSQL)도 각각 자체 라이선스에 따라 셀프호스트 사용이 무료입니다 — 위의 가격표를 참조하십시오.

Self-hosted AI Starter Kit는 실제로 무엇을 번들로 포함합니까?

개별적으로 유지관리되는 4개의 오픈소스 프로젝트입니다: n8n(워크플로 자동화, 400개 이상의 통합), Ollama(로컬 LLM 추론), Qdrant(벡터 데이터베이스), PostgreSQL(n8n 자체 데이터를 뒷받침하는 관계형 데이터베이스). 이는 docker-compose 구성이며 새로운 소프트웨어가 아닙니다.

Self-hosted AI Starter Kit는 클라우드 계정이나 API 키가 필요합니까?

아니요. 포함된 모든 서비스는 기본적으로 로컬에서 실행되며, 데모 워크플로는 포함된 Ollama 모델(llama3.2)만 사용합니다. 필요하면 나중에 n8n 워크플로 안에서 클라우드 제공자의 API 키를 추가할 수 있습니다.

Self-hosted AI Starter Kit는 어떻게 설치합니까?

저장소를 클론하고(git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git), 환경 파일을 복사한 뒤(cp .env.example .env), docker compose --profile cpu up(GPU 가속의 경우 gpu-nvidia 또는 gpu-amd)을 실행합니다. 전체 순서는 위의 설치 표를 참조하십시오.

GPU 가속을 지원합니까?

예, 별도의 Docker Compose 프로필을 통해 지원됩니다: Nvidia GPU용 gpu-nvidia, Linux의 AMD GPU용 gpu-amd, 그리고 CPU 전용 추론을 위한 기본 cpu 프로필입니다.

이것은 n8n과 같은 것입니까?

아닙니다. n8n은 번들된 4개 구성 요소 중 하나입니다. 스타터 키트는 n8n을 Ollama, Qdrant, PostgreSQL과 함께 설치하는 사전 구성된 환경입니다 — 정확한 차이점은 위의 Self-Hosted AI Starter Kit 대 일반 n8n 비교를 참조하십시오.

이 키트 안에서 n8n 자체는 어떤 라이선스를 사용합니까?

n8n은 셀프호스트 사용을 위해 자체 Sustainable Use License(OSI 미승인)로 소스가 공개되어 있으며, 이는 이 스타터 키트 템플릿 자체를 다루는 Apache-2.0 라이선스와는 별개입니다. 전체 라이선스 세부사항은 n8n 리뷰를 참조하십시오.

Self-hosted AI Starter Kit는 프로덕션에 사용할 수 있습니까?

n8n에 따르면 그렇지 않습니다. 문서는 이 키트를 '테스트 전용'으로 표시하고, README도 프로덕션에 완전히 최적화되지 않았다고 밝힙니다. 개념 검증용 기반으로 취급하고, 프로덕션에서 사용하기 전에 .env의 임시 시크릿을 변경하고, 공개된 포트를 검토하고, 이미지 버전을 고정하세요.

Self-hosted AI Starter Kit는 누가 유지관리합니까?

n8n 워크플로 자동화 플랫폼을 만든 기업인 n8n이 큐레이션하고 유지관리하며, n8n의 AI 및 LangChain 노드로 구축한 로컬 AI 워크플로를 보여주는 부속 자료로 제공됩니다.

Self-hosted AI Starter Kit는 아직 유지보수되고 있습니까?

기본 브랜치의 최신 커밋은 2026년 7월 23일이며 README 링크만 수정했습니다. compose 파일의 마지막 변경은 2026년 1월 6일입니다. 저장소는 릴리스나 태그를 게시하지 않고, n8n 문서에도 지원 중단 언급은 없습니다. 의존하기 전에 저장소를 확인하세요.

Self-hosted AI Starter Kit는 Apple Silicon Mac에서 실행됩니까?

예, 다만 Docker는 Mac의 GPU를 사용할 수 없습니다. README는 두 가지 방법을 제시합니다. 키트 전체를 CPU로 실행하거나(docker compose --profile cpu up), Mac에 Ollama를 설치하고 .env에 OLLAMA_HOST=host.docker.internal:11434를 설정한 뒤 n8n의 'Local Ollama service' 자격 증명을 http://host.docker.internal:11434/로 지정하고 docker compose up을 실행합니다.

출처

← 고급 로컬 LLM으로 돌아가기

MCP