安裝前準備

需要 Debian/Ubuntu、管理員權限、主機名稱及正常運作的 DNS。目前套件要求 Node.js 22.12 以上，並指定 pnpm 11.5.0。Redis、nginx 與啟用模組所需的服務必須可用。先檢查 install.sh：它會安裝相依套件並修改系統設定。

sudo bash install.sh --domain panel.example.com --https

安裝與登入

在 LUXIPANEL 儲存庫中使用自己的網域執行安裝程式。公開來源使用 TLS 時加上 --https，適用時使用 --cloudflare。設定 DNS 和有效憑證後，以現有 Linux 使用者登入 /login。第一位符合條件的 sudo/wheel 使用者可成為面板管理員。目前只有自行架設模式，舊 managed 設定不是現行安裝流程。

更新與復原

先備份設定及加密認證資料。保留保管庫金鑰，變更它會讓既有資料無法解密。每台機器一次只建置一個專案。Astro 先清理 dist，使用 NODE_OPTIONS=--max-old-space-size=2560，建置後重啟程序並檢查 HTTP。PM2 環境變更後，使用 --only 與 --update-env 重新載入 ecosystem 設定。