#021026: Hướng dẫn update lastest version cho n8n self-host
Bạn đang sử dụng n8n self-host trên Docker và muốn cập nhật lên phiên bản mới mà không làm mất workflow, credentials hay dữ liệu hiện có? Bài viết này sẽ hướng dẫn bạn từng bước update n8n self-host thông qua Docker và GitHub. Hướng dẫn được trình bày trực quan, phù hợp với Marketer, người làm Automation và người mới bắt đầu sử dụng n8n self-host, giúp bạn chủ động cập nhật phiên bản n8n và duy trì hệ thống automation của mình mà không cần cài đặt lại từ đầu.
Đối tượng phù hợp với bài viết
- Marketer đang sử dụng n8n để tự động hóa các tác vụ Marketing, dữ liệu và vận hành.
- Người đang sử dụng n8n self-host bằng Docker và cần nâng cấp lên phiên bản mới mà không phải cài đặt lại từ đầu.
- Người mới làm quen với Docker và n8n, cần một hướng dẫn trực quan để thực hiện quá trình update.
Cần chuẩn bị
- Đã biết cài đặt và sử dụng VS Code, Docker, n8n self-host tại các bài:
Mục tiêu bài viết
- Biết cách update n8n cho phiên bản self-host của mình mà không ảnh hưởng đến các Credential, Workflows,….
Bước 1: Kiểm tra phiên bản n8n đang sử dụng
Trên giao diện n8n self-host, truy cập Help ở thanh menu bên trái. Trong menu Help, chọn Update để kiểm tra phiên bản n8n hiện tại.
Nếu mục Update xuất hiện biểu tượng chấm than và thông báo “Update (1 version behind)”, điều đó cho biết phiên bản n8n đang sử dụng đã cũ hơn phiên bản mới nhất và cần được cập nhật.
Lưu ý: Trước khi tiến hành update, nên kiểm tra và sao lưu dữ liệu n8n, đặc biệt là workflow, credentials và database, để hạn chế rủi ro trong quá trình nâng cấp.
Bước 2: Tìm image n8n chính thức trên Docker Hub
Để cập nhật n8n self-host, trước tiên cần truy cập Docker Hub trong Docker Desktop và tìm kiếm image n8n.
Tại ô tìm kiếm, nhập n8n. Trong danh sách kết quả, chọn image chính thức n8nio/n8n — đây là Docker image được n8n cung cấp để triển khai n8n.
Sau khi tìm thấy n8nio/n8n, bạn có thể kiểm tra tag/version mới nhất để chuẩn bị cập nhật phiên bản n8n đang chạy trên máy.
Lưu ý: Nên sử dụng đúng image n8nio/n8n thay vì các image n8n do bên thứ ba cung cấp.
Bước 3: Pull phiên bản n8n mới nhất
Tại trang n8nio/n8n trên Docker Hub, kiểm tra mục Tag và chọn phiên bản muốn cập nhật. Trong trường hợp này, có thể để latest để Docker Desktop lấy phiên bản n8n mới nhất.
Sau đó, nhấn Pull để Docker Desktop bắt đầu tải image n8n phiên bản mới về máy.
Quá trình này chỉ cập nhật Docker image; container n8n đang chạy chưa được thay thế ngay. Ở bước tiếp theo, chúng ta sẽ sử dụng image mới này để recreate/update container mà vẫn giữ lại dữ liệu n8n thông qua volume đã cấu hình.
Bước 4: Cập nhật n8n từ Docker Compose
Sau khi đã Pull phiên bản n8n mới nhất từ Docker Hub, quay lại VS Code – nơi đang lưu file compose.yaml của n8n self-host.
Tại giao diện compose.yaml, chọn Run All Services để Docker Compose khởi động lại toàn bộ các service theo cấu hình hiện tại. Trong quá trình này, Docker sẽ sử dụng image n8nio/n8n vừa được Pull để cập nhật n8n lên phiên bản mới.
Hãy chờ quá trình chạy hoàn tất và kiểm tra Terminal để đảm bảo các container đã được khởi động thành công.
Lưu ý: Không nên xóa volume n8n_data trong quá trình update. Volume này chứa dữ liệu quan trọng của n8n như workflow, credentials và các thiết lập của instance.
Bước 5: Kiểm tra và hoàn tất cập nhật
Sau khi Run All Services hoàn tất, quay lại giao diện n8n và refresh trình duyệt để tải lại instance.
Tiếp tục vào Help để kiểm tra trạng thái phiên bản. Nếu thông báo Update hoặc biểu tượng cảnh báo đã biến mất, điều đó cho thấy n8n đã được cập nhật lên phiên bản mới và instance đang chạy bình thường.
Bạn cũng có thể kiểm tra lại các Workflows, Credentials và dữ liệu để đảm bảo mọi thành phần vẫn hoạt động sau khi cập nhật.
🎉 Chúc mừng! Bạn đã hoàn tất quá trình update n8n self-host bằng Docker.
Chúc bạn cài đặt thành công!
Xem thêm các bài viết khác tại tại: https://minhngo.vn/blog/
