ติดตั้ง local: Docker และ Node

เตรียม source และ secrets

ต้องมี Git และใช้โฟลเดอร์ใหม่ คำสั่งนี้เป็น Bash บน PowerShell เปลี่ยน cp เป็น Copy-Item หรือเลือก shell ในหน้าติดตั้ง

git clone --branch v1.0.0 https://github.com/raptercode/dashboard-portal-control.git
cd dashboard-portal-control
cp .env.example .env

ตั้ง HOSTMGR_ADMIN_PASSWORD เป็นรหัสเฉพาะอย่างน้อย 12 ตัวอักษร และ HOSTMGR_SECRET_KEY เป็น Base64 key ขนาด 32 bytes ที่สร้างขึ้น คงค่า demo อื่นไว้

openssl rand -base64 32
nano .env

Docker Compose

ต้องมี Docker Engine/Desktop, Compose v2 และพอร์ต 80 ว่าง Image ใช้ Node 24.18.0 และไม่ได้มี runtime ของแอปทุกชนิด

docker compose up --build -d
docker compose ps

เปิด http://localhost ข้อมูลอยู่ใน hostmgr-data หยุดด้วย docker compose down โดยไม่ใส่ -v หากต้องการเก็บข้อมูล Compose เปิด 80:3000 จึงควรใช้ HTTP demo ในเครือข่ายพัฒนาที่ไว้ใจ การ clone/build อาจรันโค้ดจริงในคอนเทนเนอร์ แต่ activate host ไม่ได้

รันตรงด้วย Node.js

เริ่มต้นด้วย Node 24 ช่วงที่รองรับคือ 20.20.2–20.x, 22.13–22.x, 24.x และ 26.x โดย Node 20 ต้องใช้ better-sqlite3 และอาจต้องมี build tools

node --version
npm ci
npm run demo

เปิด http://127.0.0.1:3000 ค่า HOSTMGR_SANDBOX_CLONE=false ใน .env จำลอง sync/deploy เปลี่ยนเป็น true เฉพาะ source ที่ไว้ใจ เพราะ clone/build บนเครื่องคุณ หยุดด้วย Ctrl+C หากลืมรหัสให้หยุด demo ก่อนรัน npm run demo:reset-password รหัสใหม่แสดงครั้งเดียวและยกเลิก sessions เดิม