Setup Basic Information

By default Home Assistant will try to detect your location and will automatically select a temperature unit and time zone based on your location. You can overwrite this by adding the following information to your configuration.yaml:

  # Omitted values in this section will be auto detected using

  # Location required to calculate the time the sun rises and sets
  latitude: 32.87336
  longitude: 117.22743

  # Impacts weather/sunrise data (altitude above sea level in meters) 
  elevation: 430

  # 'metric' for Metric, 'imperial' for Imperial
  unit_system: metric

  # Pick yours from here:
  time_zone: America/Los_Angeles

  # Name of the location where Home Assistant is running
  name: Home

Password protecting the web interface

The first thing you will want to add is a password for the web interface. Use your favourite text editor to open configuration.yaml and edit the http section:

  api_password: YOUR_PASSWORD

If you are planning to expose your Home Assistant instance to the internet and don’t set a password then your installation could be accessed by everybody.

See the HTTP component documentation for more options like HTTPS encryption.

Setting up your phone or tablet

Home Assistant runs as a self-hosted web application and contains support to be added to your home screen. If you’re on Android you can follow the visual guide. For other devices, open Home Assistant on your mobile browser and tap the add to home screen option.

Remote access

To make Home Assistant accessible while away from home, you will have to make it accessible.

The most common approach is to set up port forwarding from your router to port 8123 on the computer that is hosting Home Assistant. Instructions on how to do this can be found by searching <Router model> port forwarding instructions.

The problem with making a port accessible is that some Internet service providers will only offer dynamic IPs. This can cause you to be unable to access Home Assistant while away. You can solve this by using a free Dynamic DNS service like DuckDNS.

Just putting a port up is not secure. You should definitely consider encrypting your traffic if you are accessing your Home Assistant installation remotely. For details please check the Set up encryption using Let’s Encrypt blog post.

If you want the very best security, check out the instructions how to use Tor to access your home.

Next step: Setting up devices »