Skip Navigation
Show nav
Dev Center
  • Get Started
  • ドキュメント
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
    • .NET
  • ドキュメント
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
Hide categories

Categories

  • Heroku のアーキテクチャ
    • コンピューティング (dyno)
      • dyno の管理
      • dyno の概念
      • dyno の動作
      • dyno の参照資料
      • dyno のトラブルシューティング
    • スタック (オペレーティングシステムイメージ)
    • ネットワーキングと DNS
    • プラットフォームポリシー
    • プラットフォームの原則
  • 開発者ツール
    • コマンドライン
    • Heroku の VS Code 拡張機能
  • デプロイ
    • Git を使用したデプロイ
    • Docker によるデプロイ
    • デプロイ統合
  • 継続的デリバリーとインテグレーション
    • 継続的統合
  • 言語サポート
    • Node.js
      • Node.js アプリのトラブルシューティング
      • Heroku での Node.js の動作
      • Node.js の操作
    • Ruby
      • Rails のサポート
      • Bundler の使用
      • Ruby の操作
      • Heroku での Ruby の動作
      • Ruby アプリのトラブルシューティング
    • Python
      • Python の操作
      • Python でのバックグラウンドジョブ
      • Heroku での Python の動作
      • Django の使用
    • Java
      • Heroku での Java の動作
      • Java の操作
      • Maven の使用
      • Spring Boot の使用
      • Java アプリのトラブルシューティング
    • PHP
      • PHP の操作
      • Heroku での PHP の動作
    • Go
      • Go の依存関係管理
    • Scala
    • Clojure
    • .NET
      • Working with .NET
  • データベースとデータ管理
    • Heroku Postgres
      • Postgres の基礎
      • Postgres スターターガイド
      • Postgres のパフォーマンス
      • Postgres のデータ転送と保持
      • Postgres の可用性
      • Postgres の特別なトピック
      • Heroku Postgres への移行
    • Heroku Key-Value Store
    • Apache Kafka on Heroku
    • その他のデータストア
  • AI
    • Vector Database
    • Working with AI
    • Heroku Inference
      • AI Models
      • Inference Essentials
      • Heroku Inference Quick Start Guides
      • Inference API
    • Model Context Protocol
  • モニタリングとメトリクス
    • ログ記録
  • アプリのパフォーマンス
  • アドオン
    • すべてのアドオン
  • 共同作業
  • セキュリティ
    • アプリのセキュリティ
    • ID と認証
      • シングルサインオン (SSO)
    • Private Space
      • インフラストラクチャネットワーキング
    • コンプライアンス
  • Heroku Enterprise
    • Enterprise Accounts
    • Enterprise Team
    • Heroku Connect (Salesforce 同期)
      • Heroku Connect の管理
      • Heroku Connect のリファレンス
      • Heroku Connect のトラブルシューティング
  • パターンとベストプラクティス
  • Heroku の拡張
    • Platform API
    • アプリの Webhook
    • Heroku Labs
    • アドオンのビルド
      • アドオン開発のタスク
      • アドオン API
      • アドオンのガイドラインと要件
    • CLI プラグインのビルド
    • 開発ビルドパック
    • Dev Center
  • アカウントと請求
  • トラブルシューティングとサポート
  • Salesforce とのインテグレーション
  • 開発者ツール
  • コマンドライン
  • Heroku CLI

Heroku CLI

日本語 — Switch to English

最終更新日 2025年03月19日(水)

Table of Contents

  • Heroku CLI のインストール
  • インストールの検証
  • Heroku CLI の開始
  • 最新の状態の維持
  • 有用な CLI プラグイン
  • CLI アーキテクチャ
  • Heroku CLI のトラブルシューティング
  • Heroku CLI のアンインストール

Heroku コマンドラインインターフェース (CLI) は、Heroku を使用するうえで不可欠な部分です。それを使用して、ターミナルから直接 Heroku アプリを作成し、管理できます。

Heroku CLI のインストール

前提条件

Heroku CLI には、一般によく使われている Git​ というバージョン管理システムが必要です。Git がインストールされていない場合は、次の手順を完了してください。

  • ​Git のインストール
  • ​Git の初期設定

インストーラによるインストール

