Docker 및 n8n 설치방법

1. Docker 설치

• Docker 공식 홈페이지에서 "Download Docker Desktop"을 클릭
• Docker Desktop 설치 파일을 다운로드
  • Download for Windows - AMD64 또는 ARM64 선택
• 다운로드한 Docker Desktop Installer.exe 파일을 실행
• 설치 과정에서 나타나는 옵션(예: WSL2 사용, 바탕화면 아이콘 추가)을 체크한 후 설치를 진행
• 설치가 완료되면 "Installation succeeded" 메시지가 나타난다. 필요 시 재부팅 또는 로그아웃을 진행
• 바탕화면의 Docker Desktop 아이콘을 더블 클릭하여 실행

2. Docker 이미지 다운로드

   1. 터미널을 통한 다운로드
    다음 명령어 실행

docker pull n8nio/n8n

 

   2. Docker 에서 다운로드
   화면왼쪽 패널의 Docker Hub에서 n8n 검색, 오른쪽 상단에 "Pull" 버튼을 누르면 이미지를 다운로드 한다.

 

   다운로드가 완료되면 Docker Desktop의 "Images" 탭에서 n8nio/n8n 이미지가 표시된다.

 

3. n8n 실행 (단일 컨테이너)

가장 간단한 방법으로, 로컬 환경에서 n8n을 실행한다.

1. Docker 명령어 실행
   도커 터미널에서 다음 명령어를 입력해 n8n 컨테이너를 실행한다.

docker run -d --name n8n -p 8080:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

• -it: 인터랙티브 모드로 실행
• --rm: 컨테이너 종료 시 자동 삭제
• --name n8n: 컨테이너 이름 지정
• -p 5678:5678: 호스트의 8080 포트를 컨테이너의 5678 포트에 매핑
• -v ~/.n8n:/home/node/.n8n: 워크플로우 및 설정 데이터를 로컬에 저장

   2. n8n 접속
브라우저에서 http://localhost:8080에 접속합니다. n8n의 웹 인터페이스가 나타나며, 계정을 설정하고 워크플로우를 시작할 수 있다.

 

  3. 컨테이너 중지
실행을 멈추려면 Ctrl + C를 누르거나, 별도의 터미널에서 다음 명령어를 사용

docker stop n8n

 

4. Docker Compose로 n8n 실행

여러 설정을 관리하거나 확장성을 높이고 싶을 때 Docker Compose를 사용한다.

1. Windows 에서 docker-compose.yml 파일을 생성하기
   • 디렉토리 생성

mkdir n8n-project 
cd n8n-project

1. • 파일생성 하기(메모장 사용)

notepad docker-compose.yml

 

1. • 메모장이 열리면 아래 내용을 붙여넣고 저장

	version: '3'
	
	services:
	  n8n:
		image: n8nio/n8n
		container_name: n8n
		restart: unless-stopped
		ports:
		  - "8080:5678"
		environment:
		  - N8N_BASIC_AUTH_ACTIVE=false
		  - N8N_HOST=localhost
		  - N8N_PORT=5678
		  - N8N_PROTOCOL=http
		volumes:
		  - n8n_data:/home/node/.n8n
	
	volumes:
	  n8n_data:

 

   2. Docker Compose 명령으로 컨테이너 실행

# 현재 실행 중인 n8n 컨테이너가 있다면 중지 및 삭제
docker stop n8n
docker rm n8n

# docker-compose.yml 파일이 있는 디렉토리에서
docker-compose up -d

 

  3. n8n 접속
   브라우저에서 `http://localhost:8080`에 접속한다.

  4. 컨테이너 관리

# 상태확인
docker-compose ps

# 로그확인
docker-compose logs

# 중지
docker-compose stop

# 시작
docker-compose start

# 중지 후 시작
docker-compose restart

# 완전히 제거
docker-compose down

# 불륨까지 제거
docker-compose down -v

5. 문제 해결

• 포트 충돌: 5678 포트가 이미 사용 중이면 다른 포트로 변경(예: -p 8080:5678)
• 권한 문제: ~/.n8n 폴더의 권한을 확인하고, 필요 시 chmod -R 755 ~/.n8n 실행
• 최신 이미지 확인: docker pull n8nio/n8n으로 최신 이미지 다운로드

 

참고

• 공식 Docker Hub: n8n 이미지
• 공식 문서: n8n 셀프 호스팅 가이드