ウェブサイト
サイトにアプリをインストールする
The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.
アプリのインストール ウィザードは 3 つのステップを実行します: 管理者アカウントとサイト設定を構成する、実行予定の内容を確認する、その後インストールが実行される様子を監視してログイン詳細を収集します。
開始する前に
必要なものは 1 つです: アカウント上のアクティブなウェブサイトです。ウィザードは既にあるサイトにインストールしており、サイトを作成するものではありません。サイトがない場合、ウィザードはそのことを通知し、サイトを作成するためのリンクを提供します。最初のウェブサイトを作成するを参照してください。
また、アカウント オーナーと管理者が保持している apps:write 権限も必要です。
既にコンテンツを含むサイトにインストールする前にバックアップを取得します。ウィザードは既にアプリを保持しているサイト用のセーフティ ネットを備えており、以下で説明されていますが、意図的に取得された手動復元ポイントは常に自動的に取得されたものより価値があります。バックアップを取得するを参照してください。
ウィザードへのアクセス
- KPanel サイドバーでAppsをクリックします。
- インストールするアプリをクリックします。
- 右側のパネルで**Install [app]**をクリックします。
直接アドレスは /apps/<app-slug>/install です。

ステップ 1: 構成
ウィザードにはアプリが表示され、その後 4 つのフィールド グループが表示されます。現在のプラン レベルよりも高いプラン レベルをアプリが提案している場合、Plan upgrade recommendedという通知がトップに表示されます。これはアドバイスであり、インストールは進行します。
場所
Install on site。アクティブなサイトから選択します。これはアプリが配置される場所です。
管理者アカウント
- Admin username。
adminに既定値が設定されます。これはログインに使用するユーザー名であり、後で他のユーザーを追加できます。 - Admin password。強力な 16 文字のパスワードがページ読み込み時に自動生成されます。Showでそれを確認し、Generateで新しいものを作成します。独自のパスワードを入力することもできます。最小 8 文字である必要があります。
- Admin email。オプションです。ログインとパスワード リセット用に使用されます。空白のまま、アカウント メールアドレスが使用されます。
ウィザードから離れる前に、管理者パスワードを保存します。確認画面に表示され、成功画面にも再度表示されます。その後は非表示になります。Kapsule は後で取得できるようなコピーを保存しないため、それを紛失すると、アプリ自体を通じてパスワードをリセットする必要があります。
サイト設定
- アプリが要求するSite name。
- Language。アプリが設定されている言語。英語 (米国)、英語 (英国)、Te Reo Māori、および主なヨーロッパとアジアの言語を含む 16 のオプションから選択できます。これはアプリ独自のコンテンツ言語を設定し、KPanel の言語ではありません。
データベース
データベースが必要なアプリのみが表示されます。ウィザードはドメインから派生したデータベース名を提案します。文字と数字のみで、アンダースコアやハイフンは使用できません。フィールドは入力時にこれを強制します。必要に応じて変更します。
データベースが必要なアプリは、インストールの一部として自動的にプロビジョニングされます。
一部のアプリは、アプリ自体で定義された追加フィールドをこの下に追加します。該当する場合、ヘルプ テキストが表示されます。必須フィールドはアスタリスクでマークされており、すべてが入力されるまでContinueは無効のままです。
下部では、ウィザードがこのアプリのリソース概要を表示します。予想インストール時間、最小 RAM、およびデータベースが追加されるかどうかです。
Continueをクリックします。
ステップ 2: 確認と確定
確認画面は 1 つのリストで決定を再述します: アプリ、ウェブサイト、サイト名、管理者ユーザー名、管理者パスワード (表示または非表示トグル付き)、管理者メール、言語、データベース名。サブタイトルは率直に述べています: 確定するまで何もインストールされません。
- Edit。何かを変更するために戻ります。
- Confirm and install。ジョブを開始します。
確認画面を、最も重要な 1 つのチェック用に使用します: Website 行。間違ったサイトにインストールすることは、最も一般的なインストール ミスです。これが、以下の上書きガードが存在する理由です。
ステップ 3: インストール
ウィザードが進捗表示に切り替わります。順番に以下が表示されます:
- Queued: waiting for worker。ジョブはキューイングされており、まもなく開始されます。
- Installing [app]、経過秒数は典型的なインストール時間と進捗バーです。
ページを開いたままにします。移動した場合、インストールはバックグラウンドで続行されますが、ライブ表示と最後の資格情報サマリーが失われます。
インストールが問題に達した場合、自動的に再試行され、試行番号と共にRetrying the installが表示されます。予想時間をはるかに超えて実行されている場合、待機を続けるかキャンセルするかを提案するメモが表示されます。
キャンセル
Cancel install。ジョブを停止します。結果画面がそれを確認します: インストールが停止されました。サイトで何も変更されていません。
サイトに既にアプリがある場合
ターゲット サイトのディレクトリに既にサイトが含まれている場合、インストールは見つかったことを名付けた警告で停止します:
このディレクトリには既に [app] が含まれています。[new app] をインストールするとそれを上書きしており、取り消すことはできません。現在のサイトの完全バックアップが最初に取得されるため、それを復元できます。
2 つの選択肢: キャンセルするか、Back up and overwriteします。同意した場合、ジョブは何かを書き込む前に既存サイトの完全バックアップを取得するため、復元ポイントがあります。
これはウィザードの返却不可ポイントです。上書きすると既存サイトのファイルが置き換わります。自動バックアップは回復可能ですが、クリックで元に戻すことはできません。サイトが廃棄可能であることが確実でない場合、キャンセルして代わりに別のサイトにインストールします。
チームが手動でインストールするアプリ
一部のアプリには証明されたオート インストーラーがありません。これらの場合、ウィザードは進捗バーをスキップし、代わりに温かい確認を表示します:
[app] をセットアップしています。このアプリはハンズオン セットアップが必要なため、注文後にチームがサイトにインストールしています。それがライブになった時点でメールをお送りします。それ以上の操作は必要ありません。
何も失敗していなく、何も保留中ではありません。アプリは無料なため、どちらの方法でも料金は発生しません。
ステップ 4: ライブになっています
成功時、ウィザードが**[app] is live**、ドメインへのリンク、資格情報サマリーを表示します:
- 管理者ユーザー名
- 管理者パスワード、表示または非表示付き
- 管理者メール
- サイト タイトル
また、install logも行ごとに表示され、各ステップは成功、失敗、またはスキップされたものとしてマークされています。そのログは、クリーン インストールでも一目の価値があります。正確に何が構成されたかを示します。
2 つのボタンが流れを終了します: Open [app]。アプリに直接移動し、Back to App。カタログ ページに戻ります。
失敗した場合はどうしますか
Installation Failed。結果画面に何が起きたかが表示され、重要な部分が示されます: 部分的な変更がロールバックされています。サイトはクリーンです。 Try AgainとContact Supportの 2 つのアクションが提供されます。
一般的な原因とその対処方法:
- Resource limits。アプリの最小 RAM がプランで提供されるものより高い場合、インストールが途中で失敗する可能性があります。アプリ ページでMin RAM数値を確認します。プランをアップグレードするを参照してください。
- A rejected field。ウィザードはシェル非安全文字を含む入力をジョブがキューイングされる前に拒否し、フィールドに名前を付けます。値を簡略化します: プレーンなユーザー名、生成されたパスワード、文字と数字のデータベース名。
- The site is not active。ACTIVE ステータスを持つサイトのみがサイト ドロップダウンに表示されます。プロビジョニング中のサイトはリストされません。
インストールは成功しましたが、サイトにエラーが表示されています。 インストール ログで失敗したステップを確認し、次にアプリ独自のドキュメントで インストール後のセットアップを確認します。特にコミュニティ アプリは、ブラウザで最終セットアップ ウィザードを実行する必要があります。ウェブサイトが読み込まれていないを参照してください。
管理者パスワードを紛失しました。 設定した管理者メールでアプリ独自のパスワード リセットを使用します。WordPress の場合は具体的に、WordPress パスワードをリセットするを参照してください。
インストールがキュー中にスタックしています。 ジョブ キューはビジーです。開始します。予想インストール時間をはるかに超えてキューイングされたままの場合、キャンセルしてもう一度試行してから、繰り返された場合はサポート チケットを開くしてください。