home-assistant.io/source/_integrations/alexa.markdown

title, description, logo, ha_category, featured, ha_release

title	description	logo	ha_category	featured	ha_release
Amazon Alexa	Instructions on how to connect Alexa/Amazon Echo to Home Assistant.	amazon-alexa.png	Voice	true	0.10

Automatic setup via Home Assistant Cloud

With Home Assistant Cloud, you can connect your Home Assistant instance in a few simple clicks to Amazon Alexa. With Home Assistant Cloud you don't have to deal with dynamic DNS, SSL certificates or opening ports on your router. Just log in via the user interface and a secure connection with the cloud will be established. Home Assistant Cloud requires a paid subscription after a 30-day free trial.

For Home Assistant Cloud Users, documentation can be found here.

Manual setup

There are a few ways that you can use Amazon Alexa and Home Assistant together.

• Build custom commands to use
• Create a new Flash Briefing source
• Use the Smart Home API to control lights, etc
• Alternative: use the Emulated Hue integration to trick Alexa to thinking Home Assistant is a Philips Hue hub.

Requirements

Manual setup the integration with Amazon Alexa needs several requirements

• Amazon Developer Account. You can sign up here.
• Building custom commands and Flash Briefing requires your Home Assistant instance to be accessible from the Internet with HTTPS on port 443.
• An AWS account is needed if you want to use the Smart Home Skill API. A part of your Smart Home Skill will be hosted on AWS Lambda. However, you don't need to worry about costs, AWS Lambda allows free to use up to 1 million requests and 1GB outbound data transfer per month.
• Smart Home API also needs your Home Assistant instance accessible from the Internet.