이 글에서는 Docker에 강력한 자동화 도구인 n8n과 그 AI 기능을 Mac환경에서 설치하는 과정을 차근차근 살펴봅니다.
목차
1. Docker 설치하기
2. n8n 설치 준비하기
3. n8n 및 AI 스타터 킷 설치하기
1. Docker 설치하기
가장 먼저 'Docker'라는 프로그램을 설치합니다. Docker를 설치하면 n8n 같은 프로그램을 내 컴퓨터의 다른 부분과 분리된 독립적인 공간에 설치하고 실행할 수 있습니다.
Docker Desktop 다운로드 및 회원가입
- Docker 공식 홈페이지에 접속해서 회원가입 및 'Download for Mac' 버튼을 클릭해 설치 파일을 다운로드합니다.
- 사용하는 Mac 모델의 칩이 애플 자체 칩(M1, M2 등)인지 인텔 칩인지 확인 후 맞는 설치 파일을 다운로드합니다.
- 도커 홈페이지: https://www.docker.com/
Docker: Accelerated Container Application Development
Docker is a platform designed to help developers build, share, and run container applications. We handle the tedious setup, so you can focus on the code.
www.docker.com
애플리케이션 폴더로 이동
- 다운로드가 완료되면 .dmg 파일을 엽니다. 창이 나타나면 Docker 아이콘을 Applications 폴더 아이콘으로 끌어다 놓으세요.
Docker 실행
- Launchpad 혹은 Applications 폴더에서 Docker를 찾아 실행합니다.
- 처음 실행할 때는 권한을 요청할 수 있는데, 모두 허용해주시면 됩니다.
- 화면 우상단 메뉴 막대에 고래 모양 아이콘이 나타나면 설치가 성공적으로 완료된 것입니다.
2. n8n 설치 준비하기
이제 n8n을 설치할 전용 폴더를 만들 차례입니다. 이렇게 하면 관련 파일들을 한 곳에 깔끔하게 정리할 수 있습니다.
작업 폴더 생성
- Finder를 열고, "사용자" 경로 하위의 사용자 이름(홈 폴더)을 클릭하세요.
- 여기서 n8n과 같은 이름으로 새 폴더를 하나 만들어 주세요. 앞으로의 작업은 이 폴더 안에서 이루어집니다.
폴더에서 터미널 실행
- 방금 만든 n8n 폴더를 마우스 오른쪽 버튼으로 클릭합니다.
- 메뉴에서 폴더에서 새로운 터미널 열기를 선택하세요.
- 검은색 화면의 '터미널' 창이 나타날 겁니다. 앞으로는 이곳에 명령어를 입력하며 작업을 진행합니다.
- 겁먹지 마세요! 필요한 명령문을 복사해서 붙여넣기만 하면 됩니다.
3. n8n 및 AI 스타터 킷 설치하기
이제 터미널 창에 명령어를 입력하여 n8n을 설치하고 AI 기능을 활성화해 보겠습니다.
n8n과 ai 스타터킷의 깃헙은 각각 아래와 같습니다.
https://github.com/n8n-io/self-hosted-ai-starter-kit
Docker 로그인
- 터미널을 통해 Docker에 n8n을 설치하려면 먼저 터미널에 Docker 로그인이 연결되어야 합니다.
- 아래 코드를 복사해서 터미널에 붙여넣고 Enter 키를 누르세요.
docker login
- 이 명령어를 입력하면 자동으로 웹 브라우저가 열리면서 Docker 로그인 정보를 확인합니다.
- 로그인 절차를 완료한 후 다시 터미널로 돌아옵니다.
n8n 설치 파일 다운로드
- 이제 n8n의 최신 버전을 Docker로 가져오는 명령어를 실행합니다.
- 아래 코드를 복사해서 터미널에 붙여넣고 Enter 키를 누르세요.
docker pull n8nio/n8n:latest
- 설치에 필요한 파일들을 다운로드하는 과정이 진행됩니다.
n8n AI 스타터 킷 다운로드
- 다음으로, n8n에서 AI 기능을 바로 사용할 수 있도록 미리 구성된 '스타터 킷'을 다운로드합니다.
- 터미널에 아래 명령어를 입력하세요. git이라는 프로그램을 사용하는데, 만약 설치되어 있지 않다면 Mac이 자동으로 설치 안내를 해줄 겁니다.
git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git
- 스타터 킷 설치가 완료되면 n8n 폴더 안에 self-hosted-ai-starter-kit라는 새로운 폴더가 생깁니다.
명령줄 개발자 도구 설치
- 혹시 터미널에 invalid active developer path와 같은 에러 메시지가 표시되었나요?
- 이는 Mac에서 git과 같은 개발자 도구를 사용하기 위한 준비가 되지 않았다는 의미입니다.
- 아래 명령어를 터미널에 입력해 필요한 '명령줄 개발자 도구'를 설치해 주세요.
xcode-select --install- 설치가 완료되면 이전 작업을 다시 재개해 주세요.
설정 파일 준비 및 실행
- 이제 다운로드한 AI 스타터 킷 폴더로 이동해서 실행 준비를 마쳐야 합니다.
- 아래 명령어를 한 줄씩 터미널에 입력하고 Enter를 눌러주세요.
- 한 작업이 완료되면 다음 명령어를 입력하고 Enter를 눌러주세요.
1) 폴더로 이동
cd self-hosted-ai-starter-kit
2) 환경 설정 파일 복사: (예시 설정 파일을 실제 설정 파일로 복사하는 과정입니다.)
cp .env.example .env
3) n8n 실행: (드디어 마지막 단계입니다!)
docker compose up- 터미널에 여러 줄의 로그가 올라가면서 n8n이 실행됩니다. 이 터미널 창은 닫지 말고 그대로 두세요.
설치 완료
모든 설치가 끝났습니다.
웹 브라우저를 열고 주소창에 http://localhost:5678을 입력해 보세요.
n8n 시작 화면이 여러분을 맞이할 겁니다.
댓글