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

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 Window. 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 window 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 MacOS và Cài đặt N8n trên Ubuntu.

Cài đặt N8n trên window

Đối với Windows, hãy đảm bảo rằng các bạn đang sử dụng phiên bản Window 10 trở lên. Hiện tại Node 16 trở lên không hỗ trợ win 7, win 8 hay các phiên bản thấp cấp hơn, đối với những bản windows 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 Window 10 để 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 Windows, bạn không dùng bản chính thức cho Linux/macOS mà sử dụng bản nvm-windows – một bản build được phát triển riêng cho Windows.

Tải NVM cho Windows

1. Truy cập trang GitHub của nvm-windows: 👉 https://github.com/coreybutler/nvm-windows/releases
2. Tải file cài đặt .exe mới nhất (thường là nvm-setup.exe). Bạn có thể click vào link sau để tải về phiên bản 1.2.2: link

Cài đặt NVM

1. Chạy file nvm-setup.exe vừa tải.
2. Làm theo hướng dẫn trên màn hình:
   • Chọn thư mục cài đặt cho NVM.
   • Chọn thư mục nơi các phiên bản Node.js sẽ được lưu.
   • Nhấn Next và cài đặt.

Kiểm tra cài đặt

Mở Command Prompt hoặc PowerShell bằng cách bấm phím Windows + R gõ “cmd” rồi bấm phím enter hoặc gõ vào ô search tìm kiếm Command Promt hoặc PowerShell trong menu start

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

Các thông tin này để chạy local nên các bạn nhớ là được. Nếu các bạn quên hoặc muốn setup lại thì các bạn có thể xóa file database.sqlite và config trong thư mục

C:\Users\tên tài khoản đang sử dụng windows\.n8n

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.