Windows インストーラで、一部のユーザーに警告が表示されます。この「Windows によって PC が保護されました」という警告が表示されたときにインストールを実行するには、詳細 をクリックし、発行元が salesforce.com, inc​ であることを確認してから 実行 ボタンをクリックします。

 

Snap のインストールはサポートされなくなりました。次のいずれかのインストール方法を使用します。

apple ロゴ​macOS

​Homebrew をインストール​して実行します。

​$ ​brew install heroku/brew/heroku

windows ロゴ​Windows

​ご使用の Windows に合ったインストーラをダウンロードします。

​64 ビット用インストーラ

​32 ビット用インストーラ

インストール後、heroku autocomplete​ を使用して CLI のオートコンプリート機能を有効にすることを推奨します。

tar 書庫によるスタンドアロンインストール

スタンドアロンインストールは、バイナリを使用した単純な tar 書庫です。これは独自の Node.js バイナリを含み、自動更新を行います。

CLI を /usr/local/lib/heroku​ および /usr/local/bin/heroku​ で設定するには、次のスクリプトを実行します。このスクリプトでは sudo が必要で、Windows に対応していません。

$ curl https://cli-assets.heroku.com/install.sh | sh

次のいずれかの tar 書庫をダウンロードして、自分で展開することもできます。

tar 書庫

これらの tar 書庫は gz​ または xz​ 圧縮で使用できます。xz​は非常に小さくなりますが、gz​ は互換性が高くなります。

  • macOS (m1)
  • macOS (Intel)
  • Linux (x64)
  • Linux (arm)
  • Windows (x64)
  • Windows (x86)

Ubuntu / Debian apt-get でのインストール

$ curl https://cli-assets.heroku.com/install-ubuntu.sh | sh

このバージョンでは、自動更新を行いません。apt-get​を使用して手動で更新してください。CLI の自動更新バージョンにはスタンドアロンインストール​を使用します。

Arch Linux のためのインストール

コミュニティによってメンテナンスされている heroku-cli 7.60.1-1​ をインストールします。

$ yay -S heroku-cli

npm でのインストール

CLI は Node.js でビルドされ、npm​ を介してインストールできます。この手動インストール方法は、自動更新が理想的ではない環境や、Heroku が事前ビルドされた Node.js バイナリを提供していない環境で使用してください。ARM および BSD では、このインストール方法を使用する必要があります。node​と npm​ がすでにインストールされている必要があります。この方法は、テスト済みのスクリプトで行うように、CLI の更新をきめ細かく制御する場合にも役立ちます。

可能であれば他のいずれかのインストール方法を使用することを強くお勧めします。

npm によるインストール方法では、自動更新は行われません。また、システムのバージョンの Node.js を使用する必要がありますが、このバージョンは、Heroku が開発した CLI の対象のバージョンよりも古い可能性があります。Heroku は最新のリリースの Node.js を使用し、古いバージョンをサポートしません。

他のインストール方法には、適切なバージョンの Node.js が含まれており、システム上の他のどのバージョンとも競合しません。

また、yarn を使用してインストールする場合でも、npm は他の方法と違って依存関係に yarn ロックファイルを使用しません。マイナーまたはパッチリリースで CLI の依存関係の互換性がなくなった場合、npm は問題の原因になる可能性があります。

$ npm install -g heroku

インストールの検証

CLI インストールを検証するには、heroku --version​ コマンドを使用します。

$ heroku --version
heroku/7.0.0 (darwin-x64) node-v8.0.0

この出力は heroku/x.y.z​ のように見えます。その出力は表示されないが、Heroku CLI をインストールしている場合は、システム上に古い heroku​ gem が存在するかどうかを確認します。これらの手順​を使用してアンインストールしてください。

Heroku CLI の開始

CLI をインストールした後、heroku login​ コマンドを実行します。

$ heroku login
heroku: Press any key to open up the browser to login or q to exit
 ›   Warning: If browser does not open, visit
 ›   https://cli-auth.heroku.com/auth/browser/***
heroku: Waiting for login...
Logging in... done
Logged in as me@example.com

そのまま CLI を使用して資格情報を入力する場合は、heroku login -i​ を実行します。

多要素認証​を有効にしている場合、検証について Web ブラウザへ技術的に依存するため、-i​ オプションを使用できません。

