Documentation Updates

Before I create a Github issue from the ‘Provide Feedback’ link.

hass documentation link: https://www.home-assistant.io/docs/tools/hass/

Is the documentation relating to the CLI command hass still relevant? If it is not, I’ll submit a feedback but I wanted to make sure I am not missing something?

~ # hass --help
-bash: hass: command not found
~ # hass -h
-bash: hass: command not found
~ # ha
ha    halt  hash
~ #
~ # ha core info
arch: amd64
audio_input: null
audio_output: null
backups_exclude_database: false
boot: true
image: ghcr.io/home-assistant/qemux86-64-homeassistant
ip_address: 172.30.32.1
machine: qemux86-64
port: 8123
ssl: true
update_available: false
version: 2025.11.1
version_latest: 2025.11.1
watchdog: false
~ # ha supervisor info
addons:
- icon: true
  name: Let's Encrypt
  repository: core
  slug: core_letsencrypt
  state: stopped
  update_available: false
  version: 5.4.9
  version_latest: 5.4.9
- icon: true
  name: File editor
  repository: core
  slug: core_configurator
  state: started
  update_available: false
  version: 5.8.0
  version_latest: 5.8.0
- icon: true
  name: eufy-security-ws
  repository: 402f1039
  slug: 402f1039_eufy_security_ws
  state: started
  update_available: false
  version: 1.9.3
  version_latest: 1.9.3
- icon: true
  name: Network UPS Tools
  repository: a0d7b954
  slug: a0d7b954_nut
  state: started
  update_available: false
  version: 0.16.1
  version_latest: 0.16.1
- icon: true
  name: Syslog
  repository: 4f0066aa
  slug: 4f0066aa_syslog
  state: unknown
  update_available: false
  version: 0.4.1
  version_latest: 0.4.1
- icon: true
  name: Whisper
  repository: core
  slug: core_whisper
  state: started
  update_available: false
  version: 2.6.0
  version_latest: 2.6.0
- icon: true
  name: Piper
  repository: core
  slug: core_piper
  state: unknown
  update_available: false
  version: 1.6.4
  version_latest: 1.6.4
- icon: false
  name: openWakeWord
  repository: core
  slug: core_openwakeword
  state: started
  update_available: false
  version: 2.1.0
  version_latest: 2.1.0
- icon: true
  name: ESPresense Companion
  repository: f32ea98b
  slug: f32ea98b_espresense-companion
  state: unknown
  update_available: false
  version: 2.0.3
  version_latest: 2.0.3
- icon: true
  name: Everything Presence Zone Configurator
  repository: 234db91b
  slug: 234db91b_everything-presence-zone-configurator
  state: unknown
  update_available: false
  version: 1.2.2
  version_latest: 1.2.2
- icon: true
  name: SNMPD
  repository: ca021f77
  slug: ca021f77_snmpd
  state: started
  update_available: false
  version: 0.4.0
  version_latest: 0.4.0
- icon: true
  name: Advanced SSH & Web Terminal
  repository: a0d7b954
  slug: a0d7b954_ssh
  state: started
  update_available: true
  version: 21.0.4
  version_latest: 22.0.0
addons_repositories:
- name: Local add-ons
  slug: local
- name: SNMPD Home Assistant add-on
  slug: ca021f77
- name: 'Home Assistant Add-on: eufy-security-ws'
  slug: 402f1039
- name: Everything Presence Add-ons
  slug: 234db91b
- name: Home Assistant addons by bertbaron
  slug: 5f3a9361
- name: ESPresense Add-ons
  slug: f32ea98b
- name: Syslog Home Assistant add-on
  slug: 4f0066aa
- name: 'Home Assistant Add-on: Zigbee2MQTT'
  slug: 45df7312
- name: ESPHome
  slug: 5c53de3b
- name: Music Assistant
  slug: d5369777
- name: Official add-ons
  slug: core
- name: Home Assistant Community Add-ons
  slug: a0d7b954
arch: amd64
auto_update: true
channel: stable
country: US
debug: true
debug_block: false
detect_blocking_io: false
diagnostics: false
healthy: true
ip_address: 172.30.32.2
logging: info
supported: true
timezone: America/New_York
update_available: false
version: 2025.11.1
version_latest: 2025.11.1
wait_boot: 5

If you have a supervisor and add-ons you are not running a core installation. You are running either Supervised or HA OS.

Your HA CLI reference is here: Common tasks - Operating System - Home Assistant

Is hass supposed to be run in the HA container itself or in the HAOS host? From your output I am guessing you are at the OS or supervisor level and some commands might need to be executed in the core container.

Some info found on GitHub - home-assistant/operating-system: 🔰 Home Assistant Operating System

Home Assistant Operating System uses Docker as its container engine. By default it deploys the Home Assistant Supervisor as a container. Home Assistant Supervisor in turn uses the Docker container engine to control Home Assistant Core and Add-Ons in separate containers. Home Assistant Operating System is not based on a regular Linux distribution like Ubuntu. It is built using Buildroot and it is optimized to run Home Assistant. It targets single board compute (SBC) devices like the Raspberry Pi or ODROID but also supports x86-64 systems with UEFI.

Neither.

It is only available for core installation types. They do not have containers or the Home Assistant Operating system. They are the HA core only run on a Linux system as a service. This installation type has been removed from the documentation as it will be unsupported after the next major release. The hass page has been overlooked for removal.

1 Like

Ok check, thanks!

Aaah… that’s what I was missing. I was thinking HAOS was Core but that’s not the case. Thank you unmuddling that in my head! Glad I ask here rather than create an unnecessary doc feedback.