The freebox component allows you to observe and control Freebox router.

The integration provides:

  • a sensor with traffic metrics
  • a device tracker for connected devices


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:

  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

You must have set a password for your Freebox router web administration page and enabled the option “Permettre les nouvelles demandes d’associations”.

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

Supported routers

Only the routers with Freebox OS are supported:

  • Freebox V7 also known as Freebox Delta
  • Freebox V6 also known as Freebox Revolution
  • Freebox mini 4k