Hướng dẫn khôi phục Home Assistant trên CasaOS bằng cách bung Backup thủ công

Khi khôi phục Home Assistant (HASS) trên CasaOS, đôi khi bạn sẽ gặp lỗi “Invalid Format” khi upload file backup `.tar` trực tiếp qua giao diện web. Điều này thường xảy ra do file backup quá lớn hoặc do lỗi đường truyền. Giải pháp hiệu quả nhất lúc này là bypass qua giao diện Restore và tiến hành “bung” file backup thủ công trực tiếp vào thư mục dữ liệu của Docker. Bài viết này sẽ hướng dẫn bạn cách làm điều đó.

Quy trình thực hiện

Phương pháp này yêu cầu bạn có quyền truy cập vào File System của CasaOS và sử dụng một chút dòng lệnh (Terminal). Trước khi bắt đầu, hãy đảm bảo bạn đã cài đặt một bản HASS mới từ App Store của CasaOS.

1. Trích xuất dữ liệu gốc trên máy tính:
   Dùng phần mềm nén như WinRAR hoặc 7-Zip mở file backup tổng mà bạn tải về. Tìm sâu vào bên trong đến khi thấy file homeassistant.tar.gz. Giải nén file này ra một thư mục tạm trên máy tính của bạn. Bạn sẽ thấy các thư mục cấu hình quan trọng như custom_components, .storage và file configuration.yaml.
2. Thay thế dữ liệu trên CasaOS:
   Mở ứng dụng Files trên CasaOS và truy cập vào đường dẫn lưu trữ của Home Assistant (thường là: /DATA/AppData/big-bear-home-assistant/config). Xóa sạch toàn bộ nội dung hiện có (đây là dữ liệu trắng của bản cài mới) và tiến hành Upload toàn bộ các file/thư mục bạn đã giải nén ở Bước 1 vào đây.
3. Cấp quyền truy cập (Terminal):
   Vì chúng ta vừa upload file thủ công, Docker Container có thể sẽ bị lỗi không đọc được dữ liệu do sai quyền sở hữu. Hãy mở Terminal của CasaOS và chạy câu lệnh sau để “mở khóa” toàn bộ thư mục cấu hình:

sudo chmod -R 777 /DATA/AppData/big-bear-home-assistant/config

Cuối cùng, quay lại Dashboard CasaOS, nhấn vào dấu 3 chấm tại App Home Assistant và chọn Restart. Hệ thống sẽ tự động nhận diện dữ liệu cũ và khởi động lại với đầy đủ thiết bị, automation và giao diện quen thuộc của bạn.