LinuxCommandLibrary

heroku

Manage and deploy Heroku applications

TLDR

Log in to your Heroku account

$ heroku login
copy

Create a Heroku app
$ heroku create
copy

Show logs for an app
$ heroku logs --app [app_name]
copy

Run a one-off process inside a dyno (Heroku virtual machine)
$ heroku run [process_name] --app [app_name]
copy

List dynos (Heroku virtual machines) for an app
$ heroku ps --app [app_name]
copy

Permanently destroy an app
$ heroku destroy --app [app_name]
copy

SYNOPSIS

heroku <command> [--app APP] [--remote REMOTE] [ARGS]
heroku [-v | --version] [-h | --help]

PARAMETERS

--app, -a APP
    specify the Heroku app to use

--remote, -r REMOTE
    specify git remote of app to use

--version, -v
    show Heroku CLI version

--help, -h
    show help for specified command

--interactive
    open browser for OAuth login

--json
    output in JSON format

--trace
    show full stack trace on error

--no-color
    disable colored output

--no-autoupdate
    disable auto-update checks

DESCRIPTION

The heroku command is the official Command Line Interface (CLI) tool for the Heroku cloud platform. It enables developers to manage applications, deployments, databases, add-ons, and more directly from the terminal.

Key functionalities include creating and configuring apps with heroku create, deploying code via Git (git push heroku main), scaling dynos (heroku ps:scale), viewing logs (heroku logs --tail), running one-off processes (heroku run), and managing config vars (heroku config).

Heroku CLI uses subcommands for operations, supports multiple apps via --app or Git remotes, and integrates with Heroku's PaaS for seamless CI/CD workflows. It's essential for Heroku users, installed via npm, Homebrew, or official scripts. Requires authentication via heroku login.

Output supports JSON for scripting, with tracing for debugging. Auto-updates and colorized output enhance usability.

CAVEATS

Requires Heroku account and authentication; not installed by default on Linux—use npm install -g heroku or snap. Git integration assumes Heroku remote setup. Rate limits apply to API calls.

COMMON SUBCOMMANDS

apps, create, logs, ps:scale, run, config, addons, open

INSTALLATION

Linux: wget -O- https://cli-assets.heroku.com/install.sh | sh or npm i -g heroku

HISTORY

Introduced in 2007 alongside Heroku platform. Ruby-based until 2018 rewrite using Salesforce's oclif framework for extensibility and performance. Current version 8.x supports modern features like Heroku Containers and Spaces.

SEE ALSO

git(1), npm(1)

Copied to clipboard