2.Self-Hosted AI: n8n + Ollama, local AI workflows on your Mac

개요

n8n과 Ollama를 사용하여 Mac 로컬 환경에서 데이터를 외부로 내보내지 않고 AI 워크플로우를 구축하는 방법을 설명합니다.

주요 내용

* 로컬 AI 환경 구축: Docker Desktop for Mac 설치가 선행되어야 하며, n8n의 Self-hosted AI Starter Kit은 n8n, Ollama, Qdrant, PostgreSQL을 미리 구성하여 제공합니다.
* Docker Compose 설정: Starter Kit의 .env 파일을 편집하여 데이터베이스 접속 정보 및 n8n 암호화 키를 설정합니다. Apple Silicon Mac의 GPU 사용 제약으로 인해 Ollama는 Mac 네이티브로 실행하고 Docker 컨테이너에서 연결하는 것이 권장되며, 이를 위해 .env 파일에 OLLAMA_HOST=host.docker.internal:11434 설정을 추가합니다. docker compose up 명령으로 서비스를 시작합니다.
* Ollama 네이티브 설치: Mac에 Ollama를 네이티브로 설치하기 위해 Homebrew를 사용하며, brew install ollama 명령으로 설치 후 ollama pull [모델명]으로 모델을 다운로드합니다. Ollama는 기본적으로 http://localhost:11434에서 API를 제공합니다.
* n8n과 Ollama 연동: n8n에서 "Ollama" Credentials를 생성하고 Base URL을 http://host.docker.internal:11434로 설정합니다. (n8n이 Docker 내, Ollama가 호스트에 실행될 경우). n8n의 AI Agent 노드에서 "Ollama Chat Model"을 선택하고 생성한 Credential을 지정한 후, 다운로드된 모델(gemma4 등)을 선택하여 로컬 모델과의 채팅 워크플로우를 구성할 수 있습니다.
* Agent에 도구(Tools) 연결: AI Agent 노드에서 HTTP Request, Gmail, Qdrant 벡터 스토어 등 외부 도구 서브 노드를 연결하여 모델이 특정 조건에서 도구를 사용하도록 구성할 수 있습니다. 이 기능은 모델이 도구 사용을 지원할 때 효과적입니다.
* 연결 오류 해결: Docker 내 n8n과 호스트 Ollama 연동 시 host.docker.internal 사용, 동일 Docker 네트워크 내 서비스 간 통신 시 서비스명 사용(http://ollama:11434), 네이티브 설치 시 localhost 사용 등 환경에 따른 URL 규칙을 확인해야 합니다.
* Ollama Cloud API Key: ollama.com/settings/keys에서 발급받는 API Key는 Ollama Cloud 서비스용이며, 로컬 환경에서는 필요하지 않습니다.

시사점

n8n과 Ollama를 조합하면 Mac 로컬 환경에서 자체 모델을 활용하여 외부 데이터 유출 없이 완전한 프라이빗 AI 스택을 구축하고, 이를 기반으로 다양한 자동화 워크플로우를 실현할 수 있습니다.