Home Assistant. Essential plugins to install. Samba, HACS, File Editor, MQTT Mosquitto

install-addon-home-assistant-hacs-samba-mqtt-file-editor
Share on facebook
Share on twitter
Share on linkedin
Share on pinterest
Share on email
Share on whatsapp
Table of Contents

Home Assistant has a plugin system called Add-on which allows you to add very advanced features to your home automation server directly from an Add-on Store. Among all the addons offered, several are essential to take full advantage of HASS. Samba Share to easily install and edit files from a Windows, macOS or Linux PC. File Editor to create, edit, upload YAML files directly from the web interface. HACS, an extension that allows you to install plugins, themes and automations developed by the user community. The MQTT Mosquitto broker to integrate connected objects, essential for example for Tasmota or Espurna.

 

Depending on the platform on which HASS is installed, some add-ons are not available. For example the Visual Studio Code editor is not available on Raspberry Pi while it is on a Synology NAS.

Plugin HACS (Home Assistant Community Store)

Apart from the official extensions accessible directly from the Supervisor’s Add-on Store , there is the Home Assistant Community Store (HACS) extension which makes it possible to very easily install the add-ons developed by the user community. This is probably the extension to install first on your HASS home automation server. HACS is unfortunately not – yet – available as an Add-on from the official store. So you have to install it manually and have a GitHub account (free). Nothing complicated but it’s too long to include it in this tutorial. Go to the article below to install HACS step by step.

Read Also
Home Assistant Community Store (HACS), easily install themes and components

With HACS, you can easily install themes to customize the interface, components (integration) and automation scripts (automation).

Install frontend themes for Home Assistant developed by the community

Add new repositories to the Add-on Store

The number of official plugins is quite limited compared to plugins developed by the user community. If you find that installing HACS is too complicated, you can manually add repositories to the Add-on Store such as add-ons community

Open supervisor

Supervisor Home Assistant

Open the menu (three vertical dots) then Repositories

Add-on store HASS

Paste the url to the desired repository then click on ADD

Add a new repository to the Home Assistant add-on store

If the url is correct, you need to get info about the repository. Click on the trash can to delete the deposit in case of error.

Manage Home Assistant add-on store deposits

Reload the awning using the Reload menu option.

Reload the Home Assistant add-on store

Here you have new extensions for Home Assistant that are easy to install / uninstall

Home Assistant Community repositories

Some useful repositories

  • ESPHome https://github.com/esphome/hassio allows you to make your own connected objects with an ESP32 or ESP8266 in any programming.
  • Add-ons community https://addons.community/

Install the File Editor add-on (old Configurator), the file manager

The Add-On File Editor is an essential plugin which allows you to create folders and files (scripts, configuration, etc.) directly from Home Assistant’s WEB interface. File Editor also allows you to upload files to the Home Assistant server. All this is possible without having to grant SSH access or configure anything on the Docker (NAS, Raspberry Pi or other NUC).

Since version 4.3, the Configurator plugin has changed its name and is now called File Editor.

Open supervisor

Supervisor Home Assistant

Search for the keyword file editor

Find the File Editor add-on for Home assistant

Click on the File Editor plugin icon. Click on Install to start the installation. No special configuration is necessary.

Install the File Editor add-on for Home Assistant

Once the add-on is installed, activate the options and launch the service by clicking on Start.

home assistant file editor start deamon

Once the LED is on, you can access the file editor from the HASS sidebar.

File Editor Home Assistant menuFile Editor allows you to

  • Manage folders and files
    • Navigate to the Home Assistant config folder
    • Create folders
    • Create files
    • Download files
    • Upload files (one at a time)
  • Edit configuration files (YAML or other text files) with the editor
    • Syntax coloring
    • Find / replace strings
  • Create a GIT repository. Supported GIT commands are init, commit, push, stash
  • Access certain server functions (accessible from the toothed wheel)
    • Network status
    • Observe events (Event Observer)
    • Reload the configuration (automation, script, groups, core)
    • Restart the Home Assistant server
  • Run Linux commands