$ heroku login -i
heroku: Enter your login credentials
Email: me@example.com
Password: ***************
Two-factor code: ********
Logged in as me@heroku.com

CLI は、将来使用できるように、メールアドレスと API トークンを ~/.netrc​ に保存します。詳細については、「Heroku CLI Authentication​」(Heroku CLI 認証) を参照してください。

これで、最初の Heroku アプリを作成する準備ができました。

$ cd ~/myapp
$ heroku create
Creating app... done, ⬢ sleepy-meadow-81798
https://sleepy-meadow-81798.herokuapp.com/ | https://git.heroku.com/sleepy-meadow-81798.git

最初のアプリのデプロイの包括的な概要については、ご希望の言語のスターターガイド​を確認してください。コマンドの完全なリストについては、「Heroku CLI コマンド​」を参照してください。

最新の状態の維持

Debian/Ubuntu パッケージ​をインストールした、または npm install​ を使用した​場合以外は、Heroku CLI はそれ自体とそのプラグイン (リンク先のプラグインを除く) を自動的に最新の状態に保ちます。

heroku​ コマンドを実行すると、バックグラウンドプロセスによって CLI の最新の使用可能バージョンが確認されます。新しいバージョンが見つかると、ダウンロードされ、~/.local/share/heroku/client​ に保存されます。このバックグラウンドチェックは最大 4 時間ごとに 1 度行われます。

元々インストールされていたクライアントを使用する前に、heroku​ バイナリは ~/.local/share/heroku/client​ の最新のクライアントをチェックします。

最新リリースの SHA

​

Darwin

