책 너머 인사이트/자동화 도구(n8n)

n8n을 도커로 셀프 호스팅하는 완벽 가이드

책 너머 인사이트 2025. 5. 22. 02:33

왜 n8n을 셀프 호스팅해야 할까?

n8n은 오픈소스 자동화 플랫폼으로, 다양한 앱과 서비스를 연결해 반복 업무를 자동화할 수 있다.

공식 클라우드 서비스는 편리하지만, 비용 부담과 데이터 보안, 커스터마이징 한계가 있다.
직접 셀프 호스팅하면 다음과 같은 이점이 있다.

  • 비용 절감: 월 구독료 없이 무료로 사용 가능6.
  • 데이터 소유권: 모든 데이터가 내 서버에 저장되어 보안과 프라이버시 강화
  • 무제한 커스터마이징: 원하는 기능과 플러그인 자유롭게 적용 가능.

특히 도커(Docker)를 이용하면 설치와 배포가 매우 간편해다.

따라서 도커를 이용해 n8n을 셀프 호스팅하는 방법을 다루고자 한다.

 

n8n 설치 환경 (windows/gpu 기준으로 설명)

- Windows

- Gpu

n8n 셀프 호스팅 전 준비 사항

Git 설치

1. Git을 검색한다.

https://git-scm.com/

 

2. 차례대로 [Downloads] > [Windows] > [Git for Windows/x64 Setup]을 클릭 후 설치한다.

Docker 설치

아래 포스팅 참고한다.

2024.11.20 - [책 너머 인사이트/생성형 AI] - Docker와 Open WebUI로 Ollama 챗봇 구축: 로컬 AI 챗봇 구축 가이드

 

Docker 설치 전 확인 사항

1. 윈도우에서 [windows 기능 켜기/끄기]를 연다.

 

 

2. 아래 세 부분을 체크한다.

 

3. 변경 사항 완료 후 윈도우를 재부팅한다.

 

n8n 설치하기

1. 구글에 n8n ai starter kit를 입력한다.

https://github.com/n8n-io/self-hosted-ai-starter-kit

 

GitHub - n8n-io/self-hosted-ai-starter-kit: The Self-hosted AI Starter Kit is an open-source template that quickly sets up a loc

The Self-hosted AI Starter Kit is an open-source template that quickly sets up a local AI environment. Curated by n8n, it provides essential tools for creating secure, self-hosted AI workflows. - n...

github.com

 

Self-hosted AI Starter Kit는 로컬에서 AI 워크플로우를 구축할 수 있는 도커 컴포즈 템플릿으로, n8n 플랫폼과 Ollama, Qdrant, PostgreSQL 같은 다양한 AI 관련 도구들을 포함하고 있어, 로우코드 환경에서 손쉽게 AI 프로젝트를 시작할 수 있다.

 

2. n8n ai starter kit 설치 전 탐색기를 띄워서 폴더를 생성한다.

 

3. 생성한 폴더에 들어간 후 검색창에 cmd를 입력한다.

 

 

4. 그러면 Powershell 팝업창이 뜬다.

5. https://github.com/n8n-io/self-hosted-ai-starter-kit 의 [For Nvidia GPU users] 아래 첫번째 명령어를 입력한다.

git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git

 

6. 두번째 명령어를 입력한다.

cd self-hosted-ai-starter-kit

 

7. 세번째 명령어를 입력하기 전 다시 탐색기를 열고, 생성된 self-hosted-ai-starter-kit 폴더를 선택한다.

 

 

8. docker-compose yml 파일을 연다.

9. environment 아래 다음을 입력 후 저장한다.

N8N_SECURE_COOKIE=false

 

10. 다시 Powershell로 돌아가 마지막 명령어를 입력한다.

docker compose --profile gpu-nvidia up

 

11. docker를 열면 self-hosted-ai-starter-kit가 생성되어 있다.

12. self-hosted-ai-starter-kit를 클릭해 n8n 아래 5678:5678 을 클릭한다.

 

 

13. 그러면 다음과 같은 페이지가 뜬다. 이메일, 이름, 비밀번호를 입력한다.

 14. 이제 셀프호스팅 으로 n8n 이 성공적으로 설치되었다.

 

 

n8n 설치 방법 영상으로 보기

https://youtu.be/BKIaFuv6b6c?si=_qn41vWES425s1G_