npm インストール
npm は、ローカルコンピューターで n8n を素早く起動する方法の一つです。事前に Node.js がインストールされている必要があります。n8n を実行するには、Node.js バージョン 20.19 以上 24.x 以下（いずれも含む）が必要です。
安定版とベータ版
n8n はほぼ毎週新しいバージョンをリリースしています。stable 版は本番環境向けであり、beta 版は最新リリース版ですが安定性に欠ける可能性があります。問題のフィードバックは、コミュニティフォーラムをご利用ください。
現在の stable バージョン：2.10.2
現在の beta バージョン：2.11.1
npx を使って n8n を試す
npx を使えば、インストールせずにすぐに n8n を試せます。
ターミナルで以下のコマンドを実行してください：
npx n8n
このコマンドにより、n8n の起動に必要なすべてのファイルがダウンロードされます。完了後、ブラウザで http://localhost:5678 にアクセスすると、n8n に接続でき、ワークフローの構築を開始できます。
npm で n8n をグローバルインストールする
npm を使って n8n をグローバルにインストールします：
npm install n8n -g
@ 構文を使って特定のバージョンを指定し、そのバージョンにインストールまたは更新することも可能です。例：
npm install -g [email protected]
next バージョンをインストールするには：
npm install -g n8n@next
インストールが完了したら、以下のコマンドで n8n を起動します：
n8n
# または
n8n start
次のステップ
クイックスタートガイドを使用して、n8n の機能を体験してください。
更新
n8n のバージョンを latest に更新するには：
npm update -g n8n
next バージョンをインストールするには：
npm install -g n8n@next
n8n トンネルの使用
危険
ローカル開発およびテスト専用であり、本番環境での使用は推奨されません。
開発ツール
トンネル機能はローカル開発のための便利なツールですが、その内部実装は n8n のバージョンアップに伴い変更される可能性があります。
GitHub などの外部サービスのトリガーノードで Webhook 機能を利用するには、インターネットから n8n にアクセスできる必要があります。n8n は cloudflared を使ってトンネルサービスを提供し、外部からのリクエストをローカルの n8n インスタンスに転送します。このトンネル機能には Docker のインストールが必要です。
Docker のインストールが必要
トンネルは cloudflared を使用しますが、これは Docker コンテナとして動作します。npm で n8n を実行している場合でも、マシンに Docker をインストールしておく必要があります。
💡 注意：以下の
pnpmコマンドは、n8n のソースコードをクローンして開発環境を構築している場合にのみ利用できます。npm install -g n8nでインストールしたユーザーは、この方法を利用できません。
npm インストール方式の場合、cloudflared を独立したサービスとして起動し、別途ローカルで n8n を実行します：
# ターミナル 1：cloudflared トンネルサービスを起動
pnpm --filter n8n-containers services --services cloudflared
# ターミナル 2：ローカルで n8n を起動
pnpm dev
services コマンドは cloudflared を起動し、パブリックなトンネル URL を取得したうえで、WEBHOOK_URL および N8N_PROXY_HOPS=1 を含む .env ファイルを packages/cli/bin/.env に書き込みます。n8n は起動時に自動的にこの .env ファイルを読み込みます。
終了後は、以下でクリーンアップしてください：
pnpm --filter n8n-containers services:clean
フルスタック方式（n8n と cloudflared の両方をコンテナで実行する方法）については、Docker トンネル設定のドキュメントをご参照ください。
ロールバック
以前のバージョンに戻したい場合は、該当する旧バージョンをインストールしてください。
アップグレードにデータベースマイグレーションが含まれる場合：
- 機能ドキュメントおよびリリースノートを確認し、手動での変更が必要かどうかを確認してください。
- 現在のバージョンで
n8n db:revertを実行し、データベースをロールバックします。複数のマイグレーションを巻き戻す必要がある場合は、この操作を繰り返してください。
Windows でのトラブルシューティング
Windows 上で n8n を実行中に問題が発生した場合は、Node.js 環境が正しく設定されていることを確認してください。Microsoft のガイド「Windows に Node.js をインストールする方法」をご参照ください。