Immich

1. Immich là gì?

Immich là phần mềm tự dựng kho ảnh và video của riêng bạn, giống Google Photos hay iCloud Photos nhưng chạy trên máy tính bạn sở hữu (máy tính để bàn, laptop cũ, NAS hoặc máy chủ mini). Điện thoại tự sao lưu ảnh lên kho này, bạn xem lại trên điện thoại hoặc trình duyệt, tìm ảnh theo người, địa điểm, nội dung ("bãi biển", "con mèo"), tạo album và chia sẻ với gia đình.

Phần mềm miễn phí và mã nguồn mở (giấy phép AGPL-3.0). Ảnh nằm trên ổ cứng của bạn, không bị tính tiền theo dung lượng. Đổi lại, bạn tự chịu trách nhiệm sao lưu: nếu ổ cứng hỏng mà không có bản dự phòng thì ảnh mất. Chính nhóm phát triển cũng cảnh báo phải sao lưu theo quy tắc 3-2-1 (3 bản, 2 loại thiết bị, 1 bản để ở nơi khác).

Immich vốn làm cho người quen dựng máy chủ, nên bước cài đặt cần Docker (công cụ chạy phần mềm đóng gói sẵn). Với người mới, cài xong lần đầu mất khoảng 30–60 phút.

Hợp với bạn nếu:

• Bạn đang trả tiền thuê dung lượng Google Photos hoặc iCloud và muốn giữ ảnh trên ổ cứng của mình.
• Bạn có một máy tính hay NAS có thể bật thường xuyên, còn dung lượng ổ cứng.
• Bạn chấp nhận học vài thao tác dòng lệnh và tự lo sao lưu.

Chưa hợp nếu:

• Bạn chỉ cần vài GB ảnh. Gói miễn phí của dịch vụ có sẵn sẽ đỡ công hơn.
• Bạn không có máy nào bật thường xuyên được, hoặc không muốn chịu trách nhiệm giữ dữ liệu.

2. Cần chuẩn bị gì?

Theo tài liệu chính thức (docs.immich.app, mục Requirements):

Mục	Yêu cầu
Hệ điều hành	Khuyến nghị Linux 64-bit (Ubuntu, Debian…). Windows cần Docker Desktop hoặc WSL 2, macOS cần Docker Desktop. Hệ không phải Linux không được khuyến khích bằng
RAM	Tối thiểu 6 GB, khuyến nghị 8 GB. Tắt tính năng máy học thì chạy được trên máy 4 GB
CPU	Tối thiểu 2 nhân, khuyến nghị 4 nhân; amd64 hoặc arm64. Từ bản 3, CPU amd64 cần mức x86-64-v2 (đa số CPU từ khoảng năm 2012)
Ổ cứng	Chỗ lưu ảnh đủ lớn (thumbnail và video chuyển mã làm thư viện nặng thêm khoảng 10–20%). Cơ sở dữ liệu nặng khoảng 1–3 GB, nên đặt trên ổ SSD gắn trực tiếp, không đặt trên ổ mạng
Phần mềm	Docker, gồm lệnh docker compose (Docker Engine v25 trở lên)

Không cần tài khoản trả phí, không cần khóa API.

Lưu ý cho Windows: tài liệu ghi rõ cơ sở dữ liệu không được nằm trên ổ định dạng NTFS hoặc FAT32, và không dùng thư mục /mnt của WSL. Người mới nên cài trên Linux (laptop cũ chạy Ubuntu là lựa chọn dễ nhất) hoặc làm đúng phần Windows trong tài liệu chính thức.

Cài Docker (chọn một):

• Windows / macOS: tải Docker Desktop tại https://docs.docker.com/desktop/ rồi cài như một ứng dụng bình thường.
• Ubuntu / Debian: làm theo https://docs.docker.com/engine/install/ .

3. Cài đặt từng bước