* [arm](https://cli-assets.heroku.com/channels/stable/heroku-darwin-arm64-buildmanifest) * [x64](https://cli-assets.heroku.com/channels/stable/heroku-darwin-x64-buildmanifest)

Linux

* [arm](https://cli-assets.heroku.com/channels/stable/heroku-linux-arm-buildmanifest) * [x64](https://cli-assets.heroku.com/channels/stable/heroku-linux-x64-buildmanifest)

Windows

* [x64](https://cli-assets.heroku.com/channels/stable/heroku-win32-x64-buildmanifest) * [x86](https://cli-assets.heroku.com/channels/stable/heroku-win32-x86-buildmanifest)

有用な CLI プラグイン

`heroku plugins:install someplugin`​ を使用して CLI プラグインをインストールし、CLI インストールを拡張することができます。プラグイン管理についての詳細は、「[CLI プラグインの使用](https://devcenter.heroku.com/articles/using-cli-plugins)​」を参照してください。 有用なプラグインをいくつか示します。 * [@heroku-cli/plugin-api](https://github.com/heroku/heroku-api-plugin)​ — `heroku api GET /account`​ などのアドホックな API リクエストを作成します。 * [@heroku-cli/heroku-builds](https://github.com/heroku/heroku-builds)​ — ビルドを表示し、ビルドキャッシュをパージし、tar 書庫からビルドを作成します。 * [heroku-repo](https://github.com/heroku/heroku-repo)​ — コマンドを使用してアプリの Heroku Git リポジトリを操作します。 * [heroku-pg-extras](https://github.com/heroku/heroku-pg-extras)​ — 追加の `heroku pg:*`​ コマンドを提供します。 * [heroku-slugs](https://github.com/heroku/heroku-slugs)​ — アプリ slug をダウンロードします。 * [heroku-kafka](https://github.com/heroku/heroku-kafka-jsplugin)​ — Heroku Kafka を管理します。 * [heroku-guardian](https://github.com/heroku/heroku-guardian)​ — アプリ、領域、ユーザーの保護に役立つ Heroku のさまざまな設定を表示します。 * [heroku-papertrail](https://github.com/papertrail/papertrail-heroku-plugin)​ — [Papertrail](https://elements.heroku.com/addons/papertrail)​ でログを表示、末尾監視、および検索します。 * [advanced-scheduler](https://github.com/oavanruiten/advanced-scheduler)​ — [Advanced Scheduler](https://elements.heroku.com/addons/advanced-scheduler)​ トリガーを作成して管理します。 * [heroku-cron](https://github.com/crazyantlabs/heroku-buildpack-cli-plugin-cron)​ — 対話型コマンドラインを使用して、またはデプロイ後のスクリプトでマニフェストファイルを使用して [Cron To Go](https://elements.heroku.com/addons/crontogo)​ ジョブを作成、管理、監視します。 * [borealis-pg](https://github.com/OldSneerJaw/borealis-pg-cli)​ — [Borealis Isolated Postgres](https://elements.heroku.com/addons/borealis-pg)​ アドオンとの高度な対話を可能にします。

CLI アーキテクチャ

Heroku CLI は、Heroku/Salesforce 内で開発された Open CLI Framework ([oclif](https://oclif.io))​ でビルドされます。oclif は、開発者が大型または小型の CLI をビルドするためのフレームワークとして使用できます。フレームワークには、CLI ジェネレーター、ドキュメント自動作成、テストインフラストラクチャが含まれます。 Heroku CLI のコードは[オープンソース](https://github.com/heroku/cli)​でもあります。Node.js や他の依存関係を実行する必要は​_ありません_。[Debian/Ubuntu パッケージ](#install-with-ubuntu-debian-apt-get)​をインストールしたり、[`npm install`](#install-with-npm)​ を使用したりする場合以外は、CLI には、他のアプリケーションと競合しない独自の Node.js バイナリが含まれます。

Heroku CLI のトラブルシューティング

>note >すべてのインストール方法が `heroku update`​ をサポートしているわけではありません。 > > * `apt`​ で CLI をインストールした場合は、`sudo apt-get update && sudo apt-get upgrade heroku`​ を使用する必要があります。 > * `npm`​ または `yarn`​ で CLI をインストールした場合は、`npm upgrade -g heroku`​ または `yarn global upgrade heroku`​ を使用する必要があります。 CLI が更新できない場合は、[アンインストール](#uninstall-the-heroku-cli)​してから再インストールしてください。`which heroku`​または `where heroku`​ (Windows の場合) を使用して `heroku`​ コマンドが示しているものを確かめることによって、従来の Heroku Toolbelt または Heroku Ruby gem がインストールされていないことを確認します。一部のユーザーは `PATH`​ を変更して指定する必要があります (ほとんどのインストール環境では `/usr/local/bin/heroku`​)。 引き続き問題が発生する場合は、次のデバッグ環境変数を設定し、問題の診断に役立ててください。 | 環境変数 | 説明 | | ————- | ————- | | `HEROKU_DEBUG=1`​ | Heroku API インタラクションに主に関連したデバッグ情報を表示します | | `HEROKU_DEBUG_HEADERS=1`​ | `HEROKU_DEBUG=1`​ と一緒に、HTTP ヘッダーを表示します | | `DEBUG=*`​ | 冗長なデバッグ情報を表示します | オペレーティングシステムに応じて次の場所のいずれかに保存された CLI のエラーログファイルもチェックできます。 | OS | 場所 | | ————- | ————- | | macOS | `~/Library/Caches/heroku/error.log`​ | | Windows | `%LOCALAPPDATA%\heroku\error.log`​ | | Linux/その他 | `~/.cache/heroku/error.log`​ (または設定されている場合は `XDG_CACHE_HOME`​) | 問題の発生が続き、CLI が最新の場合、またはその他の理由で更新が失敗した場合、ユーザーディレクトリを削除することよって、CLI をリセットできます。これらのディレクトリは自動的に置き換えられます。これらを削除してもログアウトされませんが、インストールしたプラグインが失われます。 まず、確実に再インストールできるように、`heroku plugins`​ を実行してインストールしたプラグインを一覧表示します。 続いて、次のディレクトリを削除します。 Windows: * `%LOCALAPPDATA%\heroku` macOS/Linux/その他: * `~/.local/share/heroku`​ (または設定されている場合は `XDG_DATA_HOME`​) * macOS では `~/Library/Caches/heroku`​、Linux/その他では `~/.cache/heroku`​ (または設定されている場合は `XDG_CACHE_HOME`​)

ログインの問題

ログインに問題がある場合は、.netrc​ ファイルを移動します。このファイルは、CLI が証明書を保存する場所です。

$ mv ~/.netrc ~/.netrc.backup
$ heroku login

Windows では、ファイルに _netrc​ という名前が付けられます。

Homebrew 固有の問題

最新の Homebrew バージョンの heroku​ をインストールしていても、従来の警告が表示された場合、PATH​ 環境変数内のバイナリ heroku​ コマンドが、brew がインストールしたバージョンを示していません。

バイナリ heroku​ がポイントしているものを確認するには、which heroku​ を実行します。/usr/local/bin/heroku​をポイントしていない場合、ポイントされているバイナリを削除します。~/.bashrc​ファイルまたは同等のファイルを変更することにより、PATH​ 環境変数内で /usr/local/bin/​ をさらに上位にすることもできます。

次に brew link --overwrite heroku​ を実行して、/usr/local/bin/heroku​ が新しい CLI をポイントしていることを確認します。問題が解決しない場合、brew doctor​ を実行してシステムの問題を特定します。

Apple シリコンの問題

Apple M1 チップを搭載したマシンで次のエラーが発生する場合、Rosetta 2 がインストールされていないか、インストールが拒否されています。

Bad CPU type in executable

Rosetta 2​ をインストールすると、この問題が解決します。

Rosetta 2 をマシンにインストールしたくない場合、Heroku npm パッケージをグローバルにインストール​して、独自の Node バイナリをローカルで使用することができます。Node の v16 のみが M1 ARM をサポートしており、npm は推奨されるインストール方法ではありません。

Heroku CLI のアンインストール

このアクションにより、すべての CLI プラグインも削除されます。

macOS

macOS で、次のように入力して CLI をアンインストールできます。

$ rm -rf /usr/local/heroku /usr/local/lib/heroku /usr/local/bin/heroku ~/.local/share/heroku ~/Library/Caches/heroku

Homebrew のインストール

Homebrew を使用して Heroku CLI をインストールした場合、次のように入力して CLI をアンインストールできます。

$ brew uninstall heroku
$ rm -rf ~/.local/share/heroku ~/Library/Caches/heroku

Linux

スタンドアロンインストール

スタンドアロンインストールの場合、次のように入力して CLI をアンインストールできます。

$ rm /usr/local/bin/heroku
$ rm -rf /usr/local/lib/heroku /usr/local/heroku
$ rm -rf ~/.local/share/heroku ~/.cache/heroku

Debian および Ubuntu のインストール

Debian/Ubuntu の場合、次のように入力して CLI をアンインストールできます。

$ sudo apt-get remove heroku heroku-toolbelt
$ sudo rm /etc/apt/sources.list.d/heroku.list

$XDG_DATA_HOME​ や $XDG_CACHE_HOME​ がある場合、~/.local/share​ と ~/.cache​ の代わりにこれらの変数を使用します。

次のコマンドを実行することでリリースキーを削除できます。

$ sudo apt-key list
$ sudo apt-key del KEYFROMABOVE

Windows

Windows で、Heroku CLI をアンインストールするには次の手順を実行します。

  1. スタート メニューから、コントロールパネル、プログラム、プログラムと機能 の順にクリックします。
  2. Heroku CLI (Heroku CLI) を選択してから、Uninstall (アンインストール) をクリックします。アンインストーラは署名されていません。

Windows アンインストーラは CLI と一緒に自動的に更新され​ません。初めて CLI をインストールしてから日数が経過している場合、最新バージョンの CLI を手動でインストールして、最新のアンインストーラを入手します。

アンインストールがうまくいかない場合、Program Files 内のディレクトリと一緒に %LOCALAPPDATA%\heroku​ を手動で削除してください。

従来の Heroku gem のアンインストール

実行可能ファイルの場所を見つけるには、which​ を実行します。

$ which heroku
/usr/local/heroku/bin/heroku

heroku​ コマンドへのパスは Ruby gem ディレクトリにしないでください。

そのようになっている場合、これと他のすべての heroku​ gem をアンインストールします。

$ gem uninstall heroku --all

関連カテゴリー

  • コマンドライン
アプリのローカルでの実行 Heroku CLI コマンド

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure
  • .NET

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing
  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Github
  • LinkedIn
  • © 2025 Salesforce, Inc. All rights reserved. Various trademarks held by their respective owners. Salesforce Tower, 415 Mission Street, 3rd Floor, San Francisco, CA 94105, United States
  • heroku.com
  • Legal
  • Terms of Service
  • Privacy Information
  • Responsible Disclosure
  • Trust
  • Contact
  • Cookie Preferences
  • Your Privacy Choices