10월 3.0부터 설치법이 바뀌어요
n8n 한 줄 설치하고 첫 AI 채팅 에이전트 만들기
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 같은 노드를 붙이면 에이전트가 필요할 때 직접 불러 써요.
- 처음엔 도구 하나만 붙이고, 에이전트 설정의 시스템 메시지에 '언제 이 도구를 쓸지'를 한 줄로 적어 주세요. 도구가 많을수록 헷갈려 해요.
알아 둘 것
라이선스 — Sustainable Use License라는 '공정 코드' 라이선스예요. 사내 업무용은 괜찮지만, n8n 자체를 유료 서비스로 되팔면 안 돼요.
클라우드판은 메시지마다 실행 1회 — 채팅 10번이면 실행 10회로 세요. 셀프 호스팅은 횟수 제한이 없어요.
새 에이전트 기능 — 워크플로 없이 에이전트만 따로 만드는 기능이 미리보기로 나와 있어요. 셀프 호스팅은 추가 설정이 필요해요.

처음엔 선 잇는 게 장난감 같은데, 세 번째 워크플로쯤 가면 퇴근이 빨라져요. 저는 아직 첫 번째예요.
출처 (2026-09-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
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