mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-10 04:58:59 +00:00
65 lines
2.8 KiB
Markdown
65 lines
2.8 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
|
|
|
|
The app is available on the iOS App Store in every country that Apple supports.
|
|
|
|
<p style="text-align: center;"><a target="_blank" href="https://itunes.apple.com/us/app/home-assistant-open-source-home-automation/id1099568401?mt=8" style="display:inline-block;overflow:hidden;background:url(//linkmaker.itunes.apple.com/assets/shared/badges/en-us/appstore-lrg.svg) no-repeat;width:135px;height:40px;background-size:contain;"></a></p>
|
|
|
|
## Basic requirements
|
|
|
|
* iOS device running at least iOS 9, but iOS 10 is greatly preferred.
|
|
* Home Assistant 0.42.4 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 loading only happens 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.
|
|
|
|
After the first automated setup you need to add `ios:` to your configuration so that the component loads by default even after restarting Home Assistant.
|
|
|
|
### 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*): Actionable push notifications configuration. See the [actionable notifications documentation][actionable-notifications] for more information.
|
|
|
|
[discovery]: /components/discovery
|
|
[device-tracker]: /components/device_tracker
|
|
[zeroconf]: /components/zeroconf
|
|
[notify]: /components/notify
|
|
[actionable-notifications]: /docs/ecosystem/ios/notifications/actions/
|