การติดตั้ง

เริ่มแบบ local เพื่อสำรวจ แล้วใช้ release archive ที่ตรวจสอบแล้วบน host ที่รองรับ

สิ่งที่ต้องมี

  • Docker Engine + Docker Compose
  • หรือ Node.js 24.x สำหรับ direct demo (ไม่ต้อง npm install)
  • port 80 ในเครื่องว่างสำหรับ Docker sandbox

ลอง Docker sandbox

รัน Portal ใน container โดยไม่เปลี่ยน Nginx, systemd หรือ package ในเครื่องของคุณ

1

Clone และเตรียม .env

คัดลอก example file และสร้าง encryption key ที่ต้องใช้ต่อเนื่อง

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

ตั้งค่า owner credential

ตั้งรหัส owner 12+ ตัวอักษรและ secret key ที่สร้างไว้

openssl rand -base64 32
# Edit .env:
# HOSTMGR_ADMIN_PASSWORD=use-a-unique-12-plus-character-password
# HOSTMGR_SECRET_KEY=paste-the-generated-value
3

เริ่ม sandbox

build และ start Compose stack ในเครื่อง

docker compose up --build -d
docker compose ps
docker compose logs -f hostmgr
4

เปิด dashboard

sign in ที่ localhost ด้วยรหัสที่ตั้งไว้

# Open http://localhost in your browser
# Direct Node demo: npm run demo  # http://127.0.0.1:3000

อย่าเปลี่ยน HOSTMGR_SECRET_KEY หลังบันทึกข้อมูลที่เข้ารหัสแล้ว เพราะค่าเดิมจะอ่านไม่ได้

Docker sandbox ทดสอบ clone/build/health-check ได้ แต่ไม่มี privileged helper จึงไม่ activate systemd หรือแก้ Nginx/TLS ของเครื่องคุณ

ตรวจเส้นทาง

ยืนยันว่า dashboard ทำงาน แล้วอ่านคู่มือ project ก่อน deploy source ที่ไว้ใจได้

  • sign in แล้วเปิด Setup เพื่อบันทึก Git identity
  • อ่านคู่มือ Projects ก่อน deploy repository ที่ไว้ใจได้