SMB/CIFS

In meinGPT (UI)

For most teams, setup is done directly in meinGPT without editing local config files.

Open admin settings in meinGPT
Go to Data Pools / Data Sources
Click Add Source and choose this source type
Configure credentials and scope in the UI
Save and trigger the first sync

If you do not run your own DataVault runtime, this is usually all you need.

On-Prem Runtime Configuration (Advanced)

data_pools:
  - id: smb-share
    type: smb
    host: "server.company.com"
    user: $SMB_USERNAME
    password: $SMB_PASSWORD
    base_path: "/shared"

Configuration Options

Field	Type	Default	Required	Description
`id`	string	-	✅	Unique identifier for the data pool
`type`	string	-	✅	Must be "smb"
`host`	string	-	✅	SMB server hostname or IP address
`user`	string	-	✅	Username for authentication
`password`	string	-	✅	Password for authentication
`port`	integer	445	❌	Optional port number
`domain`	string	null	❌	Optional domain name
`spn`	string	null	❌	Optional Service Principal Name
`base_path`	string	"/"	❌	Optional folder path

Synchronization

Vault accesses the SMB share via configured service credentials.
Sync runs mirror files under base_path into local ingest storage.
Later runs process only changed files.

Setup

Ensure SMB access: Verify SMB/CIFS is enabled on target server
Create service account: Create dedicated read-only account for DataVault
Test connectivity: Verify network access and credentials
Add to environment: SMB_USERNAME and SMB_PASSWORD

→ SMB/CIFS Documentation

On-prem only: this source page is relevant when you operate your own DataVault runtime and configure data_pools yourself.