KB045281 – Managing SMB/CIFS in Houston UI

Last modified: March 16, 2021
You are here:
  • KB Home
  • KB045281 – Managing SMB/CIFS in Houston UI
Estimated reading time: 2 min

Managing SMB/CIFS in Houston UI


This article will cover creating and managing SMB/CIFS shares in the Houston UI


  • 45 Drives Storinator with a configured storage array
  • Houston UI installed and accessible via a web browser [SER.VER.I.P:9090]
  • ZFS Cockpit Dependencies installed
  • A user with Samba permissions


  1. In the Houston UI, navigate to the ZFS tab. To move forward with creating some Samba shares, the pool will need to already be configured. For this example, we have a pool named test. Click the Create Filesystem button.
  2. This will open up a setup wizard. Select the parent filesystem– if you have multiple pools configured then you will have multiple options to choose from, otherwise, this option will default to your main storage pool.Give the filesystem a name and click “Enable Samba Share“.

    The filesystem should be created and listed under your Storage Pools.
  3. We’ll now be adding a user through the Houston UI and give it Samba permissions so it can access the share.Under the “Accounts” tab, select “Create New Account“.

    Give the account a full name if warranted, then a username and a password.
  4. From here, we’ll need to give the account a Samba password. Navigate to the Terminal.Enter the following command with the proper username:
    smbpasswd -a [username]Then fill in the password you’d like to use for Samba access on this account.
  5. We’ll need to ensure the user has ownership or is within the group which owns the share filesystem. We can change this through the terminal as well. Here, we see root is the owner user and owner group.

    Now we’ll be changing that with chown [username]:[group]

    While we’re here, we should also set the permissions to allow for read/write, using chmod 775 [directory]


On a Windows client, go to “This PC” in File Explorer.

Select “Map network drive

In this menu, enter the server IP address in the following format and select “Connect using different credentials“:

Enter the Samba user credentials we created in the previous step

After entering the credentials, the directory should automatically open and be visible as a mapped drive under This PC


  • “Access denied” upon entering credentials
    – Ensure Linux firewall has an exception for Samba
    – Do not set the Samba password to “password”, as it can sometimes cause issue.
    – Check to ensure the user being used to map the share is in the right ownership group or is the owner user of the share directory.


  • Unable to find server when trying to map network drive
    – Make sure the Storinator has a Gateway Server IP, and in some events you may need a DNS Server IP as well.
    – Check VLAN settings if the Storinator is on a separate subnet
    – If making use of bonded interfaces, ensure they’re configured on the switch. These need to configured on both the switch side and the Storinator side.


  • Unable to read and/or write
    – Check the permissions of the share with ls -al in the terminal. It should be set to chmod 775 to avoid any conflict.
Was this article helpful?
Dislike 0
Views: 131
Unboxing Racking Storage Drives Cable Setup Power UPS Sizing Remote Access