카테고리 없음

[5강] macOS에서 n8n 로컬 환경 구성하는 법 (M1/M2 포함)

mystory5573 2025. 5. 13. 21:00

macOS에서 n8n 로컬 환경 구성하기 (M1/M2 칩 완벽 대응)

macOS에서도 n8n을 로컬에 설치해 손쉽게 자동화 워크플로를 구성할 수 있습니다. 특히 애플 실리콘(M1, M2 칩)을 사용하는 MacBook 또는 iMac 사용자들도 문제없이 설치하고 실행할 수 있도록 이 글에서는 macOS 전용 설치 가이드를 상세히 안내합니다.

n8n은 오픈소스 기반의 노코드 자동화 툴로, 로컬에서도 실행 가능하다는 점이 큰 장점입니다. macOS 사용자라면 몇 가지 필수 툴을 설치한 후, 간단한 명령어로 자동화 환경을 손쉽게 구축할 수 있습니다.

1. 사전 준비: 필수 소프트웨어 설치

n8n을 실행하기 위해 다음과 같은 도구가 필요합니다:

  • Homebrew (macOS용 패키지 관리자)
  • Node.js (n8n 실행 환경)
  • npm (Node.js와 함께 설치됨)
  • Git (버전 관리 및 템플릿 클론용)

Homebrew 설치:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 후 아래 명령어로 Homebrew가 정상 작동하는지 확인하세요: 

brew --version

Node.js 설치 (애플 실리콘 대응):

M1, M2 칩을 사용하는 경우 arch 명령어로 Node.js를 정확한 아키텍처에 맞게 설치해야 합니다: 

arch -arm64 brew install node

설치 확인: 

node -v
npm -v

Git 설치:

macOS에는 Git이 기본적으로 설치되어 있지만, 최신 버전이 필요한 경우 다음 명령어를 사용하세요: 

brew install git

2. n8n 설치하기

Node.js가 정상적으로 설치되었다면 이제 n8n을 설치할 수 있습니다. 다음 명령어로 글로벌 설치를 진행합니다: 

npm install -g n8n

설치가 완료되면 n8n 명령어를 통해 바로 실행할 수 있습니다.

3. n8n 실행 및 로컬호스트 접속

n8n 설치가 완료되면 아래 명령어를 통해 실행하세요: 

n8n

잠시 후 브라우저에서 http://localhost:5678에 접속하면 n8n의 워크플로 편집 화면이 열립니다. 이 환경에서 다양한 노드(작업)를 조합해 자동화 워크플로를 만들 수 있습니다.

4. 애플 실리콘(M1/M2)에서 발생할 수 있는 문제 해결

M1, M2 칩에서는 패키지 호환성 문제로 다음과 같은 상황이 발생할 수 있습니다. 아래 팁으로 해결해 보세요:

  • Rosetta 2 설치: 인텔 기반 바이너리 호환이 필요한 경우 실행
    • /usr/sbin/softwareupdate --install-rosetta --agree-to-license
  • n8n 실행 오류 시: arm64 아키텍처 전용 Node.js 사용 여부 확인
  • npm 권한 오류: sudo npm install -g n8n로 재설치

5. n8n 포트 변경 및 인증 설정 (선택 사항)

기본 포트(5678)를 변경하거나 로그인 인증을 적용하려면 환경 변수 설정이 필요합니다: 

export N8N_PORT=8080
export N8N_BASIC_AUTH_ACTIVE=true
export N8N_BASIC_AUTH_USER=admin
export N8N_BASIC_AUTH_PASSWORD=1234
n8n

이제 http://localhost:8080에서 실행되며, 사용자 인증이 활성화된 상태로 접속됩니다.

6. n8n 자동 실행 설정 (선택)

macOS에서 n8n을 매번 수동 실행하지 않으려면 다음 방법 중 하나를 고려하세요:

  • 크론탭(Crontab) 등록
  • Automator + 로그인 항목 추가

예: 크론탭에서 부팅 시 n8n 실행 

@reboot /opt/homebrew/bin/n8n

mac에서 n8n 실행, 이제 쉽게 자동화 시작!

이제 macOS 환경에서도 완벽하게 n8n 로컬 실행 환경이 구축되었습니다. 특히 애플 실리콘을 사용하는 경우에도 적절한 설정을 통해 문제없이 운영할 수 있으며, 강력한 노코드 자동화 기능을 로컬에서도 자유롭게 활용할 수 있습니다.

다음 강의에서는 실제 n8n을 활용해 메일 자동화, API 연동, 슬랙 알림 등을 구현해보는 실습을 진행해 보겠습니다. 자동화의 문은 이미 열려 있습니다. 지금 바로 n8n으로 여러분의 워크플로를 혁신하세요!