HaraldNordgren/heroku-apps

Heroku Core CLI Plugin for managing Heroku apps

heroku-apps

This core plugin comes preinstalled to the Heroku CLI.

$ npm install -g @heroku-cli/plugin-apps
$ heroku COMMAND
running command...
$ heroku (-v|--version|version)
@heroku-cli/plugin-apps/2.4.39 linux-x64 node-v10.0.0
$ heroku --help [COMMAND]
USAGE
  $ heroku COMMAND
...

Command Topics

• heroku 2fa - disable 2fa on account

• heroku apps - creates a new app Examples:

  $ heroku apps:create Creating app... done, stack is cedar-14 https://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git

  or just

  $ heroku create

  specify a buildpack

  $ heroku apps:create --buildpack https://github.com/some/buildpack.git

  specify a name

  $ heroku apps:create example

  create a staging app

  $ heroku apps:create example-staging --remote staging

  create an app in the eu region

  $ heroku apps:create --region eu

• heroku auth - login with your Heroku credentials

• heroku buildpacks - add new app buildpack, inserting into list of buildpacks if necessary Example:

  $ heroku buildpacks:add -i 1 https://github.com/heroku/heroku-buildpack-ruby

• heroku config - display a config value for an app Example:

  $ heroku config:get RAILS_ENV production

• heroku domains - add domain to an app

• heroku drains - adds a log drain to an app

• heroku dyno - restart app dynos

if DYNO is not specified, restarts all dynos on app

Examples:

$ heroku ps:restart web.1
Restarting web.1 dyno... done

$ heroku ps:restart web
Restarting web dynos... done

$ heroku ps:restart
Restarting dynos... done

• heroku features - disables an app feature

• heroku keys - add an SSH key for a user if no KEY is specified, will try to find ~/.ssh/id_rsa.pub

Examples:

$ heroku keys:add
Could not find an existing public key.
Would you like to generate one? [Yn] y
Generating new SSH public key.
Uploading SSH public key /.ssh/id_rsa.pub... done

$ heroku keys:add /my/key.pub
Uploading SSH public key /my/key.pub... done

• heroku labs - enables an experimental feature

• heroku logout - clears local login credentials

• heroku maintenance - display the current maintenance status of app

• heroku notifications - display notifications

• heroku ps - list dynos for an app

Examples:

$ heroku ps
=== run: one-off dyno
run.1: up for 5m: bash

=== web: bundle exec thin start -p $PORT
web.1: created for 30s

$ heroku ps run # specifying types
=== run: one-off dyno
run.1: up for 5m: bash

• heroku releases - display the releases for an app

Example:

$ heroku releases
=== example Releases
v1 Config add FOO_BAR email@example.com 2015/11/17 17:37:41 (~ 1h ago)
v2 Config add BAR_BAZ email@example.com 2015/11/17 17:37:41 (~ 1h ago)
v3 Config add BAZ_QUX email@example.com 2015/11/17 17:37:41 (~ 1h ago)

• heroku twofactor - disable 2fa on account