Bắt đầu nhanh

Trang này dành cho người đã quen Docker — dựng Petnaly Community (mã nguồn mở AGPL-3) trên máy của bạn trong vài phút. Chưa từng dùng Docker? Theo bản đầy đủ từng bước tại Tự cài bản Community.

Chỉ muốn dùng, không muốn dựng máy chủ?

Petnaly Cloud do BSD vận hành — không cài đặt, không sao lưu, không nâng cấp thủ công. Xem các gói tại petnaly.com. Trang này dành cho ai muốn tự vận hành.

Yêu cầu

Cần cài sẵn Docker và Docker Compose. Chạy trên Odoo Community 19 + PostgreSQL. Máy cần khoảng 4 GB RAM trống.

Cài đặt

1. Clone và chạy — kho đã có sẵn docker-compose.yml, không phải tạo file gì:

   git clone https://github.com/bsdinsight/petnaly.git
   cd petnaly
   docker compose up -d

   Lần đầu mất khoảng 1–3 phút để Docker tải ảnh về. Kho gồm 10 module Petnaly, toàn bộ AGPL-3 — không có module trả phí, không khoá tính năng.

2. Mở http://localhost:8069 — Odoo hiện màn hình tạo database. Điền:

   Ô	Điền gì
   Master Password	Lấy trong file odoo.conf (dòng admin_passwd)
   Database Name	Ví dụ petnaly
   Email	Tài khoản quản trị của bạn
   Password	Bạn tự đặt — đặt mạnh ngay từ đầu

   Không có mật khẩu mặc định

   Petnaly không ship bất kỳ mật khẩu đăng nhập mặc định nào. Mật khẩu quản trị là do bạn chọn ở màn hình này — không có chuyện quên đổi.

3. Cài phân hệ — vào Apps, cài Petnaly: Core, rồi Petnaly: Dog. Xong.

   Petnaly: Core hiện sẵn trong Apps. 8 phân hệ còn lại phải xoá bộ lọc “Apps” mới thấy (chúng là phần mở rộng, không phải app độc lập).

Trước khi đưa lên máy chủ có internet

Compose gắn cổng vào 127.0.0.1 — bản clone mới chỉ máy bạn vào được, an toàn để thử. Nhưng master password mặc định nằm công khai trên GitHub, ai cũng đọc được — nó bảo vệ quyền tạo/xoá/sao lưu database. Đổi admin_passwd trong odoo.conf TRƯỚC khi mở ra mạng ngoài. Xem Đổi mật khẩu & bảo mật.

Cài thêm phân hệ

Sau Petnaly: Core + Petnaly: Dog, bật thêm trong Apps → xoá bộ lọc Apps → tìm petnaly → Activate:

Module	Dùng để
petnaly_pedigree	Phả hệ nhiều đời + số đăng ký kennel-club
petnaly_breeding_core	Chu kỳ động dục, phối giống, thai kỳ, lứa đẻ
petnaly_health	Chấm điểm hông/khuỷu, panel DNA, cảnh báo điều kiện nhân giống
petnaly_buyer_sale	Người mua, đặt chỗ, đặt cọc, theo dõi bán
petnaly_customer_followup	Chăm sóc khách tự động sau bán
petnaly_compliance_au	Tuân thủ luật nhân giống theo bang của Úc
petnaly_dog_knowledge	Kiến thức giống: giai đoạn sống, dinh dưỡng, sinh sản
petnaly_kb	Thư viện giống, cẩm nang chăm sóc cho chủ thú

Quản lý: tắt, bật lại, xem log

Mở Terminal trong thư mục đã clone rồi dùng:

Việc	Lệnh
Tắt (dừng Petnaly)	docker compose down
Bật lại	docker compose up -d
Xem có đang chạy không	docker compose ps
Xem log (khi gặp lỗi)	docker compose logs -f

Mẹo

docker compose down chỉ dừng, không xoá dữ liệu — dữ liệu nằm trong Docker volume, bật lại là còn nguyên. Muốn cập nhật phiên bản mới: git pull trong thư mục đã clone, rồi nâng cấp module theo cách chuẩn của Odoo (cờ -u). Cổng 8069 đã bị máy khác dùng? Tạo file .env cạnh docker-compose.yml với ODOO_PORT=8070.

Bản Community gồm những gì

Toàn bộ nghiệp vụ — phả hệ và hệ số cận huyết (COI), nhân giống, sức khoẻ di truyền, người mua, tuân thủ luật Úc. Mã nguồn AGPL-3: không khoá tính năng, không phí license — clone về, chạy trên máy chủ của bạn, giữ vĩnh viễn.

Các gói trả phí đều nằm trên Cloud (BSD lo hạ tầng, sao lưu, cập nhật và mở đăng tin marketplace) — xem petnaly.com.

Tiếp theo

Tự cài bản Community (đầy đủ) Hướng dẫn từng bước cho người mới + các gói Cloud.

Hướng dẫn sử dụng Phả hệ & COI, nhân giống, sức khoẻ, người mua.