VPSにCloudronをインストールする方法
新規Ubuntu VPSへCloudronを導入する手順を解説します。ワイルドカードDNS、セットアップスクリプト、初回起動、2~10個のアプリに必要な容量、メール、証明書、バックアップを確認できます。
VPS に Cloudron をインストールする: 簡易版
VPS に Cloudron をインストールするには、新規の Ubuntu サーバー、少なくとも 2 GB の RAM、そして DNS レコードを編集できるドメインが必要です。インストール自体は 3 つのコマンドを実行して 1 回再起動するだけです。問題の大半は、その前段階(ベースイメージや仮想化方式の誤り)またはインストール後(DNS、メール、バックアップ)に発生します。
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron はセルフホストアプリのインストール、更新、バックアップ、TLS(transport layer security)証明書の発行を行います。各アプリは Docker 上で動作し、すべてのアプリの前段に nginx が配置されます。また、各アプリにはドメインのサブドメインが割り当てられます。DNS の設定を最初に行うのは、この仕組みのためです。
なぜ Cloudron はベース OS に対して厳しいのか
セットアップスクリプトはインストール前にサーバーをチェックします。チェックに失敗した場合は、新しいサーバーを注文する必要があります。イメージを選択する前に、以下の内容を確認してください。本セクションで引用しているインストーラーのチェック項目は 2026 年 10 月 13 日時点のものです。現在のインストール手順では、クリーンな Ubuntu 26.04 サーバーが求められます。
- Ubuntu 限定であり、サポートされるのは 3 つのリリースのみです。それ以外は
Cloudron requires Ubuntu 22.04, 24.04, 26.04で終了します。Ubuntu 20.04 は拒否され、現在のインストール手順ではクリーンな Ubuntu 26.04 サーバーが求められます。Debian、Rocky、Alpine はサポートされていません。Ubuntu 24.04 には Cloudron 8 以降が必要であり、スクリプトが自動的にチェックします。 - 64 ビットの Intel または AMD のみです:
Error: Cloudron only supports amd64/x86_64。ARM VPS では動作しません。 - 完全なハードウェア仮想化のみが必要です。コンテナベースの VPS では
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualizationで停止します。これはsystemd-detect-virt --containerでコンテナを検出するためです。KVM は問題ありませんが、OpenVZ や LXC は非対応です。 - ルートファイルシステムは
ext4またはxfsである必要があります。それ以外ではError: Cloudron requires '/' to be ext4 or xfsとなり、btrfs や zfs イメージが失敗する原因となります。 free -mで測定して 941 MB 以上の RAM、および/で測定して 18 GB 以上のルートファイルシステム容量が必要です。エラーメッセージでは 20 GB を要求されますが、チェック自体は 19 GB のルートファイルシステムで通過します。- 真にクリーンなサーバーであること。
nginx、docker、またはnodeが既にインストールされている場合、スクリプトはError: Some packages like nginx/docker/nodejs are already installed.を返して拒否します。
最後のチェックは議論の対象になりやすい項目ですが、その理由は以下の通りです。Cloudron は Docker、nginx、Node.js、MySQL の特定のバージョンをインストールし、ホストするすべてのアプリの nginx 設定を書き込み、iptables ファイアウォールルールを自身で管理します。昨日インストールした Docker はバージョンが適合しない可能性があるため、スクリプトは何も変更せずに終了し、クリーンな Ubuntu インストールからやり直すよう指示します。Cloudron はマシン全体を制御するため、専用の VPS を用意してください。
もう一つ、見落としがちなチェックがあります。AVX (Advanced Vector Extensions) に対応していない古い CPU では、スクリプトは CPU has no AVX support. MongoDB will be disabled を出力し、MongoDB を必要とするすべてのアプリがインストール不可となります。grep -m1 -o avx /proc/cpuinfo で事前に CPU を確認してください。対応しているホストでは avx が出力され、古いホストでは何も出力されません。
Cloudron に必要な RAM 容量はどのくらいですか?
2026年10月13日時点のインストーラーチェックでは、941 MB 未満の環境では実行が拒否され、Error: Cloudron requires atleast 1GB physical memory が表示されます。現在のドキュメントでは、最低 2 GB の RAM と 20 GB のディスク容量が求められています。これらの数値はプラットフォーム自体の最低要件であり、アプリを含めた合計ではありません。Cloudron は Docker、nginx、独自の box サービス、メールスタックを実行し、アプリのデプロイに応じて共有データベースサービスをプロビジョニングします。クリーンインストール直後に docker ps を実行して、その数を確認してください。
アプリのメモリ制限は、このベースラインの上に加算されます。各アプリパッケージには低いデフォルト制限が設定されており、アプリの「Resources」ビューにあるスライダーで引き上げます。アプリが制限を超えると再起動し、OOM (out of memory) 通知が送信されます。そのため、特定のアプリが再起動を繰り返す場合は、バグではなく制限の問題であることがほとんどです。
以下に推奨するサイジングを示します。これらは、翌月に再構築が必要にならないようにするための推奨値であり、ベンチマーク測定結果ではありません。
このグラフのデータ
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]2 つのアプリであれば、4 GB の RAM と 60 GB のディスクで快適に動作します。10 個程度のアプリを運用する場合は、プラットフォームのベースラインは変わらず、各アプリが Docker イメージ、データベース、独自のデータを追加するため、16 GB の RAM と 240 GB のディスクが必要です。ディスクは予想以上に早く埋まります。バックアップをサーバー外へ移動するまでは、イメージ、アプリデータ、ローカルバックアップが同一ボリュームを共有するためです。
Cloudron はすべてのアプリに無制限の swap を提供するため、設定するメモリ制限は RAM のみに適用されます。swap ファイルのない VPS イメージでは、swapon --show は何も出力せず、メモリ負荷はアプリの動作を緩慢にするのではなく、直接 OOM による再起動を引き起こします。2 GB の swap を追加することは安価な保険になりますが、物理メモリの代わりにはなりません。VPS プラン間の価格差は、制限の調整に費やす時間に比べればわずかです。実際の VPS のコストを確認し、ワンランク上のサイズを購入してください。
DNS: アプリのサブドメインを機能させるワイルドカードレコード
Cloudron はダッシュボードを my.example.com に配置し、各アプリを個別のサブドメインで運用します。そのため、DNS 設定は後回しではなく、前提条件となります。ダッシュボードを初めて開く前に、以下のレコードをサーバーのパブリック IP アドレスに向けてください。
my.example.comを A レコードとして設定します。これはダッシュボード用です。*.example.comを A レコードとして設定します。これがアプリのサブドメインを機能させるための設定であり、これによりwiki.example.comやgit.example.comはアプリのインストール直後から名前解決が可能になります。example.comを A レコードとして設定します。これはベアドメインでアプリを運用したい場合のみ必要です。
ワイルドカードレコードは明示的なレコードよりも優先度が低いため、別の場所を指している既存の www.example.com はそのまま機能し続けます。
セットアップ中に、Cloudron がその後の DNS をどのように管理するかを選択します。
- API プロバイダー: Cloudron は Cloudflare、DigitalOcean、Route53、Hetzner、Porkbun、Linode、deSEC、Gandi、Namecheap、Hostinger DNS、Scaleway DNS などのトークンを保持し(Wildcard、Manual、No-op を除き合計 22 の API DNS 連携)、メールレコードを含むすべてのレコードを自動的に書き込みます。
- Wildcard: ユーザー自身で
*レコードを追加し、Cloudron は何も書き込みません。 - Manual: Cloudron が各レコードを表示し、アプリをインストールするたびにユーザーが手動で追加するのを待機します。
ワイルドカード DNS レコードはワイルドカード証明書とは異なります。 デフォルトの証明書プロバイダーは Let's Encrypt Prod - Wildcard です。これは DNS を通じて所有権を証明するため、API プロバイダーを使用する場合にのみ機能します。Wildcard または Manual バックエンドでは、Let's Encrypt は HTTP 経由で検証される個別の証明書を発行します。これには発行および更新のためにインバウンドの 80 番ポートが必要です。代わりに Let's Encrypt 連携を無効にしてカスタムのワイルドカード証明書をアップロードすれば、証明書検証のために 80 番ポートを常時開放する必要はありません。利用しているレジストラや DNS ホストが API リストにある場合は、それを使用してください。メールレコードと証明書の両方の管理が不要になります。
先に進む前に確認してください。dig +short my.example.com と dig +short anything.example.com の両方でサーバーの IP アドレスが表示されるはずです。Wildcard バックエンドを使用している場合、ワイルドカードクエリで何も表示されなければ、ダッシュボードは正常でも後でアプリのインストールに失敗します。
ドメインが Cloudflare の背後にある場合は、レコードを DNS only に設定してください。Cloudflare のプロキシは HTTP と HTTPS のみを転送するため、メール関連のポートが機能しなくなります。プロキシ経由の Web アプリについては、Cloudron の Network ビューで Cloudflare が公開している IP レンジを信頼するように設定することで、転送ヘッダーから訪問者のアドレスを復元できます。
セットアップスクリプトの実行
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupスクリプトは root ユーザーとして、または sudo を経由して実行してください。そうしない場合、最初に This script should be run as root. と表示されるためです。インストールには数分かかります。apt の出力や Docker イメージのプルはログファイルに記録されるため、実行中は静かな状態が続きます。別の SSH セッションからログを監視してください。
tail -f /var/log/cloudron-setup.log2026年10月13日版のインストーラーでは、After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. とサーバーアドレスが表示された後、The server has to be rebooted to apply all the settings. Reboot now ? [Y/n] と確認を求められました。yes と回答してください。また、そのインストーラーには再起動を延期するための --skip-reboot フラグも用意されていました。
初回起動: ドメイン、DNSバックエンド、管理者アカウント
https://<server-ip> を開き、ブラウザの警告を許可します。Cloudron はまだドメインを認識しておらず、認証局へ証明書を要求できないため、この証明書は自己署名されています。Chrome では Advanced をクリックし、次に Proceed to <ip> (unsafe) をクリックします。Firefox では Advanced をクリックし、次に Accept the Risk and Continue をクリックします。
最初の画面でドメインの入力を求められます。example.com を入力すると、ダッシュボードは my.example.com に固定されます。cloudron.example.com のようなサブドメインを使用することも可能で、その場合ダッシュボードは my.cloudron.example.com になります。DNSバックエンドを選択し、APIトークンがあれば貼り付けます。また、パスワードリセットやプラットフォーム通知で使用するため、確実に受信できるメールアドレスで管理者アカウントを作成してください。
保存すると、Cloudron は証明書を要求し、ダッシュボードを https://my.example.com へ移行します。その時点でIPアドレスによるURLは機能しなくなるため、新しいURLをブックマークしてください。
証明書:更新の仕組みと停止する原因
証明書の更新は自動で行われ、認証局が公開するスケジュールである ACME Renewal Information (ARI) に従います。実際には有効期限の約1ヶ月前に更新されます。更新に失敗すると管理用アカウントへメールが送信され、期限切れの証明書は組み込みの自己署名証明書へフォールバックします。昨日まで正常に動作していたサイトでブラウザの警告が表示されるのは、このフォールバックが発生しているためです。
原因の大部分は2つに集約されます。HTTP検証にはインバウンドの80番ポートが必要です。「すべてHTTPS化しているから」という理由で80番ポートを閉じると、Wildcardや手動DNSバックエンドで Let's Encrypt のHTTP検証を使用しているアプリの更新が失敗します。DNS検証には書き込み権限を持つAPIトークンが必要であり、トークンのローテーションや権限の縮小を行うと、警告メールが届くまで更新失敗に気づかないままとなります。
Domains ビューには即座に更新を試行するための Renew All ボタンがあり、テスト用に Let's Encrypt Staging プロバイダーが用意されています。Staging 証明書はブラウザから信頼されないよう意図的に設計されており、本番環境のレート制限を消費せずにテストを行うことが目的です。Staging にも制限があり、識別子・アカウント・時間あたり200回の認証失敗が上限となっています。
組み込みのメールサーバーを使用すべきか
Cloudron は、IMAP メールボックス、submission、sieve フィルタ、DKIM (domainkeys identified mail) 署名を含む完全なメールスタックを同梱しています。ダッシュボードの Email からドメインごとに有効化できます。メールの配送は難易度が高く、その困難さは Cloudron に起因するものではありません。
- 送信用の 25 番ポートは、スパム対策としてほとんどの VPS プロバイダーでブロックされています。サポートチケットを発行することで解除される場合があります。サーバーから
nc -zv aspmx.l.google.com 25を使用してテストしてください(コマンドがない場合はnetcat-openbsdをインストールしてください)。ポートが開いていればsucceededと報告されますが、ブロックされている場合はタイムアウトまで停止します。 - PTR レコード(逆引き DNS)は DNS ホストではなく VPS プロバイダー側で設定します。サーバーから直接送信する場合、メールのホスト名と一致させる必要があります。スマートホストを利用すれば、この PTR レコードの要件は不要になります。
- SPF、DKIM、DMARC レコードは、API 対応の DNS バックエンドであれば自動的に書き込まれます。Wildcard または Manual バックエンドの場合は手動で追加する必要があります。DKIM レコードが欠落していると、署名したすべてのメッセージが検証不能になります。
多くのユーザーにとって最適な構成は、Cloudron でメールを受信し、Email ビューで設定した SendGrid、Postmark、Mailgun、Amazon SES などのリレー経由で送信する方法です。リレー側では、ドメイン内のあらゆるアドレスからの送信を許可する必要があります。そうしないと、異なる送信者からのアプリ通知が拒否されます。メール運用がサーバー導入の主目的である場合は、Mailcow のような専用メールサーバーを、独自の IP レピュテーションを持つ別のサーバーで運用してください。
Cloudron Email を全く使用しない場合は、プロバイダー側のファイアウォールで 25、465、587、993、4190 番ポートをブロックしてください。Cloudron は iptables ルールを自ら書き込み、管理することを前提としているため、サーバー上ではなくプロバイダー側で設定を行う必要があります。これは ufw ルールを自身で管理する一般的な VPS とは対照的です。
必要になる前にバックアップ先を設定する
バックアップの保存先はデフォルトでは /var/backups のローカルファイルシステムで、ほかのデータと同じディスク上になります。ドキュメントにも、「プラットフォームサーバーと同じ物理ディスクにバックアップを保存するのは危険です」と明記されています。ディスクが1台故障すると、アプリとバックアップが同時に失われます。
Backups を開き、次に Backup Sites を開いて、初日から別の保存先を指定します。通常は S3互換のオブジェクトストレージを使用します(Backblaze B2、Wasabi、Cloudflare R2、DigitalOcean Spaces、または 2台目のサーバー上の MinIO バケット)。SSHFS、NFS、CIFS、通常のファイルシステムの保存先もサポートされています。
このバックアップを実際に役立つものにするかどうかは、次の3つの設定で決まります。
- Format。
tgzはアプリごとに圧縮アーカイブを1つ作成し、実行のたびに全体を再アップロードします。rsyncは変更されたファイルだけをアップロードするため、大規模な Nextcloud では大幅に安価です。ただし、ストレージ API へのリクエスト数は大幅に増えます。 - Encryption。ファイルの内容とファイル名の両方を対象にする AES-256 暗号化を任意で有効にできます。Cloudron はパスワードのコピーを保持しないため、パスワードを失うと、あなたを含めて誰もバックアップを復号できません。保存をクリックする前に、自己ホスト型のパスワードマネージャーに保存してください。
- Retention。7 daily や 4 weekly のように、保持する世代数で指定します。オブジェクトストレージで長期間保持すると毎月料金が発生するため、継続して支払える数を選択してください。
次に、復元をテストします。小規模なアプリをインストールし、ダッシュボードから復元して、データを含めて正常に戻ることを確認します。一度も復元したことのないバックアップは、単なる推測にすぎません。
無料プランの制限
2026年10月時点で、無料プランにインストールできるアプリは2個までです。アプリの更新、アプリごとのバックアップ、ファイアウォール、メールサーバー、シングルサインオンはすべて利用できます。ライセンスが必要になるのは、3個目のアプリを追加するときです。有料プランではアプリ数の制限がなくなり、上位プランではユーザーグループとロール、ディレクトリサーバー、複数のバックアップサイトも利用できます。料金は変わるため、チュートリアル内の数字ではなく、Cloudron の料金ページを確認してください。
1つのライセンスで1台の Cloudron インストールをカバーします。そのため、小規模なサーバーを2台使うと、大規模なサーバーを1台使う場合の2倍の費用がかかります。この料金体系のため、多くのユーザーは複数のマシンにサービスを分散する一般的な方針ではなく、より大きな VPS 1台に集約します。後から分割すると費用が2倍になるため、この点を考慮してサーバーのサイズを決めてください。
障害発生時
まずは組み込みのチェック機能から開始してください。DNS、証明書、ディスク、メモリ、各サービスを順に検証し、どのテストで失敗したかを表示します。
sudo cloudron-support --troubleshootその後は、標準的な systemd (システムおよびサービスマネージャー) ツールを使用します。systemctl status box は Cloudron サービス自体の状態を報告し、journalctl -u box -n 100 は直近のログを出力します。journalctl -u docker はその下層にあるコンテナランタイムの状態を確認します。インストール中に発生した問題はすべて /var/log/cloudron-setup.log に記録されています。
ダッシュボードが読み込めない場合、原因は Cloudron ではなく DNS やプロバイダーのファイアウォールであることがほとんどです。ノート PC から dig +short my.example.com を実行し、サーバー自身のルールとは別に管理されるプロバイダーのネットワークファイアウォールで 80 番および 443 番ポートが開放されているか確認してください。2026 年 10 月 13 日版のインストーラーチェックでは、2 回目の実行は Error: Cloudron is already installed. To reinstall, start afresh により拒否されます。この場合はサーバーを再構築するのが確実な解決策です。
Cloudron が適さない構成
Cloudron は、インフラではなくアプリケーションを運用したい場合に適しています。独自の方法でコンテナを運用したい場合は適していません。nginx、Docker、ファイアウォールを Cloudron が管理し、そこに追加した設定を上書きするためです。Compose ファイルをまとめたディレクトリを運用する計画であれば、独自の Docker Compose スタックの前段に Traefik を置くことで、プラットフォームを介さずに同じ自動 TLS とサブドメインルーティングを利用できます。まだ選定していない場合は、Cloudron、CasaOS、Coolify の比較で各製品を並べて確認できます。また、インストールガイドよりも、セルフホストできるものの幅広い一覧から始める方が適しています。
FAQ
VPS 上で Cloudron を動作させるにはどの程度の RAM が必要ですか?
2026年10月13日時点のインストーラーチェックでは 941 MB 未満での実行が拒否されます。現在のドキュメントでは 2 GB を要求していますが、これはアプリを何もインストールしていない状態でのプラットフォームの最低ラインです。Cloudron は Docker、nginx、独自の box サービス、メールスタックを動作させ、アプリのデプロイに応じて共有データベースサービスをプロビジョニングします。アプリ 2 個であれば 4 GB、10 個程度であれば 16 GB を目安とし、スワップファイルを追加してください。Cloudron はアプリに無制限のスワップを許可するため、スワップがない環境ではメモリ圧迫時に再起動が発生します。
Debian や、すでに Docker が動作しているサーバーに Cloudron をインストールできますか?
どちらも動作しません。2026年10月13日時点のインストーラーチェックでは、サポート対象外のリリースでは Cloudron requires Ubuntu 22.04, 24.04, 26.04 でスクリプトが停止し、nginx、docker、または node がすでに存在する場合はサーバーが拒否されます。現在のインストール手順では、Debian、Rocky、Alpine を除外した、クリーンな Ubuntu イメージが必須です。KVM VPS 上のクリーンな Ubuntu イメージから開始してください。
ダッシュボードは動作するのに、アプリのサブドメインが失敗するのはなぜですか?
ワイルドカードバックエンドを使用している場合、ワイルドカード DNS レコードを確認してください。セットアップでは my.example.com の A レコードを作成または要求するためダッシュボードは解決されますが、wiki.example.com は NXDOMAIN を返し、ブラウザはサイトが見つからないと報告します。サーバーの IP を指す *.example.com の A レコードを追加し、アプリをインストールする前に dig +short wiki.example.com で確認してください。
Cloudron のメールサーバーを使用する必要がありますか?
いいえ。受信メールをオフにして、Postmark、Mailgun、Amazon SES などの外部リレー経由で送信することも可能です。プロバイダーがアウトバウンドの 25 番ポートをブロックしている場合や、IP アドレスのメールレピュテーションがない場合には、こちらの方が安全な選択肢です。Cloudron Email を完全にスキップする場合は、サーバー上ではなくプロバイダーのファイアウォールで 25、465、587、993、4190 番ポートを閉じてください。
無料プランのアプリ 2 個制限に達するとどうなりますか?
3 個目のアプリをインストールするには有料サブスクリプションが必要です。すでに実行中のアプリには影響ありません。更新、バックアップ、証明書の取得は継続されます。サブスクリプションを追加すれば再インストールなしで制限が解除されるため、無料プランは実際のドメインでプラットフォームをテストするのに適しています。