Hướng dẫn N8n: Cài đặt N8n trên MacOS

Bạn có thể cài đặt N8n trên các thiết bị chạy bất kỳ hệ điều hành nào (Windows, MacOS, Linux, Ubuntu, CentOS). Trong khuôn khổ bài viết này tôi sẽ hướng dẫn các bạn cài đặt N8n phiên bản Community (miễn phí) trên các hệ thống Unix (MacOS). Các bạn hoàn toàn có thể cài đặt trên mọi hệ điều hành do phiên bản này có hỗ trợ Docker. Bài viết này tôi sẽ hướng dẫn các cài đặt theo hướng thông thường. Docker setup thường sẽ được sử dụng trên môi trường Production nhiều hơn.

Các bước cơ bản cài đặt N8n

Để cài đặt và chạy N8n trực tiếp trên máy tính macOS của các bạn chúng ta cần thực hiện các bước sau:

1. Cài đặt NodeJS với phiên bản phù hợp: Nhiều bạn cài đặt node xong nhưng sử dụng thì thấy không dùng được vì báo phiên bản Node không tương thích (Your Node.js version xx.x.x is currently not supported by n8n). Hiện tại theo thông tin tại file này thì N8n hỗ trợ các phiên bản từ 18.17 trở lên và đến bản 22. Với các phiên bản cao hơn hay thấp hơn N8n hiện chưa hỗ trợ.
2. Cài đặt N8n bằng câu lệnh
3. Mở vào giao diện N8n trên máy và tiến hành cài đặt tài khoản sử dụng

3 bước này cách thực hiện thì khác nhau trên mỗi hệ điều hành nhưng mục đích thì giống nhau. Các bạn hãy xem các phần ở dưới xem phần nào phù hợp với máy của các bạn nhất thì làm theo

Mời các bạn tham khảo thêm bài viết Cài đặt N8n trên Window và Cài đặt N8n trên Ubuntu.

Cài đặt N8n trên MacOS

Đối với MacOS, hãy đảm bảo rằng các bạn đang sử dụng phiên bản MacOS Catalina trở lên. Hiện tại Node 16 trở lên không hỗ trợ MacOS phiên bản thấp cấp hơn, đối với những bản MacOS thấp hơn các bạn sẽ cần phải cài đặt phức tạp hơn rất nhiều. N8n Academy khuyến cáo các bạn nên nâng cấp máy tính tối thiếu là lên phiên bản MacOS Catalina để quá trình cài đặt đơn giản và suôn sẻ hơn.

Bước 1: Cài đặt NodeJS qua NVM

NVM (Node Version Manager) là phần mềm quản lý các phiên bản của NodeJS, các bạn nên sử dụng nvm để có thể chuyển đổi sang các bản node một cách nhanh chóng mà không cần phải suy nghĩ gì

Để cài đặt NVM (Node Version Manager) trên MacOS, các bạn cần làm theo hướng dẫn sau

Mở Terminal

Bạn có thể mở Terminal bằng cách:

• Dùng Spotlight (Command + Space) và gõ Terminal, rồi Enter.

Cài đặt NVM

Chạy lệnh sau trong Terminal để cài nvm từ GitHub:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v1.2.2/install.sh | bash

Thêm vào file cấu hình shell

Sau khi cài xong, bạn cần thêm dòng sau vào file cấu hình shell:

Nếu bạn dùng zsh (mặc định với macOS mới):

nano ~/.zshrc

Nếu bạn dùng bash:

nano ~/.bash_profile

➡️ Thêm dòng sau vào cuối file:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

➡️ Lưu file: nhấn Control + O, Enter, rồi Control + X để thoát.

➡️ Sau đó, reload lại file:

source ~/.zshrc   # nếu bạn dùng zsh
# hoặc
source ~/.bash_profile  # nếu bạn dùng bash

Sau đó các bạn gõ

nvm version

Nếu thấy phiên bản hiển thị (ví dụ: 1.2.2), bạn đã cài thành công.

Cài Node.js bằng NVM

Ví dụ muốn cài Node.js v22:

nvm install 22

Sau đó chọn sử dụng phiên bản vừa cài:

nvm use 22

Bạn có thể kiểm tra phiên bản đang dùng:

node -v

Các bạn chỉ nên dùng các phiên bản ở trong giới hạn hiện tại của N8n là từ phiên bản 18.17 đến node 22. Nếu các bạn setup node 23 có thể việc cài đặt sẽ không thành công

Bước 2: Cài đặt N8n bằng câu lệnh

Phần này trên thực tế là nhẹ nhàng nhất, bạn chỉ cần dùng Command Promt gõ câu lệnh:

npm install n8n -g

Câu lệnh nói trên sẽ cài đặt N8n và cho phép các bạn gọi n8n ở bất kì đường dẫn nào. Việc cài đặt sẽ diễn ra hoàn toàn tự động và các bạn chỉ cần chờ khoảng 5 – 20 phút tùy vào kết nối mạng của bạn.

Sau khi các bạn cài đặt N8n xong, các bạn gõ câu lệnh sau đây thì hệ thống N8n sẽ được bật lên trên máy của các bạn

n8n

Lúc này hệ thống N8n sẽ được khởi động và chạy tại cổng 5678, các bạn có thể truy cập bằng cách mở địa chỉ

http://localhost:5678

Lúc này màn hình hướng dẫn sẽ hiện lên để các bạn setup hệ thống lần đầu

Bước 3: Cài đặt N8n để sử dụng lần đầu tiên

Khi các bạn truy cập vào N8n local lần đầu tiên, màn hình sau sẽ hiện lên

các bạn sẽ cần nhập các thông tin lần lượt như sau:

1. Địa chỉ email
2. Tên của bạn
3. Họ của bạn
4. Mật khẩu

Sau khi các bạn setup thành công các bạn đã có thể truy cập vào hệ thống N8n trên máy mình. Nếu có gặp màn hình này

Các bạn có thể chọn skip, mặc định khi cài đặt tại máy local, để sử dụng được 1 số chức năng trả phí sẽ khá phức tạp, bạn sẽ cần sử dụng 1 số chương trình như Nrok hoặc Cloudflare để dẫn hướng truy cập. Trong khuôn khổ bài viết này chúng tôi sẽ giới hạn chỉ trong nội dung cài đặt N8n.

Kết thúc cài đặt N8n

Khi đã đến bước này thì các bạn đã cài đặt N8n thành công rồi. Các bạn có thể tiếp tục đến chuỗi bài viết hướng dẫn về cách setup các template đầu tiền và cách chạy các workflow tại đây. Chúc các bạn thành công.