---
layout: page
title: "Bbox"
description: "Instructions how to integrate Bouygues Bbox routers into Home Assistant."
date: 2016-10-13 23:00
sidebar: true
comments: false
sharing: true
footer: true
logo: bbox.png
ha_category: Presence Detection
ha_release: "0.31"
---


The `bbox` platform offers presence detection by looking at connected devices to a [Bbox](https://fr.wikipedia.org/wiki/Bbox) based router from [Bouygues](https://www.bouyguestelecom.fr/), which is one of the main Internet provider in France.

<p class='note'>
Bbox is a generic name for different hardware routers. The platform has only been tested on a Sagem F@st 5330b because it's the only model the developer owns. 
</p>

To use an Bbox router in your installation, add the following to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
device_tracker:
  - platform: bbox
```

<p class='note warning'>
For now and due to third party limitation, the Bbox must be on the same local network as the Home Assistant installation. And with the default IP configuration (IP of the router must be 192.168.1.254).
</p>

See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.

