From Gentoo Wiki
Jump to:navigation Jump to:search
This page contains changes which are not marked for translation.
This article is a stub. Please help out by expanding it - how to get started.

smbnetfs is a FUSE-based filesystem for SMB/CIFS shares. It enables each user to mount Window's based network shares within their own userspace.



See the Kernel section of the FUSE article for kernel confirmation.

USE flags

Cannot load package information. Is the atom net-fs/smbnetfs correct?


Install the userspace utilities:

root #emerge --ask net-fs/smbnetfs



Import files related to smbnetfs include:

  • ~/.smb/smbnetfs.conf - The local (user-specific) configuration file. This file is not installed in user home directories by default (see below).


Create the ~/.smb directory, then copy the configuration file to the configuration location. Note: depending on which version of the software was installed, the filesystem path could change. Determining the version of the software Portage installed will help determine the name of the first network path in the bunzip2 command:

user $mkdir ~/.smb
user $bunzip2 -c /usr/share/doc/smbnetfs-0.6.0/smbnetfs.conf.bz2 > ~/.smb/smbnetfs.conf

Next, modify the configuration file in order to gain network authentication. There are different methods of inputting authentication credentials: GNOME Keyring (which can be effective if the GNOME desktop environment is being used) or username/password fields in the smbnetfs.conf file itself.

For example, when entering username/password in the configuration file, uncomment the following line and add appropriate values. guest should be substituted with the username and the next set of quotes should include the password:

FILE ~/.smb/smbnetfs.conf
#auth                   "guest" ""
Anyone who has access to read the files in the user's home directory will be able to see the username/password information contained in the ~/.smb/smbnetfs.conf file above. Lock down the /home directory for maximum security.



smbnetfs needs to know where to mount the shares. If a directory for them does not yet exist create one, then mount things there:

user $mkdir ~/mnt
user $smbnetfs ~/mnt



root #emerge --ask --depclean --verbose net-fs/smbnetfs

See also

  • Samba — a re-implementation of the SMB/CIFS networking protocol, a Microsoft Windows alternative to Network File System (NFS).

External resources