Self-hosting guide

Cài Codexdentist tại phòng khám

Hướng dẫn này dành cho một máy Windows, Linux hoặc NAS luôn bật trong mạng nội bộ. Các máy khác chỉ cần trình duyệt.

Cài đặt nhanh

Máy chủ cần Git, Node.js 22 LTS và Docker Desktop hoặc Docker Engine.

git clone <repository-url>
cd codexdentist
./install.sh

# Windows PowerShell: .\install.ps1

Trình cài sẽ tạo `.env.selfhost`, sinh khóa bảo mật, dựng ứng dụng và chờ PostgreSQL sẵn sàng trước khi chạy migration.

Thiết lập lần đầu

Mở http://127.0.0.1:3000/setup trên máy chủ. Tạo tên phòng khám, tài khoản Chủ hệ thống và mật khẩu đầu tiên. Trang này tự khóa sau khi tổ chức đầu tiên được tạo.

Truy cập trong mạng LAN

Chạy lệnh doctor để xem địa chỉ LAN. Điện thoại và máy tính phải dùng cùng Wi-Fi với máy chủ.

npm run codexdentist -- doctor

Lệnh vận hành

Cài đặtnpm run codexdentist -- install

Khởi độngnpm run codexdentist -- start

Kiểm tranpm run codexdentist -- doctor

Sao lưunpm run codexdentist -- backup

Cập nhậtnpm run codexdentist -- update

Sao lưu và phục hồi

Backup gồm PostgreSQL và thư mục tệp bệnh nhân. Mỗi lần cập nhật đều tạo backup trước khi thay image hoặc chạy migration.

npm run codexdentist -- backup
npm run codexdentist -- restore <backup-folder> --confirm

Nguyên tắc bảo mật

Không đưa `.env.selfhost` lên Git.
Sao lưu ra thiết bị khác máy chủ.
Không mở cổng PostgreSQL ra Internet.
Dùng HTTPS khi truy cập từ bên ngoài mạng LAN.

Mã nguồn và đóng góp

Dự án sử dụng giấy phép AGPL-3.0-or-later. Bản triển khai sửa đổi được cung cấp qua mạng phải giữ quyền truy cập mã nguồn tương ứng.

Repository công khai đang được chuẩn bị cho bản beta đầu tiên.