Các lệnh dưới đây lấy từ trang cài đặt chính thức (https://docs.immich.app/install/docker-compose). Chưa từng dùng dòng lệnh thì xem khung "Chưa từng dùng dòng lệnh?" ở trên trang.

Bước 1: Tạo thư mục và tải hai file cấu hình

Mở Terminal (Linux/macOS) hoặc PowerShell (Windows) rồi gõ lần lượt:

mkdir ./immich-app
cd ./immich-app
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

Nếu máy báo không có wget (thường gặp trên Windows và macOS), tải thẳng hai địa chỉ trên bằng trình duyệt, lưu file thứ nhất tên docker-compose.yml, file thứ hai tên .env, vào thư mục immich-app.

Thấy gì thì là đúng: trong thư mục immich-app có hai file docker-compose.yml và .env.

Bước 2: Sửa file .env

Mở file .env bằng trình soạn văn bản, chỉnh 3 chỗ:

• UPLOAD_LOCATION: thư mục sẽ chứa ảnh và video của bạn. Đặt ở ổ còn nhiều chỗ trống.
• DB_PASSWORD: đổi mật khẩu cơ sở dữ liệu khỏi giá trị mặc định postgres. Chỉ dùng chữ cái và số (A–Z, a–z, 0–9).
• TZ: bỏ dấu # ở đầu dòng và ghi múi giờ, ví dụ Asia/Ho_Chi_Minh.

Lưu file lại.

Bước 3: Khởi động

Đang ở trong thư mục immich-app, gõ:

docker compose up -d

Lần đầu máy sẽ tải các thành phần về, mất vài phút tùy mạng. Gõ docker compose (có dấu cách), không phải docker-compose: bản cũ không được hỗ trợ.

Thấy gì thì là đúng: các dòng trạng thái báo các thành phần đã chạy (Started/Healthy) và lệnh trả lại dấu nhắc.

4. Dùng lần đầu

1. Mở trình duyệt, vào http://<địa chỉ IP của máy>:2283 (mở ngay trên máy đó thì dùng http://localhost:2283). Cổng là 2283.
2. Bấm Getting Started và tạo tài khoản. Người đăng ký đầu tiên là quản trị viên.
3. Cài ứng dụng Immich trên điện thoại (Google Play, App Store; các nguồn khác xem https://docs.immich.app/install/post-install ).
4. Mở ứng dụng, ở ô địa chỉ máy chủ nhập http://<địa chỉ IP của máy>:2283 rồi đăng nhập bằng tài khoản vừa tạo. Điện thoại phải cùng mạng Wi-Fi với máy chạy Immich.
5. Vào màn hình sao lưu của ứng dụng, chọn các album muốn sao lưu và bật sao lưu. Ảnh bắt đầu chuyển về kho của bạn.

Muốn thêm người nhà: quản trị viên vào Administration > Users và bấm Create user.

Lưu ý: địa chỉ dạng 192.168.x.x chỉ dùng được trong nhà. Muốn xem ảnh khi ở ngoài cần thêm cách truy cập từ xa, phần này phức tạp hơn nhiều; hãy đọc tài liệu chính thức trước khi mở máy ra Internet.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
docker: command not found hoặc docker compose không nhận	Chưa cài Docker, hoặc bản quá cũ	Cài Docker theo mục 2; dùng docker compose (có dấu cách), cần Docker Engine v25 trở lên
Trình duyệt không vào được :2283	Container chưa chạy xong, sai địa chỉ IP, tường lửa chặn	Chạy docker compose ps xem các container đã chạy chưa, kiểm tra lại IP của máy, mở cổng 2283
Lỗi cơ sở dữ liệu hoặc permission denied lúc khởi động	Cơ sở dữ liệu đặt trên ổ mạng, NTFS/FAT32 hoặc thư mục sai quyền	Đặt dữ liệu trên ổ trong máy, định dạng kiểu Linux (ext4…), đúng như phần Requirements
Máy chậm, treo, container tự tắt	Thiếu RAM (dưới 6 GB)	Đóng bớt ứng dụng, hoặc tắt máy học theo tài liệu để chạy được trên 4 GB
Điện thoại không kết nối được máy chủ	Khác mạng Wi-Fi, nhập thiếu http:// hoặc :2283	Cho điện thoại cùng Wi-Fi với máy chủ, nhập đủ http://IP:2283

6. Gỡ cài đặt / cập nhật

Cập nhật. Trước khi cập nhật, đọc ghi chú phát hành của bản mới (https://github.com/immich-app/immich/releases) vì có thể có thay đổi phá vỡ tương thích, và sao lưu cơ sở dữ liệu. Nên cập nhật ứng dụng điện thoại trước rồi mới cập nhật máy chủ. Trong thư mục immich-app chạy:

docker compose pull && docker compose up -d

Muốn dọn các bản cũ cho đỡ tốn ổ cứng:

docker image prune

Immich không hỗ trợ hạ xuống bản cũ, kể cả trong cùng một bản phụ.

Gỡ cài đặt. Trong thư mục immich-app chạy docker compose down để dừng và gỡ các container. Ảnh của bạn vẫn nằm ở thư mục UPLOAD_LOCATION và dữ liệu cơ sở dữ liệu ở vị trí đặt trong .env. Chỉ xóa hai nơi đó khi bạn đã chép ảnh ra chỗ khác.

7. Câu hỏi hay gặp

Có mất tiền không? Phần mềm miễn phí. Bạn chỉ tốn tiền máy, ổ cứng và điện.

Máy yếu có chạy được không? Tối thiểu 2 nhân CPU và 6 GB RAM; máy 4 GB chỉ chạy được khi tắt tính năng máy học.

Có cần mạng không? Cần mạng để tải lúc cài và cập nhật. Trong nhà, điện thoại chỉ cần cùng Wi-Fi với máy chủ.

Thử trước khi cài được không? Có bản demo tại https://demo.immich.app (tài khoản demo ghi trong README chính thức), để xem giao diện trước khi bỏ công dựng máy.

Ảnh của tôi nằm ở đâu? Trên ổ cứng của máy bạn dựng, tại thư mục UPLOAD_LOCATION. Vì thế chuyện sao lưu là việc của bạn.