barre options file editor configurator home assistant

File Editor does not allow

  • Upload a file
  • Unzip – easily – a ZIP archive (or other compression format)

Install Samba Share, file sharing with Windows, macOS or Linux

File Editor allows you to perform most file operations directly from the Home Assistant web interface. Edit YAML files, create directory, upload / download files. The main limitation of File Editor remains the lack of an decompression tool. You can run Linux commands, but it’s much less easy than managing files from your PC or MAC.

Samba is a file sharing protocol that has been around since 1993. Samba allows access to Home Assistant files regardless of the system on which it is installed, and from any platform. Windows File Explorer, macOS Finder, or any Linux distribution’s file manager.

Open the Supervisor

Supervisor Home Assistant

Open the Add-on Store tab and search for the keyword samba.

Find the Samba share add-on for Home Assistant

Click on the plugin card and start the installation 

Install the Samba Share add-on for Hassio

Once the installation is complete, open the configuration tab and change the following settings:

  • username user. Without accented characters or spaces
  • password  Samba connection password

Click Save to save the configuration

Configure Samba share

Check Start on Boot and Auto update then start Samba by clicking on Start

5 home assistant start samba add on

Open the log to verify that everything is going well. You can also know the name of the share folder that will appear in File Explorer or Finder.

4b log samba share

Open the config folder with Samba

Once the Samba service is successfully started, a few moments after starting the service, you should see a new folder appear on the network named homeassistant.

Open this folder by indicating your username and possibly the password (recommended)

6 hassio open config folder docker raspberrypi samba

Go to the config folder and create a new directory named themes (without accent). Paste the themes previously retrieved from GitHub in this new folder.

Install the MQTT Mosquitto broker

The Mosquitto broker developed by the community is deprecated. Mosquitto must be installed from the official Add-on Store.

MQTT Mosquitto addon for Home Assistant

Note. If you already have an MQTT broker installed on your Docker, you will need to deactivate it or use other ports (1883 or 8883) offered by default for the Home Assistant addon.

Once the installation is complete, you can protect access to Mosquitto with a user and a password. To do this, go to Configuration -> Users to create a new user.

Click on the plus at the bottom of the screen and enter the name of the new user. No need to give it administrator rights. Finish by clicking on create.

New Home Assistant user creation form

Go back to the MQTT broker configuration tab on the Add-on Store. Here is an example of a configuration where access to Mosquitto is protected by a password. Replace the username and password with the one created previously.

logins:
  - username: USER
    password: USER_PASSWORD
anonymous: false
customize:
  active: false
  folder: mosquitto
certfile: fullchain.pem
keyfile: privkey.pem
require_certificate: false

Check Start on boot and start the service by clicking on Start. If everything is correct the LED should light up

Start the Mosquitto service for Home Assistant

Once started, it remains to configure the MQTT component. Go to Configure -> Integration and click on Configure on the Mosquitto map.

Configure the MQTT Mosquitto component for Home Assistant

Check Enable newly added entities to automatically add new home automation accessories discovered.

Attention, if you develop your own connected objects, you must respect a certain formalism detailed here.

Enable automatic discovery of MQTT accessories and entities for Home Assistant

To disable automatic discovery, open the menu (three vertical dots) then system options

System options Broker MQTT Mosquitto Home Assistant

There you have it, the MQTT broker is ready to go. You can use Node-RED or an application such as MQTT.fx to test. To go further with MQTT

Updates

2021/01/20 First published tutorial

Click to rate this post!
[Total: 1 Average: 5]

Thanks for your reading

Share on facebook
Share on twitter
Share on linkedin
Share on pinterest
Share on email
Share on whatsapp

Did you like this project ? Don't miss any more projects by subscribing to our weekly newsletter!

Are you having a problem with this topic?

Maybe someone has already found the solution, visit the forum before asking your question
We will be happy to hear your thoughts

      Leave a Reply

      Ads
      Read more
      Recent posts on the Forum
      Top offers
      DIY Projects
      DIY Projects