In order to use the media browser with Home Assistant, it needs to know where to find you local media.
No action is needed from your end to set it up. Home Assistant will automatically use the “media” folder that is provided on these systems.
If you run the Home Assistant Container in, for example, Docker, you’ll need to add a Docker volume mount to the Home Assistant container, to mount in your local media.
The default path Home Assistant will try to use, is
For example, if you are currently using this command for Docker:
docker run -d --name="home-assistant" \ -v /PATH_TO_YOUR_CONFIG:/config \ -v /etc/localtime:/etc/localtime:ro \ --net=host \ ghcr.io/home-assistant/home-assistant:stable
You’ll need to change it to this:
docker run -d --name="home-assistant" \ -v /PATH_TO_YOUR_CONFIG:/config \ -v /PATH_TO_YOUR_MEDIA:/media \ -v /etc/localtime:/etc/localtime:ro \ --net=host \ ghcr.io/home-assistant/home-assistant:stable
If you are using Docker compose, you can add a volume to your composition file in similar fashion as listed in the command above.
If you run Home Assistant Core directly in, for example, a Python virtual environment, you’ll need to create a media folder yourself.
By default, Home Assistant will look for the
media folder inside your current
Home Assistant configuration folder.
For example, if your current configuration folder is stored in:
The you’ll need to create a media folder in that same path:
It is also possible to set up custom and additional media directories. To do so, you’ll need to adjust the core configuration.
This example adds the two media folders to Home Assistant:
# Example configuration.yaml homeassistant: media_dirs: media: /media recording: /mnt/recordings