Mount remote smb share on hassio

The thing is when you have HA OS and you change the script after update the script is gone.
I have been that road with buildroot-external . The only thing that its possble there is a ticket on github reguarding fuseos but there are no developers on it. We need to wait for looooong time :>

The one thing that they could have done is to remove cleaning script to not delete the fstab. But they cant, i have a discussion on github with them

1 Like

Thx for the info, could you share the issue with us ? I’ll follow it at least to see if something move one day :stuck_out_tongue:

Cheers :stuck_out_tongue:


Thank you very much. The ’ ’ around the shell_command did the trick for me :-). This is missing in a lot of other threads!

1 Like

I would not call it “missing” that quickly. For sure on for example my install it works fine without the ’ '.
So I’m sure, that the threads where it is written that way it is, because it just works that way for many people too…

1 Like

Seems I found a workaround: you can make a symbol link from /mnt/music to /media and use /media for media_dirs.
This way configuration won’t be broken even if /mnt/media folder doesn’t exists at the moment of HA start:

    mount_nas_music_folder: mkdir -p /mnt/music; ln -s /mnt/music /media/;mount ...

I’ve tried dozens of different variations in Terminal but I consistently get a “Permission Denied” error. I’m running HA in a VM on my QNAP NAS. Does anyone have instructions for the code that will mount a NAS directory just manually using Terminal? I should be able to figure to figure out the Automation from there but I would like to successfully mount a directory manually to validate that I have it right

Seems it is not possible in the terminal because it runs in a separate container with restricted permissions.
Moreover, you won’t see the directory mounted in the terminal even when it work: the /mnt folder in terminal and HA are different folders.

Just put the configuration into you configuration.yaml:

    media: /media

    mount_media: 'mkdir -p /mnt/media;ln -s /mnt/media /media/;mount -t cifs -o username=.....'

And then run it from /developer-tools/service as shell_command.mount_media.
It should be visible under /media-browser.

It’s a little bit strange, I still got an error:

