n8n을 로컬에서 실행하는 것은 자동화 (automation)를 배우는 가장 쉽고 완전히 무료인 방법입니다. 이 가이드에서는 Docker Desktop을 설치하고, WSL을 활성화하며, Ubuntu를 설정하여 Windows 컴퓨터에서 n8n을 실행하는 방법을 알아보겠습니다.

시작하기 전에

요구 사항

• Windows 10 또는 Windows 11 (64비트)
• 안정적인 인터넷 연결
• 관리자 권한 (Administrator Access)
• 최소 5 GB 이상의 여유 디스크 공간

1단계: Docker Desktop 다운로드

Docker를 사용하면 격리된 컨테이너 (containers) 내부에서 애플리케이션을 실행할 수 있습니다. 우리는 n8n을 로컬에서 실행하기 위해 Docker를 사용할 것입니다.

Docker Desktop 다운로드:

https://www.docker.com/products/docker-desktop/

2단계: WSL 활성화

WSL이란 무엇인가요?

**WSL (Windows Subsystem for Linux)**은 별도의 운영 체제 (operating system)를 설치하지 않고도 Windows 내부에서 Linux를 직접 실행할 수 있게 해줍니다.

**명령 프롬프트 (Command Prompt)**를 관리자 권한으로 열고 다음을 실행하세요:

wsl --install

3단계: 컴퓨터 재부팅

WSL 설치가 완료되면 컴퓨터를 재부팅하세요.

이를 통해 Windows가 WSL 설정을 올바르게 마무리할 수 있습니다.

4단계: Ubuntu 설치

재부팅 후, Windows는 WSL을 통해 Ubuntu를 설치할 것입니다.

Ubuntu는 Docker가 원활하게 작동하는 Linux 환경입니다.

프롬프트가 나타나면:

• 사용자 이름 (Username) 생성
• 비밀번호 (Password) 생성

5단계: Docker Desktop 열기

Docker Desktop을 실행하세요.

Docker가 시작될 때까지 기다리세요.

Docker가 성공적으로 실행 중인 것을 확인할 수 있을 것입니다.

6단계: Docker 설치 확인 (선택 사항)

**명령 프롬프트 (Command Prompt)**를 열고 다음을 실행하세요:

docker --version

출력 예시:

Docker version 28.x.x, build xxxxxxx

Docker 버전이 표시된다면 모든 것이 올바르게 작동하고 있는 것입니다.

7단계: n8n 데이터 볼륨 (Data Volume) 생성

Docker 볼륨 (Docker Volume)은 n8n 데이터를 안전하게 저장하여, Docker를 재시작한 후에도 워크플로 (workflows)가 유지되도록 합니다.

다음 명령을 실행하세요:

docker volume create n8n_data

예상 출력:

n8n_data

8단계: n8n 실행

이제 다음 명령어를 실행하세요:

docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

Docker는 첫 실행 시 자동으로 최신 n8n 이미지 (image)를 다운로드합니다. 인터넷 속도에 따라 몇 분 정도 걸릴 수 있습니다.

9단계: n8n 시작 대기

설치가 완료되면 다음과 유사한 메시지가 나타납니다:

Editor is now accessible via:

localhost link

10단계: n8n 열기

브라우저를 열고 다음 주소로 접속하세요:

n8n 설정 페이지가 나타날 것입니다.

11단계: 소유자 계정 (Owner Account) 생성

다음 항목을 입력하세요:

• 이름 (First Name)
• 성 (Last Name)
• 이메일 주소 (Email Address)
• 비밀번호 (Password)

**계정 생성 (Create Account)**을 클릭하세요.

축하합니다! 🎉

로컬 n8n 인스턴스가 준비되었습니다.

이제 다음 작업을 수행할 수 있습니다:

• 무제한 워크플로우(workflows) 생성
• 자동화 학습
• API 연결
• AI 워크플로우 구축
• 로컬 컴퓨터에서 n8n 무료 사용

n8n 중지하기 (Stop n8n)

명령 프롬프트(Command Prompt) 내에서 다음을 누르세요:

Ctrl + C

n8n 다시 시작하기 (Start n8n Again)

동일한 명령어를 다시 실행하기만 하면 됩니다:

docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

도움이 필요하신가요? (Need Help?)

http://localhost:5678이 열리지 않는 경우:

• Docker Desktop이 실행 중인지 확인하세요.
• WSL(Windows Subsystem for Linux)이 성공적으로 설치되었는지 확인하세요.
• Docker Desktop을 다시 시작하세요.
• 컴퓨터를 재시작하고 다시 시도해 보세요.

이것으로 끝입니다! n8n을 Windows에 로컬로 무료 설치하는 데 성공했으며, 첫 번째 자동화 워크플로우를 구축할 준비가 되었습니다.