🔧 Docker로 n8n 설치하기

n8n 설치 방법 및 사용법 🛠️ 완벽 가이드 (2025년 기준)

 

 

 

 

 

 

n8n을 설치하는 가장 쉬운 방법은 Docker를 사용하는 것입니다.
하지만 “도커가 뭐야? 무슨 말인지 모르겠어” 하는 분들도 많죠. 이 글에서는 완전 초보자도 따라할 수 있도록 단계별로 n8n을 도커로 설치하는 과정을 자세히 안내드립니다.

 

 

🧩 Docker(도커)란 무엇인가요?

Docker는 여러 프로그램을 ‘컨테이너’라는 가상 상자에 넣어 간편하게 실행할 수 있게 해주는 도구입니다.
복잡한 설정 없이도, 준비된 이미지를 다운로드해서 바로 실행할 수 있어요.

n8n도 도커를 통해 몇 줄의 명령어만으로 설치하고 실행할 수 있어 매우 유용합니다.

 

 

 

 

1단계. Docker 설치하기

먼저, 도커가 설치되어 있지 않다면 아래 공식 사이트에서 도커를 설치해주세요.

• 💻 Docker Desktop 다운로드 (Windows / macOS)
• 📦 리눅스 사용자라면 터미널에서 패키지 매니저로 설치 가능합니다 (예: sudo apt install docker.io)

설치 후 Docker Desktop을 실행하고, 시스템 트레이에서 도커가 실행 중인지 확인해주세요. 아이콘이 흰색 혹은 파란색이면 정상 작동 중입니다. 🟦

 

2단계. 터미널 또는 명령 프롬프트 열기

이제 도커 명령어를 실행하기 위해 터미널(또는 명령 프롬프트)을 엽니다.
운영체제별로 아래를 참고하세요:

• 🖥️ Windows: CMD 또는 Powershell 열기
• 🍎 macOS: 터미널 앱 실행
• 🐧 Linux: Ctrl + Alt + T

 

3단계. n8n 설치 및 실행 명령어 입력

아래 명령어를 복사해서 붙여넣고 실행해 주세요:

docker run -it --rm \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

명령어 해설 📘  - docker run -it --rm -p 5678:5678 -v %cd%\.n8n:/home/node/.n8n n8nio/n8n

• -p 5678:5678: 브라우저에서 localhost:5678로 접속할 수 있게 설정
• -v ~/.n8n:/home/node/.n8n: 워크플로우 데이터 저장 경로 지정 (컴퓨터에 저장)
• n8nio/n8n: 공식 n8n Docker 이미지

명령어 실행 후 터미널에 로그가 출력되고, 정상 실행되었다면 브라우저에서 http://localhost:5678를 열어 n8n에 접속할 수 있습니다!

 

4단계. 설치 확인 및 워크플로우 시작 🚀

웹 페이지가 열리면 다음과 같은 화면이 보입니다:

• 🎨 직관적인 드래그&드롭 방식의 워크플로우 빌더
• 🔌 다양한 서비스 노드를 검색하여 추가 가능

처음 접속 시 회원가입 없이도 사용 가능하며, 간단한 트리거와 액션을 연결하여 첫 번째 자동화를 쉽게 만들 수 있습니다.

 

 

도커 설치가 어려울 땐?

Docker가 너무 어렵거나 설치가 안 된다면, n8n 클라우드 서비스를 이용해보세요.
별도 설치 없이 웹에서 바로 사용 가능하며, 일정 용량까지는 무료입니다. ☁️

 

📌 마무리 정리

• ✅ Docker는 초보자도 쉽게 설치 가능한 가상 실행 도구입니다.
• ✅ 단 몇 줄 명령어로 n8n을 실행할 수 있어 가장 추천되는 설치 방법입니다.
• ✅ 이후 데이터는 컴퓨터에 안전하게 저장되며, 언제든지 워크플로우 편집 가능

---