Nếu bạn đã từng tìm hiểu về n8n, chắc hẳn sẽ thấy rất nhiều hướng dẫn cài đặt khác nhau như cài bằng Node.js, Docker, hoặc chạy trên VPS.

Trong đó, Docker là cách được cộng đồng n8n khuyến nghị vì:

• Cài đặt nhanh.
• Dễ nâng cấp.
• Không lo xung đột thư viện.
• Có thể chuyển sang máy khác rất dễ.

Trong bài viết này, mình sẽ hướng dẫn bạn cài đặt n8n bằng Docker trên Windows từ đầu đến cuối, kể cả khi bạn chưa từng dùng Docker trước đây. Nếu bạn chưa tìm hiểu về n8n thì tham khảo bài n8n là gì? Hướng dẫn cho người mới bắt đầu

Docker là gì?

Docker là một nền tảng giúp chạy ứng dụng bên trong các Container.

Bạn có thể hiểu đơn giản:

Docker giống như một “chiếc hộp” chứa đầy đủ mọi thứ mà n8n cần để hoạt động.

Thay vì cài từng thành phần như:

• Node.js
• npm
• các package
• thư viện

thì Docker đã đóng gói tất cả sẵn.

Bạn chỉ cần chạy là dùng.

Vì sao nên cài n8n bằng Docker?

So với cài trực tiếp bằng Node.js, Docker có nhiều ưu điểm.

Nếu mục tiêu của bạn là:

• học n8n
• làm automation
• chạy AI Agent
• triển khai lâu dài

thì Docker là lựa chọn rất đáng cân nhắc.

Điều kiện trước khi cài

Máy tính nên có:

• Windows 10 hoặc Windows 11 (64-bit)
• RAM tối thiểu 8GB
• Khuyến nghị 16GB
• SSD còn trống khoảng 10GB

Nếu máy đã bật Virtualization trong BIOS thì quá trình cài sẽ thuận lợi hơn.

Bước 1: Cài Docker Desktop

Truy cập trang chính thức của Docker:

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

Tải bản dành cho Windows.

Sau khi tải xong:

• chạy file cài đặt
• nhấn Next
• Install
• Finish

Sau đó khởi động lại máy nếu được yêu cầu.

Bước 2: Khởi động Docker Desktop

Mở Docker Desktop.

Lần đầu khởi động có thể mất vài phút.

Nếu thấy giao diện như dưới đây nghĩa là Docker đã chạy thành công.

• Docker Engine Running

Hoặc biểu tượng con cá voi ở thanh Taskbar không còn quay.

Bước 3: Kiểm tra Docker

Mở Command Prompt hoặc PowerShell.

Gõ:

docker --version

Ví dụ:

Docker version 28.x.x

Tiếp tục kiểm tra:

docker compose version

Nếu có kết quả là thành công.

Bước 4: Tạo thư mục chứa n8n

Ví dụ:

D:\n8n

Bên trong tạo thêm thư mục:

D:\n8n\data

Thư mục này sẽ lưu:

• workflow
• credential
• cấu hình

Khi cập nhật Docker sẽ không bị mất dữ liệu.

Bước 5: Tạo file docker-compose.yml

Trong thư mục:

D:\n8n

Tạo file:

docker-compose.yml

Nội dung:

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n

    ports:
      - "5678:5678"

    volumes:
      - ./data:/home/node/.n8n

    environment:
      - TZ=Asia/Ho_Chi_Minh
      - N8N_SECURE_COOKIE=false

    restart: unless-stopped

Lưu lại.

Giải thích nhanh

image

n8nio/n8n:latest

Luôn tải phiên bản mới nhất.

ports

5678:5678

Cho phép truy cập:

http://localhost:5678

volumes

./data:/home/node/.n8n

Đây là phần rất quan trọng.

Toàn bộ dữ liệu của n8n sẽ lưu trong:

D:\n8n\data

Không bị mất khi cập nhật.

restart

unless-stopped

Docker sẽ tự khởi động lại n8n khi Windows bật.

Bước 6: Khởi chạy n8n

Mở Terminal ngay tại thư mục:

D:\n8n

Gõ:

docker compose up -d

Docker sẽ:

• tải image
• tạo container
• khởi động n8n

Lần đầu có thể mất vài phút.

Kiểm tra container

Gõ:

docker ps

Nếu thấy:

n8n

ở trạng thái:

Up

thì thành công.

Bước 7: Mở n8n

Truy cập:

http://localhost:5678

Lần đầu mở sẽ yêu cầu:

• tạo tài khoản Admin
• email
• mật khẩu

Sau khi hoàn tất sẽ vào giao diện chính của n8n.

Một số lệnh Docker thường dùng

Dừng n8n

docker compose stop

Khởi động lại

docker compose start

Xóa container

docker compose down

Lưu ý:

Dữ liệu vẫn còn vì đã lưu trong thư mục data.

Cập nhật n8n

docker compose pull

Sau đó:

docker compose up -d

Xem log

docker compose logs

Hoặc:

docker compose logs -f

Dữ liệu của n8n nằm ở đâu?

Toàn bộ dữ liệu sẽ nằm trong:

D:\n8n\data

Bao gồm:

• Workflow
• Credentials
• User
• Settings

Bạn chỉ cần sao lưu thư mục này.

Một số lỗi thường gặp

Docker Desktop không chạy

Nguyên nhân:

• Chưa bật Virtualization
• Chưa cài WSL2
• Hyper-V bị tắt

Giải pháp:

• Bật Virtualization trong BIOS
• Cài WSL2
• Cập nhật Docker Desktop

Không mở được localhost:5678

Kiểm tra:

docker ps

Nếu container đã dừng:

docker compose logs

để xem lỗi.

Cổng 5678 đã bị sử dụng

Có thể đổi thành:

ports:
  - "8080:5678"

Sau đó truy cập:

http://localhost:8080

Có nên dùng Docker hay Node.js?

Nếu bạn chỉ muốn trải nghiệm nhanh, cả hai cách đều hoạt động.

Tuy nhiên nếu muốn sử dụng lâu dài, Docker mang lại nhiều lợi ích hơn:

• Dễ sao lưu dữ liệu.
• Dễ cập nhật phiên bản.
• Hạn chế lỗi do môi trường.
• Thuận tiện khi chuyển sang máy khác hoặc triển khai lên VPS.

Với đa số người dùng, đặc biệt là người mới làm quen với n8n, Docker là lựa chọn đơn giản và ổn định hơn.

Kết luận

Cài đặt n8n bằng Docker trên Windows là phương pháp phù hợp nếu bạn muốn xây dựng một môi trường làm việc ổn định, dễ bảo trì và có khả năng mở rộng trong tương lai.

Chỉ với vài bước cài Docker Desktop, tạo file docker-compose.yml và chạy một lệnh docker compose up -d, bạn đã có thể bắt đầu khám phá thế giới tự động hóa với n8n.

Nếu mục tiêu của bạn là xây dựng AI Agent, tự động hóa công việc văn phòng hoặc triển khai các workflow chuyên nghiệp, Docker sẽ giúp quá trình vận hành và nâng cấp trở nên đơn giản hơn rất nhiều.

Các bài viết liên quan:

• Hướng dẫn tạo workflow đầu tiên trong n8n.
• Cách cài n8n trên Windows không cần Docker (Node.js) – Chi tiết từ A-Z
• Cách cập nhật n8n lên phiên bản mới.
• Cách sao lưu và khôi phục dữ liệu n8n.