Home Assistant via the command line

Home Assistant upgrade process from the SSH command line

On the SSH command line, you can use the ha command to retrieve logs, check the details of connected hardware, and more.

Home Assistant

ha core check
ha core info
ha core logs
ha core options
ha core rebuild
ha core restart
ha core start
ha core stats
ha core stop
ha core update


ha supervisor info
ha supervisor logs
ha supervisor reload
ha supervisor update


ha host reboot
ha host shutdown
ha host update


ha hardware info
ha hardware audio

Usage examples

To update Home Assistant to a specific version, use the command:

ha core update --version=x.y.z

Replace x.y.z with the desired version like --version=0.74.2

You can get a better description of the CLI capabilities by typing ha help:

The Home Assistant CLI is a small and simple command line utility that allows
you to control and configure different aspects of Home Assistant

  ha [command]

Available Commands:
  addons         Install, update, remove and configure Home Assistant add-ons
  authentication Authentication for Home Assistant users.
  core           Provides control of the Home Assistant Core
  dns            Get information, update or configure the Home Assistant DNS server
  hardware       Provides hardware information about your system
  help           Help about any command
  host           Control the host/system that Home Assistant is running on
  info           Provides a general Home Assistant information overview
  os             Operating System specific for updating, info and configuration imports
  snapshots      Create, restore and remove snapshot backups
  supervisor     Monitor, control and configure the Home Assistant Supervisor

      --api-token string   Home Assistant Supervisor API token
      --config string      Optional config file (default is $HOME/.homeassistant.yaml)
      --endpoint string    Endpoint for Home Assistant Supervisor ( default is 'supervisor' )
  -h, --help               help for ha
      --log-level string   Log level (defaults to Warn)
      --no-progress        Disable the progress spinner
      --raw-json           Output raw JSON from the API

Use "ha [command] --help" for more information about a command.

Console access

You can also access the Home Assistant Operating System via a directly connected keyboard and monitor, the console. To log in to the physical console the username is root, with no password.