# サイトにアプリをインストールする

Source: https://support.kapsulehost.com/ja-jp/apps-installing

アプリインストールウィザードは3つのステップで構成されています。管理者アカウントとサイト設定を構成し、実行予定の内容を確認してから、インストールを実行してログイン情報を収集します。

## 開始する前に

必要なのは1つです。アカウント上に**アクティブなウェブサイト**があること。ウィザードは既に存在するサイトにインストールするもので、新しいサイトを作成するものではありません。ない場合は、ウィザードが教えてくれ、作成へのリンクが表示されます。[最初のウェブサイトの作成](https://support.kapsulehost.com/ja-jp/creating-your-first-website)を参照してください。

また、アカウントのオーナーと管理者が保持する**apps:write**権限も必要です。

> **Warning:** 既にコンテンツがあるサイトにインストールする前に、バックアップを取得してください。ウィザードには既にアプリを保持しているサイト向けのセーフティネットがあり、下で説明されていますが、意図的に取得した手動復元ポイントは自動で取得したものより常に価値があります。[バックアップの取得](https://support.kapsulehost.com/ja-jp/taking-a-backup)を参照してください。

## ウィザードへのアクセス

1. KPanelサイドバーで**アプリ**をクリック。
2. 必要なアプリをクリック。
3. 右側のパネルで**[アプリ]をインストール**をクリック。

直接アドレスは`/apps/<app-slug>/install`です。

![KPanelのアプリインストールウィザード、右側のパネルにインストールボタンがある](https://support.kapsulehost.com/help/screenshots/apps-installing.1f6e023d.webp)

## ステップ1:構成

ウィザードはアプリを表示し、その後4つのフィールドグループが表示されます。アプリが現在のプランより高いプランレベルを提案する場合、**プランのアップグレードをお勧めします**という通知が上部に表示されます。これはアドバイスであり、インストールは続行されます。

### 場所

**サイトにインストール。** アクティブなサイトから選択します。これがアプリが配置される場所です。

### 管理者アカウント

- **管理者ユーザー名。** デフォルトは`admin`です。これはログインに使用するユーザー名で、後でより多くのユーザーを追加できます。
- **管理者パスワード。** ページが読み込まれた時点で、強力な16文字のパスワードが自動的に生成されます。**表示**するとパスワードが表示され、**生成**すると新しいものが作成されます。自分で入力することもできます。8文字以上である必要があります。
- **管理者メール。** オプション。ログインとパスワードリセットに使用されます。空白のままの場合、アカウントのメールアドレスが使用されます。

> **Important:** ウィザードを離れる前に管理者パスワードを保存してください。レビュー画面と成功画面に表示され、その後は表示されなくなります。KapsuleHostは後で取得できるコピーを保存しないため、パスワードを失うことはアプリ自体を通じてパスワードをリセットすることを意味します。

### サイト設定

- **サイト名**。アプリがこれを要求する場合。
- **言語。** アプリが設定されている言語。英語(米国)、英語(英国)、テ・レオ・マオリ語、および主要なヨーロッパおよびアジアの言語を含む16のオプションから選択されます。これはアプリ自体のコンテンツ言語を設定し、KPanelの言語ではありません。

### データベース

データベースが必要なアプリの場合のみ表示されます。ウィザードはドメインから導出されたデータベース名を提案します。文字と数字のみで、アンダースコアやハイフンはありません。このフィールドは入力時にこれを実施します。必要に応じて変更してください。

データベースが必要なアプリには、インストールの一部として自動的にプロビジョニングされます。

一部のアプリはこの下に独自の追加フィールドを追加し、アプリ自体によって定義され、該当する場合はヘルプテキストがあります。必須フィールドにはアスタリスクがマークされ、すべてが入力されるまで**続行**は無効なままです。

下部で、ウィザードはこのアプリのリソースサマリーを表示します。予想されるインストール時間、最小RAM、およびデータベースが追加されるかどうか。

**続行**をクリック。

## ステップ2:確認

レビュー画面は1つのリストで決定を再述べます。アプリ、ウェブサイト、サイト名、管理者ユーザー名、管理者パスワード(表示または非表示の切り替え付き)、管理者メール、言語、およびデータベース名。サブタイトルで明確に述べられています。**確認するまで何もインストールされません。**

- **編集**に戻って何かを変更します。
- **確認してインストール**はジョブを開始します。

> **Tip:** レビュー画面で最も重要な1つのチェックを使用してください。**ウェブサイト**行です。間違ったサイトへのインストールは最も一般的なインストール間違いであり、以下の上書きガードが存在する理由です。

## ステップ3:インストール

ウィザードは進捗表示に切り替わります。順番に表示されます。

- **キューに入っています。ワーカーを待機中。** ジョブはキューに入っており、すぐに開始されます。
- **[アプリ]をインストール中**。経過秒と典型的なインストール時間、および進捗バー。

ページを開いたままにしてください。別のページに移動してもインストールはバックグラウンドで続行されますが、ライブビューと最後の認証情報サマリーは失われます。

インストールが問題に遭遇した場合、自動的に再試行され、**インストールを再試行しています**と試行番号が表示されます。予想時間をはるかに超えて実行する場合、待ち続けるか、キャンセルするかを選択するメモが表示されます。

### キャンセル

**インストールをキャンセル**するとジョブが停止します。結果画面で確認されます。*インストールが停止されました。サイトには何も変更されていません。*

## サイトに既にアプリがある場合

ターゲットサイトのディレクトリに既にサイトが含まれている場合、インストールは警告で停止し、見つかったものに名前を付けます。

> このディレクトリには既に[アプリ]が含まれています。[新しいアプリ]をインストールすると、それが上書きされ、元に戻すことができません。現在のサイトの完全なバックアップが最初に取得されるため、復元できます。

2つの選択肢があります。キャンセルするか、**バックアップして上書き**をクリック。同意した場合、ジョブは何かを書き込む前に既存のサイトの完全なバックアップを取得するため、復元ポイントがあります。

> **Important:** これがウィザードの引き返せない地点です。上書きすると既存のサイトのファイルが置き換わります。自動バックアップは復旧可能であり、クリックで元に戻すことができるわけではありません。サイトが削除可能かどうか確実でない場合は、キャンセルして別のサイトにインストールしてください。

## チームが手作業でインストールするアプリ

一部のアプリには実証済みの自動インストーラーがありません。これらの場合、ウィザードは進捗バーをスキップし、温かい確認を表示します。

> [アプリ]をセットアップしています。このアプリは手作業でのセットアップが必要なため、チームがオーダー後にサイトにインストールします。ライブになったらすぐにメールを送信します。これ以上何もする必要はありません。

何も失敗していません。何もあなたに保留中です。アプリは無料なので、どちらの方法でも料金はありません。

## ステップ4:ライブ状態

成功時にウィザードは**[アプリ]がライブです**と表示し、ドメインへのリンク、および認証情報サマリー。

- 管理者ユーザー名
- 管理者パスワード。表示または非表示
- 管理者メール
- サイトタイトル

また、**インストールログ**が行ごとに表示され、各ステップは成功、失敗、またはスキップがマークされています。そのログはクリーンなインストール上でも一見の価値があります。正確に何が構成されたかを示しています。

2つのボタンでフローが完了します。**[アプリ]を開く**はアプリに直接移動し、**アプリに戻る**はカタログページに返ります。

## 失敗した場合

**インストール失敗。** 結果画面に何が起きたかが表示され、重要な部分が述べられています。*部分的な変更があれば、ロールバックされています。サイトはクリーンです。* **もう一度試す**と**サポートに連絡**の2つのアクションが提供されます。

一般的な原因と対処方法。

- **リソース制限。** アプリの最小RAMがプランが与える値を超える場合、インストールが途中で失敗することがあります。アプリページの**最小RAM**の数字を確認してください。[プランのアップグレード](https://support.kapsulehost.com/ja-jp/upgrading-your-plan)を参照してください。
- **拒否されたフィールド。** ウィザードはジョブがキューに入る前にシェル安全でない文字を含む入力を拒否し、フィールドに名前を付けます。値を簡略化します。プレーンユーザー名、生成されたパスワード、文字と数字のデータベース名。
- **サイトがアクティブではない。** **ACTIVE**ステータスのサイトのみがサイトドロップダウンに表示されます。まだプロビジョニング中のサイトはリストされません。

**インストールは成功しましたがサイトにエラーが表示されます。** インストールログで失敗したステップを確認してから、アプリ独自のドキュメントでインストール後のセットアップを確認してください。特にコミュニティアプリは、ブラウザーで最終セットアップウィザードを実行する必要があります。[ウェブサイトが読み込まれていない](https://support.kapsulehost.com/ja-jp/website-not-loading)を参照してください。

**管理者パスワードを失いました。** 設定した管理者メールでアプリ独自のパスワードリセットを使用してください。特にWordPressについては、[WordPressパスワードのリセット](https://support.kapsulehost.com/ja-jp/wordpress-reset-password)を参照してください。

**インストールがキューで進行中のまま。** ジョブキューがビジーです。開始されます。予想されるインストール時間をはるかに超えてキューに入ったままの場合は、キャンセルしてもう一度試してから、繰り返す場合は[サポートチケットを開く](https://support.kapsulehost.com/ja-jp/opening-a-support-ticket)してください。

## 関連

- [アプリカタログ](https://support.kapsulehost.com/ja-jp/apps-overview)
- [WordPressのインストール](https://support.kapsulehost.com/ja-jp/installing-wordpress)
- [バックアップの取得](https://support.kapsulehost.com/ja-jp/taking-a-backup)
- [ウェブサイトが読み込まれない場合の診断チェックリスト](https://support.kapsulehost.com/ja-jp/website-not-loading)