mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 13:26:54 +00:00
File access: tweak procedure on installing terminal and ssh add-on (#32790)
* File access: tweak procedure on installing terminal and ssh add-on * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Remove 'note' prefix * Update source/_includes/common-tasks/file_access.md Co-authored-by: Joakim Sørensen <joasoe@gmail.com> --------- Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
This commit is contained in:
parent
0c84119d8b
commit
cae34d918c
@ -1,6 +1,6 @@
|
||||
## Home Assistant via the command line
|
||||
|
||||
On the SSH command line, you can use the `ha` command to retrieve logs, check the details of connected hardware, and more.
|
||||
On the [SSH command line](/common-tasks/os/#installing-and-using-the-ssh-add-on), you can use the `ha` command to retrieve logs, check the details of connected hardware, and more.
|
||||
|
||||
### Home Assistant
|
||||
|
||||
|
@ -35,13 +35,29 @@ You would then enter the IP address or hostname of your Home Assistant OS instan
|
||||
|
||||
---
|
||||
|
||||
### Installing and using the SSH add-on (requires enabling advanced mode for the HA user)
|
||||
### Installing and using the SSH add-on
|
||||
|
||||
The Terminal & SSH add-on provides access over an SSH connection, and also includes nano and vi editors. It can be installed from the add-on store's Official add-on repository after enabling advanced mode for your Home Assistant user's profile. Additionally, this add-on provides access to the Home Assistant Command Line Interface (CLI) which provides custom commands for checking logs, stopping and starting Home Assistant and add-ons, creating/restoring backups, and more. (See [Home Assistant via Command Line](https://www.home-assistant.io/hassio/commandline/) for further info). The Terminal & SSH add-on does *not* provide access to the underlying host file system.
|
||||
If you want to use the Home Assistant command line or an SSH client, you can do this through the **Terminal & SSH** add-on.
|
||||
|
||||
To use the add-on, enter a password or public key on its configuration page, then save and start the add-on.
|
||||
The **Terminal & SSH** add-on provides the following functionalities:
|
||||
|
||||
The Terminal & SSH add-on also provides a web terminal which allows you to access a terminal via the Home Assistant user interface. In order to access from an ssh client, a port needs to be entered in the network section of the add-on's configuration page.
|
||||
- It provides a web terminal that you can access from the Home Assistant user interface.
|
||||
- It allows you to use the Home Assistant Command Line Interface (CLI) which provides custom commands for checking logs, stopping and starting Home Assistant and add-ons, creating/restoring backups, and more.
|
||||
- For a list of command line commands, refer to [Home Assistant via Command Line](/common-tasks/os#home-assistant-via-the-command-line).
|
||||
- It allows connecting to your system using an SSH client.
|
||||
- It also includes common tools like nano and vi editors.
|
||||
- The Terminal & SSH add-on does **not provide** access to the underlying host file system.
|
||||
|
||||
To get started with the **Terminal & SSH** add-on, follow these steps:
|
||||
|
||||
1. In the bottom left, select your user to open the {% my profile title="**Profile**" %} page. Make sure **Advanced Mode** is enabled.
|
||||
2. To install the add-on, go to the add-on store under [**Settings** > **Add-ons**](https://my.home-assistant.io/redirect/supervisor_addon/?addon=core_ssh) and install the **Terminal & SSH** add-on.
|
||||
3. To use the web terminal, **start** the add-on, then select **Open Web UI**.
|
||||
- You can now start typing your [commands](/common-tasks/os#home-assistant-via-the-command-line).
|
||||
4. If you want to access from an ssh client, you need to enter credentials:
|
||||
- Open the **Configuration** page.
|
||||
- Enter a password or authorized Keys.
|
||||
- Then save and start the add-on.
|
||||
|
||||
---
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user