jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 01:06:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add another person to Home Assistant (#34157)

Browse Source 
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
This commit is contained in:
c0ffeeca7 2024-08-06 18:22:30 +02:00 committed by GitHub
parent 9b5d7236a2
commit e8ff2ac712
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 34 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
source/_docs/authentication.markdown
View File

@ -51,6 +51,10 @@ _Make sure to choose a secure password!_ At some time in the future, you will pr
As an extra level of security, you can turn on [multi-factor authentication](/docs/authentication/multi-factor-auth/).
## Adding a person to Home Assistant
If you have administrator rights, you can [add a person to Home Assistant](/integrations/person/#adding-a-person-to-home-assistant) and create them a user account.
## Changing display or user name
To learn how to change a display or user name, refer to [setting up basic information](/docs/configuration/basic/).

46
source/_integrations/person.markdown
View File

@ -32,6 +32,36 @@ In short, when you're at home, your position is determined first by stationary t
You can manage persons {% my people title="via the UI from the person page inside the configuration panel" %} or via `YAML` in your {% term "`configuration.yaml`" %} file.
## Adding a person to Home Assistant
If you have administrator rights, you can add other persons to Home Assistant and create them a user account. Depending on the rights you give them, they can then use Home Assistant on their own devices, can have their own dashboards, and be used in automations.
1. Go to {% my people title="**Settings** > **People**" %} and select **Add person**.
2. Enter their **Name**.
3. Add an image if you like.
4. Under **Allow login**, select if they should be able to log in.
- If they cannot log in, they do not get a user account, and they cannot do much with Home Assistant.
- They cannot have their own dashboard, for example.
- But they can still be used for device tracking and show up on a map and be used in automations.
5. If they are able to log in, fill in the user information.
- Check if the user name is correct. A suggestion is made based on the person name. But they do not have to be identical.
- The username is required to log in.
- The person name is the name displayed in the UI.
- Enter a password and store it in a safe location.
- Define if they should have **Local access only**.
- If this is enabled, they won't have access to Home Assistant when they are outside your network, for example from their phone.
- Define if they should have **Administrator** rights.
- Select **Create**.
6. If you have already set up devices for [presence detection](/getting-started/presence-detection/), **select the devices that belong to this person**.
### Customizing the picture for a person
You can easily upload a picture in the frontend. Simply click on a person, select or drop an image in the input field, and then crop it.
<lite-youtube videoid="rOlRnwaaT7Y" videotitle="Changing a profile picture" posterquality="maxresdefault"></lite-youtube>
See the documentation about [hosting files](/integrations/http/#hosting-files) for more information about the `www` folder.
## Configuring the `person` integration via the Home Assistant configuration panel
This integration is by default enabled, unless you've disabled or removed the [`default_config:`](/integrations/default_config/) line from your configuration. If that is the case, the following example shows you how to enable this integration manually:
@ -90,19 +120,3 @@ person:
```
If you change the YAML, you can reload it by calling the `person.reload` service.
### Customizing the picture for a person
You can easily upload a picture in the frontend. Simply click on a person, select or drop an image in the input field, and then crop it.
<lite-youtube videoid="rOlRnwaaT7Y" videotitle="Changing a profile picture" posterquality="maxresdefault"></lite-youtube>
You can also do this using YAML. By following the instructions on the [customizing entities](/docs/configuration/customizing-devices#entity_picture) page, you can customize the picture used for a person entity in the `customize:` section of your configuration. For example:
```yaml
customize:
person.ada:
entity_picture: "/local/ada.jpg"
```
See the documentation about [hosting files](/integrations/http/#hosting-files) for more information about the `www` folder.