Bắt đầu sử dụng | Nextvision Status

Yêu cầu

Docker Compose v2; hoặc Go 1.26.4 và Node 24 để phát triển trực tiếp. Bản build local có MinIO cần tối thiểu khoảng 4 CPU và 8 GiB RAM.

Chạy local

Tại thư mục gốc:

cp .env.example .env
docker compose --profile demo up --build -d

Lần đầu hệ thống build MinIO từ mã nguồn được cố định revision. PostgreSQL, Redis, MinIO và Mailpit chỉ mở cổng loopback. Profile demo tạo workspace có nhãn local demo; chỉ dữ liệu mẫu này được bỏ qua xác minh công ty.

Mở app tại http://localhost:3400, docs tại http://localhost:4321, email thử tại http://localhost:18025. Tài khoản demo: owner@demo.nextvision.example, mật khẩu lấy từ DEMO_PASSWORD trong .env.

Monitor demo thực sự kiểm tra https://example.com. Trạng thái ban đầu là Unknown; sau hai lần thành công chuyển Operational. Không tạo lịch sử uptime giả.

Tạo workspace thật

Chạy Compose không có profile demo. Đăng ký email công ty, xác minh email, rồi thêm DNS TXT tại _nextvision-status.domain-cua-ban bằng giá trị dashboard cung cấp. Bấm kiểm tra DNS để kích hoạt.

Tạo trang status, component, probe; lưu token một lần rồi tạo monitor gắn probe. Mời thành viên bằng email thuộc domain đã xác minh.

Phát triển trực tiếp

Chạy PostgreSQL/Redis/MinIO/Mailpit bằng Compose. Nạp cấu hình từ .env đáng tin cậy, chạy go run ./cmd/status migrate, sau đó chạy các mode api, worker, delivery ở terminal riêng. Frontend chạy bằng npm --prefix apps/web run dev.

Dừng

docker compose down giữ dữ liệu trong named volume. Xóa volume sẽ xóa dữ liệu local.