Chạy HomeDash trên Linux: dashboard nhẹ cho HomeLab

HomeDash là dashboard Java dùng để gom thông tin các dịch vụ và máy chủ trong HomeLab. Bài này giữ đầy đủ command và trình tự của tutorial i12bretro, nhưng dùng quy trình lấy release qua GitHub API thay vì đưa sẵn một binary vào repository.

Nguồn tham khảo: i12bretro – Run HomeDash on Linux. Video gốc thuộc kênh i12bretro trên YouTube.

Cài Java và Maven

1. Đăng nhập thiết bị Linux.
2. Cập nhật package list:

sudo apt update

3. Cài các bản cập nhật:

sudo apt upgrade -y

4. Cài JDK mặc định và Maven:

sudo apt install default-jdk maven -y

5. Kiểm tra Java:

java --version

6. Kiểm tra Maven:

mvn -version

Tải và chạy HomeDash

1. Tạo thư mục làm việc:

sudo mkdir /opt/homedash2 -p

2. Cấp owner thư mục cho user hiện tại:

sudo chown $USER:$USER /opt/homedash2 -R

3. Chuyển vào thư mục:

cd /opt/homedash2

4. Dùng GitHub API để tìm URL JAR release mới nhất:

regex='"browser_download_url": "(https:\/\/github.com\/lamarios\/Homedash2\/releases\/download\/[^/]*\/Homedash-[^/]*\.jar)"'response=$(curl -H "Accept: application/vnd.github.v3+json" https://api.github.com/repos/lamarios/Homedash2/releases/latest)[[ $response =~ $regex ]] && downloadURL="${BASH_REMATCH[1]}"

5. Tải JAR vào tên file cố định:

wget -O ./homedash.jar $downloadURL

6. Tạo file cấu hình:

java -jar ./homedash.jar -create-config

7. Chạy HomeDash với file cấu hình:

java -Dconfig.file=/opt/homedash2/homedash.properties -jar homedash.jar

8. Mở trình duyệt tới http://DNSorIP:4567.
9. Xác nhận trang HomeDash đã hiển thị.

Lưu ý vận hành: Không expose port 4567 trực tiếp ra Internet. Nếu cần truy cập từ xa, dùng VPN hoặc reverse proxy có authentication. Khóa quyền file homedash.properties, kiểm tra log, và tạo systemd unit sau khi đã xác nhận đúng phiên bản Java/JAR.

Nguồn và video

• Tutorial gốc: i12bretro 0904
• Video gốc: Run HomeDash on Linux
• HomeDash documentation/repository: lamarios/HomeDash2