The freebox platform offers presence detection by keeping track of the devices connected to a Freebox router.


If you have enabled the discovery component, your Freebox should be detected automatically. Otherwise, you can set it up manually in your configuration.yaml file:

  - platform: freebox
    port: 1234

Configuration Variables


(string)(Required)The url of the Freebox.


(string)(Required)The https port the Freebox is listening on.

You can find out your Freebox host and port by opening this address in your browser. The returned json should contain an api_domain (host) and a https_port (port).

Initial setup

The first time Home Assistant will connect to your Freebox, you will need to authorize it by pressing the right button on the facade of the Freebox when prompted to do so.


Note that the Freebox waits for some time before marking a device as inactive, meaning that there will be a small delay (1 or 2 minutes) between the time you disconnect a device and the time it will appear as “away” in Home Assistant. You should take this into account when specifying the consider_home parameter. On the contrary, the Freebox immediately reports devices newly connected, so they should appear as “home” almost instantly, as soon as Home Assistant refreshes the devices states.

See the device tracker component page for instructions how to configure the devices to be tracked.