mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 15:56:49 +00:00
481320128f
* 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
68 lines
2.4 KiB
Markdown
68 lines
2.4 KiB
Markdown
---
|
|
layout: page
|
|
title: "iOS"
|
|
description: "Documentation about the Home Assistant iOS app."
|
|
release_date: 2016-10-24 15:00:00 -0700
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
redirect_from: /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
|
|
|
|
<p class='note warning'>
|
|
Currently, the app is only available via a closed beta. It will be on the App Store within the next few weeks.
|
|
</p>
|
|
|
|
<p class='img'>
|
|
<img src='/images/ios/control1.png' width='310' height='552' />
|
|
An example of a Home Assistant group as seen in the iOS app.
|
|
</p>
|
|
|
|
## 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`][device-tracker], [`zeroconf`][zeroconf] and [`notify`][notify] platforms.
|
|
|
|
## {% linkable_title Setup %}
|
|
|
|
### Automated Setup
|
|
|
|
The `ios` component will automatically be loaded under the following circumstances:
|
|
|
|
1. The [`discovery`][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:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
ios:
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **push** (*Optional*): Push notification configuration. See the [iOS `notify` platform][ios-notify] for more information.
|
|
|
|
[discovery]: /components/discovery
|
|
[device-tracker]: /components/device_tracker
|
|
[zeroconf]: /components/zeroconf
|
|
[notify]: /components/notify
|
|
[ios-notify]: /ecosystem/ios/notifications/
|