Fabian Affolter 481320128f Re-organisation Documentation and Getting started (#2055)
* Split MQTT documentation

* Add more details

* Move content to /docs

* Enable sidebar

* Move content to /docs

* Enable sidebar

* Move content

* Update links

* Remove wizard stuff

* Enable sidebar

* Minor changes

* Move MQTT parts to /docs

* update links

* Update links and sync content

* Fix link

* Enable sidebar

* Remove navigation

* Remove navigation and other minor updates

* Update links

* Add overview page

* Make title linkable

* Update

* Plit content

* Update links

* Rearrange content

* New getting-started section

* Add icons for docs

* Update for new structure

* Update for new structure

* Add docs navigation

* Add docs overview page

* Remove ecosystem navigation

* Add docs and remove other collections

* Move ecosystem to docs

* Remove duplicate files

* Re-add ecosystem overview

* Move to ecosystem

* Fix permission

* Update navigation

* Remove collection

* Move overview to right folder

* Move mqtt to upper level

* Move notebook to ecosystem

* Remove un-used files

* Add one more rectangle for iOS

* Move two parts back from docs and rename Run step

* Remove colon

* update getting-started section

* Add redirect

* Update

* Update navigation
2017-02-23 11:09:41 +01:00

2.4 KiB

layout, title, description, release_date, sidebar, comments, sharing, footer, redirect_from
layout title description release_date sidebar comments sharing footer redirect_from
page iOS Documentation about the Home Assistant iOS app. 2016-10-24 15:00:00 -0700 true false true true /ecosystem/ios/

The Home Assistant for iOS app offers a companion app for iOS which is deeply integrated into both Home Assistant and iOS. Its basic features include:

  • Advanced push notifications
  • Location tracking
  • Basic control of all Home Assistant entities
  • Integration with third party apps

Currently, the app is only available via a closed beta. It will be on the App Store within the next few weeks.

An example of a Home Assistant group as seen in the iOS app.

Basic requirements

  • iOS device running at least iOS 9, but iOS 10 is greatly preferred.
  • Home Assistant 0.31.1 or higher for push notification support.
  • SSL is strongly recommended. Self-signed SSL certificates will not work due to Apple's limitations.

The ios component is the companion component for the Home Assistant iOS app. While not required, adding the ios component to your setup will greatly enhance the iOS app with new notification, location and sensor functions not possible with a standalone app.

Loading the ios component will also load the device_tracker, zeroconf and notify platforms.

{% linkable_title Setup %}

Automated Setup

The ios component will automatically be loaded under the following circumstances:

  1. The discovery component is enabled.
  2. You have just installed the app and are at the getting started screen.

Automated discovery and component loaded can only happen at first install of the app. You may need to wait a few minutes for the iOS component to load as the discovery component only scans the network every 5 minutes.

Manual Setup

You may also manually load the ios component by adding the following to your configuration:

# Example configuration.yaml entry
ios:

Configuration variables:

  • push (Optional): Push notification configuration. See the iOS notify platform for more information.