Lỗi UniFi Controller không khởi động do: ổ cứng hệ thống đầy, Java/UniFi cài hỏng hoặc cũ. Gặp trên Windows, Linux, Mac, Raspberry Pi. Trước khi sửa, đảm bảo Network type là Private hoặc Domain.
Cách 1: Kill process UniFi trong Task Manager
- Đóng UniFi Controller.
- Task Manager (Win+X) → Processes tab → End tất cả process: UniFi, Java, MongoD.
- Mở lại UniFi (có thể chờ lâu do rebuild dependencies).
Cách 2: Dọn ổ cứng hệ thống (C:)
UniFi cần dung lượng trống. Dọn rác ổ C:, mở lại UniFi.
Cách 3: Đổi Storage Engine trong system.properties
Nếu database dùng mmapv1 nhưng config wiredTiger → lỗi. Buộc dùng mmapv1:
- Mở File Explorer →
%USERPROFILE%\Ubiquiti UniFi\data
- Mở system.properties bằng Notepad, thêm dòng cuối:
db.extraargs=--storageEngine=mmapv1
- Lưu, thoát, mở UniFi.
Cách 4: Dùng user profile không có ký tự đặc biệt
Đường dẫn chứa ký tự đặc biệt (VD: C:\Users\ÄçìÞôñçò\...) gây lỗi. Tạo user Windows mới không dấu, chuyển dữ liệu sang.
Cách 5: Giải phóng port 8080
UniFi dùng port 8080 mặc định. Clean boot để tìm chương trình chiếm port, hoặc đổi port UniFi.
Cách 6: Đổi tên file Log
- Đóng UniFi, kill process (Cách 1).
- Vào
%USERPROFILE%\Ubiquiti UniFi\logs\
- Đổi tên file log (thêm .old), đặc biệt mongod.log và server.log. Mở UniFi.
Cách 7: Xóa file Journal
- Đóng UniFi, kill process.
- Vào
%USERPROFILE%\Ubiquiti UniFi\data\db\journal
- Backup toàn bộ file, xóa hết, restart máy, mở UniFi.
Cách 8: Cài UniFi chạy as Service
- Đóng UniFi, kill process. Thêm Java path vào Environment Variables:
C:\Program Files(x86)\Java\jre7\bin\javaw.exe
- Mở CMD Admin:
cd "%UserProfile%\Ubiquiti UniFi\"
java -jar lib\ace.jar installsvc
(khi hiện "Complete Installation")java -jar lib\ace.jar startsvc
- Kiểm tra Services tab Task Manager có "UniFi" running. Truy cập IP controller.
Cách 9: Cập nhật Java mới nhất
- Search "Java" → Configure Java → tab Update → Update Now.
- Kiểm tra UniFi.
Cách 10: Cài lại Java
- Đóng UniFi, kill process, gỡ service nếu có.
- Control Panel → Uninstall a Program → gỡ Java → restart.
- Tải Java 64-bit mới nhất, cài (cho phép Firewall). Mở UniFi.
Cách 11: Cài lại UniFi Network Controller
- Đóng UniFi, kill process. Backup config
%userprofile%\Ubiquiti UniFi\data\backup
(file .unf). - Control Panel → gỡ UniFi (chọn No khi hỏi keep settings).
- Xóa thư mục
%userprofile%\Ubiquiti UniFi
- Gỡ Java (Cách 10).
- Cài UniFi mới nhất, restore config từ file .unf backup.