Connect to an SMB/CIFS folder

The article explains how to connect to an SMB/CIFS folder.

Step 1. Create and configure a connection

Open the New cloud storage connection dialog.
1. On the Home page, select the workspace to which you want to add a folder.
2. In the workspace resources, select Data and switch to the Cloud storage tab.
3. Click New cloud storage connection at the top right.
1. Open the Attached data tool from the left-hand sidebar.
2. Switch to the Cloud storage tab. You will see the list of all cloud storage connections available from the respective workspace.
3. Click New cloud storage.
In the New cloud storage connection dialog, select SMB/CIFS.
In the New SMB/CIFS cloud storage connection dialog, fill in the following fields:
- Display name: to specify the name for this data source in your system
- Host: to specify the SMB server hostname
- Port: to specify the SMB port
- Username and Password: to specify the user credentials
- Domain: to specify the SMB server domain
- Share: to specify the SMB share you want to connect
- Custom options: to specify additional parameters
(Optional) Click the Test connection button to make sure the provided parameters are correct.
Click the Create and close button to finish the procedure.

Step 2. Attach the connection to a notebook

Open the notebook you want to attach the connection to.
If the notebook is not running, start it by clicking Run | Start machine.
In the sidebar, select Attached data and switch to the Cloud storage tab.
Enable the toggle in your SMB/CIFS connection.

If the notebook is not running, start it by clicking Run | Start machine.
In the sidebar, select Attached data and switch to the Cloud storage tab.
Enable the toggle in your SMB/CIFS connection.

Step 3. Use the connection in the notebook

After the connection is mounted, you can access files in the SMB/CIFS folder from your notebook code:

import pandas as pd

df = pd.read_csv("/data/smb/my_file.csv")
df
      

%use dataframe

val df = DataFrame.readCsv("/data/smb/my_file.csv")
df
      

val lines = scala.io.Source.fromFile("/data/smb/my_file.txt").mkString

df <- read.csv("/data/smb/my_file.csv")

print(df)

The connection’s mount path, such as /data/smb/, is shown on the connection card. To copy the path, click ∙∙∙ | Copy directory path.

Next steps

Learn how to manage and delete cloud storage connections in a workspace and in a notebook.

Keywords

cloud storage, cloud storage connection, attach data, data sources, SMB/CIFS, connect to remote foldersconnect to remote storages

24 November 2025