クイック概要: n8n をローカルで実行するには、npm (Node.js 20.19〜24.x) または Docker のいずれかが必要です。最も簡単な方法は、インストールなしですぐにテストできる npx n8n を使用することですが、Docker はより優れた分離と本番環境 readiness を提供します。どちらの方法でも、クラウドの継続的なコストなしに、n8n のワークフロー自動化機能に完全にアクセスできます。
ローカルマシンに n8n をセットアップすると、ワークフロー自動化の完全な制御を維持しながら、継続的なサブスクリプション料金を排除できます。公式の n8n ドキュメントによると、プラットフォームは npm インストールには Node.js バージョン 20.19 から 24.x、またはコンテナ化されたデプロイメントには Docker を必要とします。
ローカルホスティングとクラウドサービスの間でどちらを選択するかは、予算と柔軟性の両方に影響します。コミュニティの議論によると、ローカルインストールは無制限のワークフローを処理できますが、クラウドプランには実行ベースの価格設定が含まれています（一部のユーザーレポートによると、2,500回の実行で月額 24 ドルから）。
ローカルインストールの前提条件
n8n をローカルにインストールする前に、選択した方法に応じてシステムに特定のソフトウェアが必要です。
npm インストールに必要な Node.js バージョンは、デプロイしている n8n バージョンの特定の要件に完全に依存します。npm 自体は、現在サポートされているすべての Node.js LTS バージョンと互換性があります。公式ドキュメントは、互換性のためにこの正確なバージョン範囲を指定しています。ターミナルで `node --version` を実行して現在のバージョンを確認してください。
Docker インストールには Docker Engine または Docker Desktop が必要です。n8n チームは、クリーンな分離を提供し、オペレーティングシステムの非互換性を回避するため、ほとんどのセルフホスティングニーズには Docker を推奨しています。
システム要件
ローカル n8n インスタンスは、Windows、macOS、Linux システムで実行されます。公式ドキュメントには最小 RAM 仕様は記載されていませんが、ワークフローの複雑さが実際の必要なリソースを決定します。
インストールは、初期段階では最小限のディスクスペースを消費します。ストレージ要件は、ワークフローデータ、実行履歴、カスタムノードパッケージに基づいて増加します。
方法 1: npm で n8n を実行する
npm インストールは、n8n をローカルで実行するための最も速いパスを提供します。この方法は、コンテナ化なしでホストシステム上で直接機能します。
npx でのクイックスタート
最も簡単なアプローチは、永続的なインストールなしで npx を使用することです。ターミナルを開いて実行します。
| npx n8n |
このコマンドは必要なものをすべてダウンロードし、n8n を自動的に起動します。インターフェイスは数秒以内に localhost:5678 でアクセス可能になります。
npx メソッドは、テストと評価に最適です。グローバル npm パッケージや永続的なシステム変更は必要ありません。
グローバル npm インストール
永続的なインストールの場合、グローバル npm パッケージは一貫したアクセスを提供します。
| npm install n8n -g |
インストールが完了したら、いつでも次を実行して n8n を起動できます。
| n8n |
n8n の現在の主要な安定バージョンは 2.x (例: 2.10.4) です。ベータ版には不安定な機能が含まれている可能性があり、本番ワークフローでは避けるべきです。
設定とデータストレージ
npm インストールは、デフォルトでワークフローデータを `~/.n8n` ディレクトリに保存します。この場所には、資格情報、ワークフロー定義、および実行履歴が含まれます。
環境変数は n8n の動作を制御します。N8N_PORT 変数を設定して、デフォルトのポート 5678 を変更します。他の変数は、データベース接続、Webhook URL、および認証設定を構成します。
方法 2: Docker で n8n を実行する
Docker インストールは、ローカル n8n ホスティングの推奨アプローチです。公式ドキュメントは、本番環境のセルフホスティングニーズには Docker を強調しています。
基本的な Docker 実行コマンド
単一の Docker コマンドで n8n を起動します。
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
このコマンドは、n8n という名前のコンテナを作成し、ポート 5678 をホストにマッピングし、`~/.n8n` ディレクトリにデータを永続化します。
コンテナは `-it` フラグでインタラクティブに実行されます。コンテナを停止した後に保持するには `--rm` を削除します。
本番環境セットアップのための Docker Compose
Docker Compose 設定は、本番環境により良い制御を提供します。GitHub の n8n-hosting リポジトリには、さまざまなアーキテクチャ用のすぐに使用できる Docker Compose ファイルが含まれています。
基本的な `docker-compose.yml` 設定は次のようになります。
| version: '3.8' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
スタックを次で起動します。
| docker-compose up -d |
`-d` フラグはコンテナをデタッチモードで実行し、ターミナルを他のタスクに使用できるようにします。
初期設定とアクセス
どちらかの方法で n8n を起動した後、Web ブラウザで localhost:5678 にアクセスします。最初のセットアップ画面では、管理者アカウントのメールアドレスとパスワードが要求されます。
この最初のユーザーは、完全な管理者権限を持つインスタンスのオーナーになります。後でユーザー管理インターフェイスを通じて追加ユーザーを追加できます。
認証設定
セキュリティのため、ローカルインストールでも認証を有効にしてください。Docker Compose 設定は、認証環境変数を直接受け入れます。
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
これらの変数は HTTP 基本認証をアクティブにし、すべてのアクセス試行に資格情報を要求します。
ローカルでのカスタムノードのテスト
公式ドキュメントでは、開発中にカスタムノードをテストする方法が説明されています。まず n8n をグローバルにインストールし、次にカスタムノードパッケージをビルドしてリンクします。
カスタムノードディレクトリで、次を実行します。
| npm run build npm link |
次に、n8n ノードディレクトリ（通常は `~/.n8n/custom/`）に移動して、パッケージをリンクします。
| npm link <node-package-name> |
インスタンスを再起動すると、カスタムノードが n8n インターフェイスに表示されます。
n8n と共に使用するのに役立つ自動化リソース
n8n をローカルで実行する方法を学んでいて、マシンでワークフローをテストしている場合、一般的なタスクを自動化しやすくする外部ヘルパーやテンプレートも役立つかもしれません。Get AI Perks は、n8n と共に使用したり、自分で構築する前に自動化アイデアをプロトタイプしたりできるワークフローテンプレートと AI アシストツールのライブラリを提供しています。
Get AI Perks を使用すると、次のことが可能です。
- 事前構築されたワークフローテンプレートから開始する
- 定型的なロジックとコンテンツの AI アシスタンスを得る
- n8n で実装する前に一般的な自動化パターンを探索する
- テンプレートとローカル n8n セットアップを組み合わせる
Get AI Perks を見つけて、n8n ワークフローをサポートする自動化ヘルパーを見つけてください。
一般的な問題のトラブルシューティング
ポートの競合は、最も一般的なインストール問題です。ポート 5678 が既に使用されている場合は、競合するサービスを停止するか、N8N_PORT 環境変数を使用して n8n のポートを変更してください。
Node バージョンの非互換性
20.19〜24.x の範囲外の Node.js バージョンを使用すると、インストールに失敗します。n8n GitHub リポジトリは、開発者がローカル開発環境を試みた際の問題を文書化しており、Node バージョンの互換性の重要性を強調しています。
他の問題をトラブルシューティングする前に、Node バージョンの互換性を確認してください。必要に応じて nvm（Node Version Manager）を使用して Node バージョンを切り替えてください。
Docker ボリュームの権限エラー
`~/.n8n` ボリュームマウントでの権限の問題は、データの永続化を妨げます。Docker コンテナは node ユーザーとして実行され、ホストディレクトリへの書き込みアクセス権がない場合があります。
コンテナを起動する前に、適切な権限でディレクトリを作成します。
| mkdir ~/.n8n chmod 777 ~/.n8n |
よくある質問
n8n はインターネットアクセスなしで実行できますか？
はい、n8n はローカルワークフローでは完全にオフラインで機能します。インターネット接続は、ワークフローが外部 API やクラウドサービスとやり取りする場合にのみ必要になります。
n8n をローカルで実行するといくら費用がかかりますか？
ローカルインストールは無料です。コミュニティエディションは、ライセンス料金なしですべてのコア機能を提供します。クラウドホスティングは実行制限と月額料金から始まりますが、コミュニティの議論によると、ローカルホスティングはこれらの制限を完全に排除します。
初心者は npm と Docker のどちらを使うべきですか？
n8n をテストする初心者は、すぐにアクセスできるように npx から始めるべきです。Docker は、より優れた分離と簡単なアップグレードを提供するため、継続的な使用にはより適しています。
n8n はローカルでワークフローデータをどこに保存しますか？
デフォルトのデータディレクトリは、ユーザーのホームフォルダにある `~/.n8n` です。この場所には、明示的に設定されていない限り、SQLite データベースファイル、資格情報、および実行ログが含まれています。
1台のマシンで複数の n8n インスタンスを実行できますか？
はい、ただし、各インスタンスには一意のポートが必要です。各インスタンスで N8N_PORT 環境変数を使用して異なるポートを設定します。Docker は、個別のコンテナでのポートマッピングを通じてこれを容易にします。
ローカルインストールではアップデートはどのように機能しますか？
npm インストールは `npm update -g n8n` または `npm install -g n8n@latest` を介して更新されます。Docker ユーザーは `docker pull n8nio/n8n` で最新のイメージをプルしてから、コンテナを再作成します。更新する前に、必ず `~/.n8n` ディレクトリをバックアップしてください。
本番環境の考慮事項
公式の n8n ドキュメントは、セルフホスティングには技術的な知識が必要であることを強調しています。サーバーのセットアップ、リソースの管理、アプリケーションのセキュリティ保護には、システム管理の経験が必要です。
本番環境へのデプロイメントには、Docker Compose が基盤となります。HTTPS サポートのために nginx や Caddy のようなリバースプロキシを追加します。n8n-hosting リポジトリには、デプロイメント用の Caddy 設定が含まれています。
データベースの選択は、高負荷のワークロードにとって重要です。デフォルトの SQLite データベースは適度な使用には適していますが、公式のガイダンスによると、PostgreSQL は大量の自動化に対してより良いパフォーマンスを提供します。
選択の決定: ローカル vs クラウド
ローカル n8n ホスティングは、技術的な能力と特定のセキュリティ要件を持つチームに適しています。データは管理されたインフラストラクチャに保持され、実行制限はなくなります。
ただし、ローカルホスティングにはメンテナンス、バックアップ、監視が必要です。クラウドホスティングは、これらの責任を n8n のインフラストラクチャチームに移管します。現在のクラウド価格設定と機能比較については、公式ウェブサイトを確認してください。
n8n をローカルで実行すると、ワークフロー自動化インフラストラクチャを完全に制御できます。迅速なテストには npm を使用する場合でも、本番環境のデプロイメントには Docker を使用する場合でも、どちらの方法も継続的なコストなしにプラットフォーム全体を提供します。すぐに探索するには npx から始め、ワークフローが本番環境の使用に向かうにつれて Docker に移行してください。
