---
title: インストールエラー
description: NexCMPインストローラーが表示する可能性のあるすべてのエラーメッセージの原因と対処法を解説します（要件、ライセンス認証、ダウンロード検証、サービス、nginx/TLS）。
url: https://nexcmp.com/ja/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# インストールエラー {#installation-errors}

インストーラーは最初のエラーで停止し、`✗`で始まる赤い行を出力します。原因を修正して**同じコマンドを再度実行してください**。インストーラーは何度実行しても安全です。情報メッセージは`•`で、成功したステップは`✓`で始まります。

## マシンのチェック {#machine-checks}

| メッセージ | 原因 | 対処法 |
|---|---|---|
| `must be run as root (sudo)` | root権限で実行されていません | コマンドの前に`sudo`を付けるか、rootとして実行してください。 |
| `only Ubuntu 22.04/24.04 is supported (this host: …)` | 別のディストリビューションまたはバージョン | Ubuntu 22.04または24.04サーバーを使用してください。 |
| `only x86_64 is supported` | ARMまたはその他のCPU | x86_64サーバーを使用してください。 |
| `requires ≥ 2 GB RAM (host has … MB)` | メモリが不足しています | RAMを追加してください。 |
| `requires ≥ 8 GB free disk space on / (… GB available)` | ルートファイルシステムの空き容量がほぼありません | 空き容量を確保するか、`/`を拡張してください。 |
| `missing --license` / `missing --domain` | これらのパラメータを指定せずに最初にインストールしました | 両方を指定してください — [Installation](https://nexcmp.com/ja/docs/getting-started/installation/#parameters)を参照してください。 |
| `unknown argument: …` | パラメータの入力ミス | スペルを確認し、`--help`を指定して実行してください。 |
| `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | パッケージマネージャーがロックされています | 数分待ってから（クリーンなUbuntuは起動後に自動アップデートを実行するため）、再実行してください。 |
| `… is a symlink — aborting` | `/opt/nexcmp`または`/etc/nexcmp`がシンボリックリンクになっています | 実際のディレクトリに置き換えてください。セキュリティ上の理由から、インストーラーはシンボリックリンクを拒否します。 |

## ライセンス認証 {#license-activation}

| メッセージ | 原因 | 対処法 |
|---|---|---|
| `cannot connect to https://nexcmp.com` | ライセンスサーバーへのアウトバウンドHTTPS通信がありません | サーバーのDNS、ファイアウォール、プロキシを確認してください: `curl -I https://nexcmp.com`。 |
| `license activation failed (HTTP …): <message>` | ライセンスサーバーによってキーが拒否されました | メッセージを確認してください：無効なキー、ライセンスに一致しないドメイン、停止または失効したライセンス。[nexcmp.com/licenses](https://nexcmp.com/licenses)でライセンスページを確認してください。 |
| `no release available for this license yet` | ライセンスにダウンロード可能なリリースがありません | 営業担当にお問い合わせください。[Support](https://nexcmp.com/ja/docs/troubleshooting/support/)をご覧ください。 |

## ダウンロードと検証 {#download-and-verification}

| メッセージ | 原因 | 対処法 |
|---|---|---|
| `failed to download release X` | ダウンロード中のネットワーク問題 | 再実行してください。 |
| `sha256 mismatch (… ≠ …)` | ファイルが破損しているか、改変されて届きました | 再実行してください。問題が続く場合は、プロキシがダウンロードを書き換えている可能性があります。別のネットワークからお試しください。 |
| `release X is unsigned — refusing to install` | サーバーから署名が提供されませんでした | 絶対にバイパスせず、サポートにお問い合わせください。 |
| `INVALID SIGNATURE for version X — aborting` | Ed25519署名の検証に失敗しました | インストールしないで**ください**。サポートにお問い合わせください。これはファイルが公式リリースではないことを意味します。 |
| `openssl failed to read public key` | 非常に古い、または破損したOpenSSL | `openssl`パッケージをアップデートしてください。 |
| `invalid version: …` | サーバーからの予期しないデータ | 再実行してください。解決しない場合はサポートにお問い合わせください。 |

## サービスの起動 {#service-start}

| メッセージ | 原因 | 対処法 |
|---|---|---|
| `service failed to start — check: journalctl -u nexcmp -n 50` | パネルが3分以内に`/healthz`に応答しませんでした | ジャーナルを確認してください。一般的な原因：ポート（デフォルトは3000）がすでに使用されている（`ss -ltnp | grep 3000`）→ `--port`で再インストールする、`/var/lib/nexcmp`内のファイルの所有者がrootになっている → `sudo nexcmp fix-owner`を実行する。 |

## nginxとTLS {#nginx-and-tls}

| メッセージ | 原因 | 対処法 |
|---|---|---|
| `DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS` | AまたはAAAAレコードが存在しないか、間違っています | [DNS and Cloudflare](https://nexcmp.com/ja/docs/getting-started/dns-and-cloudflare/)を参照してから再実行してください。 |
| `certbot could not get a certificate yet — re-run the installer once DNS has settled` | Let's Encryptの検証に失敗しました（ポート80がブロックされている、DNSが伝播していない、レート制限） | ポート80を開放し、DNSの伝播を待ってから再実行してください。`/var/log/letsencrypt/letsencrypt.log`を確認してください。 |
| `certbot could not renew now — keeping the existing certificate` | 一時的な更新失敗 | 問題ありません。後で再実行してください。 |
| `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | 別のnginxサイトと競合しています（同じ`server_name`、重複する設定） | `sudo nginx -t`を実行して競合を修正してから、再実行してください。 |
| `apt-get could not install nginx` / `certbot`、または`E: Failed to fetch … 404 Not Found` | パッケージマネージャーがロックされているか、サーバーのパッケージインデックスが古くなっています（しばらくアップデートされていないテンプレートイメージで典型的です） | `sudo apt-get update`を実行し、他のaptプロセスが終了するのを待ってから、インストーラーを再実行してください。 |
| `openssl could not create the self-signed certificate` | OpenSSLの問題 | `openssl`をアップデートしてから再実行してください。 |

## インストール後 {#after-installation}

| 症状 | 原因 | 対処法 |
|---|---|---|
| ブラウザで`https://<domain>`を開けない | DNSまたはTLSの準備ができていません | `sudo nexcmp status`; [emergency access](https://nexcmp.com/ja/docs/getting-started/cli-reference/#emergency-access)を使用してください。 |
| `ERR_TOO_MANY_REDIRECTS` | CloudflareのSSLモードが**Flexible**になっている | **Full (strict)**を設定する — [詳細](https://nexcmp.com/ja/docs/getting-started/dns-and-cloudflare/)。 |
| ウィザードで「セットアップコード」が正しくないと表示される | 入力ミス、または以前のインストールのコードである | `sudo nexcmp status`を実行し、現在のコードをコピーする。 |
| ライセンスが HTTP 421 を返す | `/var/lib/nexcmp`内のファイルの所有者が root になっている | `sudo nexcmp fix-owner`、次に`sudo systemctl restart nexcmp`を実行する。 |