The plex platform allows you to connect a Plex Media Server to Home Assistant. It will allow you to control media playback and see the current playing item. The preferred way to setup the Plex platform is by enabling the the discovery component and requires GDM to be enabled.

If local authentication is enabled or multiple users are defined, Home Assistant requires an authentication token to be entered in the frontend. Press “CONFIGURE” to do it.

If you don’t know your token, see Finding your account token / X-Plex-Token.

If you want to enable the plex platform directly, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
  - platform: plex

In case discovery does not work (GDM disabled or non-local plex server), you can create ~/.homeassistant/plex.conf manually.

{"IP_ADDRESS:PORT": {"token": "TOKEN"}}
  • IP_ADDRESS (Required): IP address of the Plex Media Server
  • PORT (Required): Port where Plex is listening. Default is 32400
  • TOKEN (Optional): Only if authentication is required. Set to null (without quotes) otherwise.

At this moment, the Plex platform only supports one Plex Media Server.

It is possible to get errors that look like the following.

ERROR:plexapi: ('Connection aborted.', BadStatusLine("''",))
INFO:homeassistant.components.media_player.plex:No server found at:

If this occurs, try changing the setting Secure connections in your Plex Media Server to Preferred (instead of Required). The Plex component does not currently support HTTPS.