Logger: homeassistant.components.shell_command
Source: /usr/src/homeassistant/homeassistant/components/shell_command/
Integration: Shell Command ([documentation](, [issues](
First occurred: 1:44:05 PM (2 occurrences)
Last logged: 1:44:06 PM

Error running command: `mkdir -p /mnt/nas-media;ln -s /mnt/nas-media /media/;mount -t nfs4 nas.lan:/Multimedia/Music /media/nas-media`, return code: 255

NoneType: None

And this is my command:

  mount_nas_music_folder: mkdir -p /mnt/nas-media;ln -s /mnt/nas-media /media/;mount -t nfs4 nas.lan:/Multimedia/Music /media/nas-media

The shell_command didn’t give a clear log of stdout or stderr, which make it pretty hard to debug the command, sad story…

This is what worked for me. I am running an Ubuntu host server with HA as a KVM VM. I already had a Samba share setup for media. I also had nfs-kernel-server already installed on the host server. When trying to mount the cifs share in HA I was getting an error because the password contained a ) symbol in it. I’m now wondering if the posts recommending using ’ ’ around the mount commands would have resolved that issue. But I have not tested that. I switched to trying to mount it as an NFS share.

NOTE IP Addresses and folder paths have been changed where necessary for security reasons.

To get past the permission denied error for NFS mount command in HA, 1st in HA terminal run the mount command using the -vvvv option to see verbose messages. The network IP address of my HA server is However, the verbose message showed that HA VM was communicating with host server using a client IP address of Next on the server that I’m exporting (sharing) the media folder from, run command:

ls -l /path/to/shared/folder

(using your path) to see user and group of folder owner. Then run the command:

id username

where username was determined from previous ls command. The output of the id command will give you the user id and group id corresponding to the output of the ls command. Then edit the /etc/exports file (as root or sudo) on the server containing the shared media folder adding a line like the one below, adjusted for your environment:


/local/folder/media is the folder you are sharing
I added both HA network IP Address and the client IP Address used to communicate with host to be safe.
anonuid = the user ID for the folder owner, and anonguid = the group id for folder.
make sure there is not a space between the IP Address and the (.
Save the file then restart nfs service with command:

sudo systemctl restart nfs-kernel-server

Occasionally the service failed to restart for me. I double check the exports file but didn’t see anything wrong. The NFS service restarted on the 2nd try.

In configuration.yaml I have:

    media: "/media"
  make_music_folder: mkdir -p /media/music
  mount_music_nfs_folder: mount -t nfs4 -o rw /media/music

I used the media folder since it already existed in HA and I wouldn’t have to worry about recreating it after upgrading HA.

After rebooting HA host I was able to go to Developer Tools → Services and run both shell commands. I can now go to the Media tab and browse through all of the folders and files in the mounted share. My next step is to create an automation based on previous posts to run the shell commands upon HA startup.

Can somebody please make some small steps to link a windows folder.
I think that we tried all of the above, but just cant get it mount.
We use VirtualBox with homeassistant VDI.

Windows 10 Host?

Here is how I did it.

This solved the problem for me. I’m running HA Supervised and I have a ‘downloads’ folder in my NAS which is mounted in the homeassistant config dir using a cifs entry in fstab.

//    /usr/share/hassio/homeassistant/nas_downloads        cifs    credentials=/root/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

I got “permission denied” error every time I tried to write to the nas_downloads folder, but this setting fixed it. I wonder if this means anyone can access the folder, even without credentials (guest) or permission to do so.

In the 2022.3 relase it will be possible :clap:

What will be, exactly? I see no mention of mounting external NAS devices.

I was just looking for the same thing. :grinning:

ok i agree . This is only beneficial for those who want to mount a NAS to have only access to the DLNA files…

Hello all,

I’ll start off by saying that I only made it through the first 60 or so messages so far, and already feel like I may be over my head. Maybe there’s a better way to accomplish things now?

I’m running HA on an ODROID-N2 blue, so I’m still a little unclear on what exactly my setup is since I didn’t set it up myself. Here is what is reported under my system info

Version	core-2022.3.7
Installation Type	Home Assistant OS
Development	false
Supervisor	true
Docker	true
User	root
Virtual Environment	false
Python Version	3.9.9
Operating System Family	Linux
Operating System Version	5.10.103
CPU Architecture	aarch64

Here is what I have listed in my configuration.yaml:

    media: /media
    synologynas: /media/syno
  mount_nas_media_folder2: mkdir -p /media/syno;mount -t cifs -o username=guest,password='PASSWORD',domain=WORKGROUP // /media/syno

I have the PASSWORD in ''s as it contains a ) and I ran into an error due to that. I’m not sure if putting the password in ''s is the solution for that? Still trying to learn the ins and outs of yaml: I tried looking up how to escape special characters but couldn’t find a definitive answer.

Here is the behavior I’ve seen:

The configuration checker yells at me if the media/syno directory doesn’t exist, so I have to manually create it. I do that via ssh to homeassistant. (I don’t know if I should be ssh’ing a level higher? I don’t know how I would even do that. ) Then when I restart HA there aren’t any errors in the logs, but when I go to the media/syno directory (either in the media viewer in HA or via ssh in HA) nothing shows up.

When I go to Developer Tools → Services and run the following:

Shell Command: mount_nas_media_folder2  

Nothing seems to happen, there aren’t any errors or anything. But files still don’t show up in the directory.

I’m still relatively new to HA and trying to find my feet, so I’m sure there are a variety of things I could be doing wrong. Any assistance is sorely needed and would be greatly appreciated.

Ok, I set the logger to debug. Nothing regarding the shell_command showed up after restarting HA, but when I went to Developer Tools->Services and ran it manually I get the following in the log:

2022-04-02 14:27:27 DEBUG (MainThread) [homeassistant.components.shell_command] Stderr of command: `mkdir -p /media/syno;mount -t cifs -o username=guest,password='password',domain=WORKGROUP // /media/syno`, return code: 111:
b'mount: mounting // on /media/syno failed: Not supported\n'
2022-04-02 14:27:27 ERROR (MainThread) [homeassistant.components.shell_command] Error running command: `mkdir -p /media/syno;mount -t cifs -o username=guest,password='password',domain=WORKGROUP // /media/syno`, return code: 111
NoneType: None

From searching it seems like return code 111 indicates an issue making a connection. I’ve done as much as I can on the Synology where my drive exists, I enabled the guest account and set the password, gave it read/write access to the directory I’m attempting to mount in HA.

I thought a Samba-Share should be "accessible " for the Samba-User ?, or HA system-user