home-assistant.io/source/getting-started/configuration.markdown
JudgeDredd 4e758ea644 fix link to customizing-devices (#2129)
fix link to customizing-devices
2017-02-24 20:49:51 +01:00

28 lines
1.3 KiB
Markdown

---
layout: page
title: "Configure Home Assistant"
description: "Instructions to get Home Assistant configured."
date: 2016-09-26 21:00
sidebar: true
comments: false
sharing: true
footer: true
---
When launched for the first time, Home Assistant will write a default configuration file, called `configuration.yaml`, enabling the web interface and [device discovery](/components/discovery/). It can take up to a minute for your devices to be discovered and appear in the user interface.
The `configuration.yaml` is written in [YAML](/docs/configuration/yaml/), stored in [`.homeassistant`](/docs/configuration/), and can be modified with a text editor.
See the [components overview page](/components/) to find sample entries for your devices and services. For a sensor that is showing [random values](/components/sensor.random/), the entry would looks like the sample below:
```yaml
sensor:
- platform: random
```
The [Setting up devices part](/docs/configuration/devices/) contains of the documentation additional details about adding device and services and [customization](/docs/configuration/customizing-devices/).
For further details about configuration, please take a look at the [configuration documentation](/docs/configuration/).
### [Next step: Automate Home Assistant »](/getting-started/automation/)