10월 3.0부터 설치법이 바뀌어요
n8n 한 줄 설치하고 첫 AI 채팅 에이전트 만들기
2026년 9월 30일 올림 · 9월 30일 확인
n8n · Ollama · Docker · 읽는 데 20분n8n은 블록(노드)을 선으로 이어 업무를 자동화하는 도구예요. 내 컴퓨터나 회사 서버에 직접 깔면(셀프 호스팅) 무료로 쓸 수 있어서 개발자들이 많이 써요.
2026년 10월 나오는 n8n 3.0부터는 예전 방식(npx n8n, npm 설치)이 안 되고 도커로만 배포돼요. 그래서 공식 문서도 새 한 줄 설치를 권해요. 이 글은 그 방법 기준입니다.
1단계n8n 띄우기
- Docker Desktop을 깔고 켜 둬요. 도커 명령을 몰라도 괜찮아요.
- 맥·리눅스 터미널에서 아래 한 줄을 실행해요. 지금 있는 폴더 안에 n8n 폴더를 만들고 설정 파일까지 알아서 써 줍니다.
curl -fsSL https://get.n8n.io | sh
- 끝에 나온 주소 http://localhost:5678 을 열고 관리자 계정을 만들어요.
- 끌 때는 이렇게요. 설치했던 폴더에서 실행하세요.
docker compose -f ./n8n/compose.yml down
- 같은 명령을 다시 실행해도 이미 있으면 아무것도 안 바꿔요. 업데이트는 뒤에 -s -- --upgrade 를 붙여요.
- 끄는 명령에 -v 를 붙이면 워크플로와 기록이 전부 지워져요. 조심하세요.
- 윈도우는 공식 문서의 설치 안내를 따로 확인하세요.
2단계채팅 에이전트 만들기
- 새 워크플로를 만들고 첫 노드로 Chat Trigger를 넣어요. 채팅 메시지가 오면 흐름이 시작돼요.
- 뒤에 AI Agent 노드를 이어요. 에이전트는 질문을 보고 어떤 도구를 쓸지 스스로 정하는 블록이에요.
- AI Agent 아래 Chat Model 자리에 Ollama Chat Model을 붙이고, 새 자격 증명(연결 정보)을 만들어 Base URL을 넣어요. n8n이 도커 안에 있어서 localhost가 아니라 이 주소예요.
http://host.docker.internal:11434
- 모델 칸에서 받아 둔 모델(예: gemma4)을 고르고, Memory 자리에 Simple Memory를 붙여요. 그래야 앞 대화를 기억해요.
- 아래쪽 채팅 창을 열어 말을 걸어 보세요. 노드마다 초록 표시가 뜨면 성공이에요.
- 연결이 안 되면 Ollama가 바깥 요청을 받게 해 주세요. 맥은 아래 명령 뒤 Ollama 앱을 다시 켜요: launchctl setenv OLLAMA_HOST "0.0.0.0:11434"
- Ollama 대신 OpenAI·Anthropic·구글 모델 노드를 붙여도 흐름은 같아요. 키는 n8n 자격 증명에만 넣으세요.
3단계도구 붙여서 진짜 일 시키기
- AI Agent의 Tool 자리에 구글 시트, 슬랙, HTTP Request 같은 노드를 붙이면 에이전트가 필요할 때 직접 불러 써요.
- 처음엔 도구 하나만 붙이고, 에이전트 설정의 시스템 메시지에 '언제 이 도구를 쓸지'를 한 줄로 적어 주세요. 도구가 많을수록 헷갈려 해요.
알아 둘 것

출처 (2026년 9월 30일 확인)
GitHub n8n-io/n8n (Sustainable Use License) · https://github.com/n8n-io/n8n
n8n 문서 — 한 줄 설치 · https://docs.n8n.io/deploy/host-n8n/install-options/one-line-setup
n8n 문서 — Ollama Chat Model 연결 문제 · https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatollama/common-issues
n8n 문서 — Chat Trigger · https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger
Ollama 자주 묻는 질문 — 서버 주소 설정 · https://docs.ollama.com/faq
매주 쓰는 틀을 직무별로 한 번에 묶고 있어요. 돈 내기 전에 이 글부터 따라 해 보세요.
