I maintain this and other Home Assistant add-ons in my free time: keeping up with upstream changes, HA changes, and testing on real hardware takes a lot of time (and some money). I use around 5-10 of my >110 addons so regularly I install test machines (and purchase some test services such as vpn) that I don't use myself to troubleshoot and improve the addons

If this add-on saves you time or makes your setup easier, I would be very grateful for your support!

Addon informations

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

Web-based file management interface that provides a secure way to browse, upload, download, edit and manage files on your Home Assistant system. Filebrowser offers a clean, modern interface for handling your files through a web browser, with support for multiple file formats, preview capabilities, and comprehensive file operations.

This addon is based on the docker image from the official Filebrowser project.

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other Home Assistant add-on.

Add my Home Assistant add-ons repository to your Home Assistant instance.
Install this add-on.
Click the Save button to store your configuration.
Start the add-on.
Check the logs of the add-on to see if everything went well.
Access the web UI through the sidebar or at <your-ip>:8071.

Configuration

The web UI can be found at <your-ip>:8071 or through the Home Assistant sidebar when using Ingress.

Default credentials:

Username: admin
Password: admin

Important: Change the default credentials immediately after first login for security.

Options

Option	Type	Default	Description
`ssl`	bool	`false`	Enable HTTPS for web interface
`certfile`	str	`fullchain.pem`	SSL certificate file (in `/ssl/`)
`keyfile`	str	`privkey.pem`	SSL private key file (in `/ssl/`)
`NoAuth`	bool	`true`	Disable authentication (resets database when changed)
`disable_thumbnails`	bool	`true`	Disable thumbnail generation for improved performance
`base_folder`	str	(optional)	Root folder for file browser (defaults to all mapped folders)
`localdisks`	str	(optional)	Local drives to mount (e.g., `sda1,sdb1,MYNAS`)
`networkdisks`	str	(optional)	SMB shares to mount (e.g., `//SERVER/SHARE`)
`cifsusername`	str	(optional)	SMB username for network shares
`cifspassword`	str	(optional)	SMB password for network shares
`cifsdomain`	str	(optional)	SMB domain for network shares

Example Configuration

ssl: true
certfile: "fullchain.pem"
keyfile: "privkey.pem"
NoAuth: false
disable_thumbnails: false
base_folder: "/share"
localdisks: "sda1,sdb1"
networkdisks: "//192.168.1.100/files,//nas.local/documents"
cifsusername: "fileuser"
cifspassword: "password123"
cifsdomain: "workgroup"

Setup

Start the add-on and wait for it to initialize.
Access the web interface through the Home Assistant sidebar or at <your-ip>:8071.
Log in using the default credentials:
- Username: admin
- Password: admin
Important: Immediately change the default password by clicking on "Settings" > "User Management".
Configure your preferred settings through the web interface.
If authentication is disabled (NoAuth: true), the login screen will be bypassed.

Mounting Drives

This addon supports mounting both local drives and remote SMB shares:

Local drives: See Mounting Local Drives in Addons
Remote shares: See Mounting Remote Shares in Addons

Custom Scripts and Environment Variables

This addon supports custom scripts and environment variables through the addon_config mapping:

Custom scripts: See Running Custom Scripts in Addons
env_vars option: Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Support

Create an issue on GitHub, or ask on the Home Assistant Community thread.