f8cf223a66
* Added overview and integration page. The overview outlines general concepts in Home Assistant such as what an integration is. The Integration page contains steps that was at the end of the onboarding page. More detailed break to add an integration needs to be added. * Added new images for device list and add-ons. * Replaced device list with home assistant device page. * Replaced overview with concepts and terminology. Added screenshots to the page. * Added images to adding Google Cast. * Updated integrations with Google Cast as an example. * Refined some of wording. * Fixed Google Cast punctuation. * Added scripts and scenes. Replaced steps with action which is the same word used in other pages like /integrations/script/ * Removed concepts and terminology page because it has been submitted as a separate PR. Updated navigation to match. * Missed removing concepts and terminology in getting started index. * Post merge changes: * Moved integration details from onboarding to it's own page. * Added integration page in getting started after concepts & terminology. * Added tooltips to integration page. * Change links to devices & services to Microsoft style. * Additional changes from feedback.
2.3 KiB
| title | description |
|---|---|
| Adding Integrations | Instructions to add an integration. |
Let's start by adding your first {% term integration %} so that you can see and change a smart home {% term device %}.
From the sidebar, click on {% my integrations title="Settings > Devices & Services" %}. At this screen you will be able to set up integrations with Home Assistant. You might notice a discovered section. This section contains integrations that were found on your network and can easily be added with a few clicks. If your integrations are not discovered, click the Add integration button in the lower right and search for your integration in that list.
In this example, we'll add a Chromecast to Home Assistant. Chromecast uses the Google Cast integration. Although the below example has already discovered the device, let's add it manually.
First, press the Add integration button in the lower right and search for your integration in that list.
Select Google Cast from the list. Because my Chromecast device was already discovered, it asks if I want to add the discovered one or a different one. I will choose the latter and setup another instance.
It now asks for the network IP address of the device. Describing how to identify a devices IP address is beyond the scope of this article because each network is different. However, the router is usually a good place to look. In this example, it's 192.168.1.99.
If it was successful, it will show a message and allow you to set the {% term area %} it belongs to.
When you're done, navigate back to the web interface and voila, your devices are ready for you to control. You can always go back to add and remove integrations in the future.
If you get stuck, need more information, or want to see what the setup process is like, use the integration documentation.
{% include getting-started/next_step.html step="Automate Home Assistant" link="/getting-started/automation/" %}