안녕하세요! 자동화 마법사가 되고 싶은 분들을 위해 가장 쉽고 빠르며 안정적인 n8n 설치 방법을 알려드립니다. n8n은 워크플로우 자동화 툴의 끝판왕이지만, 설치 과정이 복잡하면 시작부터 지치기 마련이죠.
걱정 마세요. Docker만 있으면 복잡한 설정 없이 5분 안에 여러분의 로컬 PC에 나만의 n8n 서버를 띄울 수 있습니다.
🚀 왜 Docker로 설치해야 할까요?
- 설치 5분 컷: 복잡한 Node.js 의존성 걱정 없이, 명령어 한 줄이면 끝!
- 격리된 환경: 내 컴퓨터의 다른 프로그램과 충돌 없이 깔끔하게 실행됩니다.
- 데이터 보존: 컨테이너를 껐다 켜도 작업했던 워크플로우가 사라지지 않습니다.
- 쉬운 업데이트: 나중에 최신 버전으로 업데이트하기도 아주 쉽습니다.
Step 0: 필수 준비물 – Docker Desktop 설치
n8n을 설치하기 전에, 먼저 여러분의 컴퓨터에 Docker Desktop이 설치되어 실행 중인지 확인하세요.
- **Docker 공식 웹사이트**에서 운영체제(Windows/Mac)에 맞는 Docker Desktop을 다운로드하여 설치합니다.
- 설치 후, Docker Desktop을 실행하여 상태 표시줄에 **’Running’**으로 표시되는지 확인합니다.
Step 1: n8n 데이터를 저장할 공간 확보 (볼륨 생성)
나중에 컴퓨터를 껐다 켜도 작업했던 워크플로우와 크리덴셜(인증 정보)이 사라지지 않도록, Docker **볼륨(Volume)**을 생성하여 데이터를 저장할 전용 공간을 만들어 줍니다.
- 터미널(Terminal) 또는 명령 프롬프트/PowerShell을 엽니다.
- 아래 명령어를 입력하고 실행합니다.
Bash
$ docker volume create n8n_data💡 설명:
n8n_data라는 이름의 영구적인 저장 공간을 만들었습니다.
Step 2: n8n 컨테이너 실행 명령어 입력
이제 가장 중요한 단계입니다! 아래 명령어를 줄 바꿈 없이 한 줄로 입력하고 실행하세요.
Bash
$ docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n:latest| 옵션 | 의미 | 역할 |
docker run | 컨테이너를 실행합니다. | |
--name n8n | 컨테이너 이름을 n8n으로 지정합니다. | 나중에 쉽게 관리할 수 있습니다. |
-p 5678:5678 | 내 컴퓨터의 5678 포트와 컨테이너의 5678 포트를 연결합니다. | 웹 브라우저로 n8n에 접속할 수 있게 합니다. |
-v n8n_data:/home/node/.n8n | Step 1에서 만든 볼륨을 연결합니다. | 가장 중요! 워크플로우 데이터가 영구적으로 저장됩니다. |
n8nio/n8n:latest | 실행할 n8n의 최신 버전 이미지입니다. | Docker Hub에서 자동으로 다운로드됩니다. |
Step 3: n8n 접속 및 계정 생성
명령어를 실행하면 터미널에 로그가 쭉 올라오다가 다음과 같은 메시지가 보일 것입니다.
n8n ready on 0.0.0.0, port 5678- 웹 브라우저를 열고 다음 주소로 접속합니다.
http://localhost:5678 - n8n 환영 화면이 나타나면, 이메일과 비밀번호를 입력하여 관리자 계정을 생성합니다. (로컬 환경이므로 실제 이메일이 아니어도 무방하나, 비밀번호는 잘 기억해 두세요!)
- 계정 생성이 완료되면, 여러분만의 n8n 워크플로우 빌더 화면이 나타납니다.
이제부터는 로컬 환경에서 자유롭게 자동화 워크플로우를 만들고 테스트할 수 있습니다!
💡 마무리 팁: n8n 종료 및 재시작
- 종료하기: 터미널 창을 활성화한 상태에서
Ctrl + C를 누르면 n8n 컨테이너가 중지됩니다. - 다시 시작하기: 다음번에 n8n을 다시 실행하고 싶다면, 터미널에서 다음 명령어를 입력합니다.Bash
docker start n8n이전 데이터가 연결된 상태로 바로 시작됩니다.
자동화의 세계에 오신 것을 환영합니다! 로컬 환경에서 부담 없이 n8n을 경험해 보세요.