インストールの前に

管理者権限、ホスト名、正常なDNSを持つDebian/Ubuntu環境が必要です。現在のパッケージは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と有効な証明書を設定し、/loginで既存のLinuxユーザーとしてログインします。条件を満たす最初のsudo/wheelユーザーが管理者になれます。現在はセルフホストの単一モードで、旧managed設定は現行手順ではありません。

更新と復旧

設定と暗号化された認証情報をバックアップします。保管庫の鍵を変更すると既存の認証情報が読めなくなるため、鍵を保管してください。ビルドは1台につき1つずつ行います。Astroはdistをクリーンにし、NODE_OPTIONS=--max-old-space-size=2560を指定してビルド後に再起動とHTTP確認を行います。PM2の環境を変更した場合は--onlyと--update-envでecosystemを再評価します。