LearnHouseをセルフホストする最も手早い方法は、Dockerを入れたサーバー1台で動かすことです。npx learnhouse@latest setupを実行していくつかの質問に答え、続けてnpx learnhouse startを実行します。Docker ComposeのファイルはCLIが書き出して管理するので、自分で編集する必要はありません。
$ npx learnhouse@latest setup
ウィザードで聞かれること
$ npx learnhouse start
$ npx learnhouse doctor
npx learnhouse@latest setupnpx learnhouse startほとんどの質問にはデフォルト値があり、Enterで受け入れられます。初回の起動ではイメージを取得するため、1、2分かかります。
書き出されるファイル
learnhouse/
docker-compose.yml
すべてのサービスとそのボリューム。
.env
設定と、生成されたシークレット。
learnhouse.config.json
インストール設定。
nginx / Caddy
リバースプロキシ用のnginxまたはCaddyの設定。
| 最小 | 推奨 | |
|---|---|---|
| メモリ | 2 GB | 4 GB |
| CPU | 1 | 2+ |
| ディスク | 10 GB | 20 GB+ |
本番環境にはLinuxをおすすめします:Ubuntu 20.04以上、Debian 11以上、CentOS 8以上、またはDockerが動く任意のディストリビューション。macOSはDocker Desktopで、WindowsはWSL2経由で動きます。
ポート80と443を開放し、インストール時にイメージを取得するためのインターネット接続を用意してください。
learnhouse backupは、データベースのpg_dumpと.envのコピーを、タイムスタンプ付きのアーカイブに書き出します。アップロードされたファイルは含まれないため、コンテンツ用のボリュームも別途バックアップするか、アップロード先をS3互換ストレージにしてください。
サーバー1台で足りるとき
ほとんどの学校、研修チーム、コース事業にはサーバー1台で十分です。WebアプリとAPIを複数動かす必要が出てきたとき、またはすでに社内のすべてをクラスタで運用しているときは、Kubernetesに移行してください。
はい。--external-dbにPostgreSQLの接続文字列を、--external-redisにRedisの接続先を渡すか、ウィザードでExternalを選んでください。
デフォルトではDockerのボリュームです。.envファイルの3つの設定で、AWS S3、Cloudflare R2、MinIOなど任意のS3互換サービスに切り替えられます。
.envファイルでドメインとLEARNHOUSE_SSL=trueを設定し、前段にリバースプロキシを置きます。CaddyならLet's Encryptの証明書を自動で取得、更新します。
サーバーを運用したくない場合は、LearnHouse Cloudが同じプラットフォームを代わりに運用します。アップデート、バックアップ、TLSの対応も含まれます。
Cloudのプランを見る