Onboarding: refer to troubleshooting section (#33961)

* Onboarding: refer to troubleshooting

- remove substeps and refer to troubleshooting section instead
- implement some of the feedback from #32080
- add info that internet connection is required because HA Core needs to be downloaded

* Apply suggestions from code review

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Stefan Agner <stefan@agner.ch>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Stefan Agner <stefan@agner.ch>
This commit is contained in:
c0ffeeca7 2024-07-25 15:33:52 +02:00 committed by GitHub
parent 669c175dea
commit 20696d6219
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -3,57 +3,52 @@ title: "Onboarding Home Assistant"
description: "Instructions to get Home Assistant configured."
---
Alright, you made it here. The tough part is done.
After Home Assistant has been [installed](/installation/) on your device, there are 5 steps to complete setting up Home Assistant.
- As the last step of the [installation procedure](/installation/) specific to your device, you entered the Home Assistant device's address in your browser's address bar.
- Typically, this is `http://homeassistant.local:8123/`.
- If you are running an older Windows version or have a stricter network configuration, you might need to access Home Assistant at <a href="http://homeassistant:8123" target="_blank">homeassistant:8123</a> or `http://X.X.X.X:8123` (replace X.X.X.X with your device's IP address).
- **Result**: You now see the welcome screen. Depending on your hardware, preparation may take a while.
1. Enter the following URL into the browser's address bar: [http://homeassistant.local:8123/](http://homeassistant.local:8123/).
- **Result**: You now see the **Preparing Home Assistant** page. Depending on your hardware and internet connection, preparation may take a while.
- Home Assistant downloads the latest version of {% term "Home Assistant Core" %} (about 700&nbsp;MB).
- If you ran into issues with this step, refer to the [installation troubleshooting](/installation/troubleshooting/).
- Once preparation is finished, the welcome screen is shown.
![Home Assistant preparation](/images/getting-started/onboarding_preparing_01_.png)
- Depending on the preinstalled software version, you might see a slightly different version of the welcome screen.
- To view the log files, select the pulsing blue dot.
![Home Assistant preparation](/images/getting-started/onboarding_preparing_01.png)
With Home Assistant installed, it's time to set up the basics.
We will now create the owner's account of Home Assistant. This account is an administrator account. It will always be able to change everything.
1. If you want to restore from a backup of a previous installation, select **Restore from backup**.
- Continue with the procedure on [restoring from backup](/common-tasks/os/#restoring-a-backup).
- Ignore the rest of this procedure. The following steps describe how to create a new installation, not how to restore from backup.
2. If this is your initial installation, select **Create my smart home**.
3. Enter a name, username, and password.
- Make sure the username is lowercase and doesn't contain white space.
- Store the name, username, and password in a password manager. There is no way to recover the owner credentials.
- Select **Create account**.
2. You can either create a new installation or recover an existing installation from a backup:
- **Option 1: new installation**: If this is your initial installation, we will now create the owner's account of Home Assistant.
- {% icon "mdi:information-outline" %} This account is an administrator account. It will always be able to change everything.
- Select **Create my smart home**.
- Enter a name, username, and password.
- Make sure the username is lowercase and contains no whitespace.
- Store the name, username, and password somewhere safe. There is no way to recover the owner credentials.
- Select **Create account**.
![Set your username and password.](/images/getting-started/username.png)
4. Enter the location of your home.
- The location is used to populate settings such as time zone, unit system, and currency.
- It is also used for location-based information and automations: for example showing the weather-forecast, opening the shades at sunrise, or starting the vacuum when you leave the home.
- If you'd rather not send your location, you can choose a location far away from where you live.
- **Option 2: restore from backup**: If you want to restore a backup of a previous installation, select **Restore from backup**.
- Ignore the rest of this procedure and continue with the procedure on [restoring from backup](/common-tasks/os/#restoring-a-backup).
3. Enter the location of your home.
- The location is used to configure the time zone, unit system, and currency.
- It is also used for automations such as showing the weather, opening the shades at sunrise, or starting the vacuum when you leave the home.
- You can always change this information later in the settings.
- After finding your location, select **Next**.
![Define your location.](/images/getting-started/onboarding_location.png)
5. Select which information you are willing to share.
4. Select which information you are willing to share.
- Sharing is disabled by default. However, we would like to encourage you to share some of this data.
- This information helps us to find out which platforms we need to support and where to focus our efforts.
- This information helps us find out which platforms we need to support and where to focus our efforts.
- The data is anonymized and aggregated. To see the charts we generate out of this data, take a look at our [analytics page](https://analytics.home-assistant.io/).
- To confirm, select **Next**.
![Share anonymized data](/images/getting-started/onboarding_share_anonymized_info.png)
6. Once you are done, select **Next**.
- Home Assistant will then show any {% term devices %} it has discovered on your network.
5. Check out the {% term devices %} Home Assistant has discovered on your network.
- Don't be alarmed if you see fewer items than shown below; you can always manually add devices later.
- Select **Finish**.
![Discovery of devices on your network.](/images/getting-started/onboarding_devices.png)
7. Finally, select **Finish**.
- Now you're brought to the Home Assistant web interface. If some of your devices were discovered and set up automatically, this default dashboard may already show some of your devices.
6. {% icon "mdi:party-popper" %} Youve now got Home Assistant up and running.
- You now see the default [dashboard](/dashboards/).
- If some of your devices were discovered and set up automatically, this shows those devices.
{% include getting-started/next_step.html step="Concepts & Terminology" link="/getting-started/concepts-terminology/" %}