Logo DockerAZ Docs

Samba File Server

Turn your server into a Network Attached Storage (NAS) compatible with Windows, macOS, and Linux.

Overview

DockerAZ includes a built-in Samba (SMB) server manager. This allows you to expose host directories over the network easily, making it perfect for homelabs or managing persistent volumes directly from your desktop file explorer.

Features

folder_shared

Share Management

Create, Update, and Delete newtork shares mapped to any absolute path on the host.

group

User Management

Create simplified Samba-only users. These are separate from your system users for security.

edit_square

Config Editor

Direct access to dockeraz_shares.conf for advanced configurations.

sync_lock

Permissions

Shares map to root by default, ensuring Docker containers can read/write data easily.

Creating a Share

  1. Go to System -> Samba.
  2. Click New Share.
  3. Name: The name visible on the network (e.g., backups).
  4. Path: Absolute path on the server (e.g., /mnt/storage/backups). Note: Directory must exist.
  5. Users: Select users allowed to access this share. Leave empty for Public (Guest) access if enabled.
  6. Click Create. DockerAZ will automatically reload the Samba service.

warning Important Note on Paths

Ensure that the DockerAZ container has volume mount access to the path you are sharing if you are running DockerAZ in a container! Typically, you mount the host root or specific storage paths (e.g., -v /mnt:/mnt) into the DockerAZ container.