shvargon/wsdd repository overview

⁠wsdd-docker

Docker image for running wsdd.py, a Web Service Discovery daemon for Samba/SMB hosts.

🔗 Upstream repository: christgau/wsdd⁠
🔗 Docker repository (this project): shvargon/wsdd-docker⁠

⁠📦 Tags

• latest⁠
• v0.8⁠

⁠⚙️ What is wsdd?

wsdd is a Web Service Discovery daemon that allows Samba/SMB hosts (e.g., NAS devices or Linux servers) to be discoverable by Windows clients on the network.
It also provides a discovery mode (client mode) to search for other WSD-enabled devices (e.g., Windows machines).

⁠🚀 Usage

Start a basic wsdd container:

docker run --net=host -e HOST=somehost -d shvargon/wsdd

Pass additional flags to wsdd.py by appending them at the end of the command line:

docker run --net=host -e HOST=somehost -d shvargon/wsdd -v --ipv4only

⁠🌐 Environment Variables

⁠📡 Exposed Ports

⁠🔒 Security tips

• The container runs as a non-root user (uid=1000;gid=1000).
• Only /app/wsdd.py and /entrypoint.sh are executable (chmod 555).
• ENTRYPOINT enforces the use of environment variables for configuration.

⁠📝 Samba + Avahi integration

When using wsdd alongside Samba, it's recommended to register the SMB service via Avahi for proper mDNS visibility (e.g., for macOS Finder):

Create the following file on your host:

/etc/avahi/services/smb.service

With the following content:

<?xml version="1.0" standalone='no'?>
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
<service-group>
 <name replace-wildcards="yes">%h</name>
 <service>
   <type>_smb._tcp</type>
   <port>445</port>
 </service>
 <service>
   <type>_device-info._tcp</type>
   <port>0</port>
   <txt-record>model=RackMac</txt-record>
 </service>
</service-group>

This will announce your Samba server over mDNS, making it easier to detect on macOS and Linux clients.

⁠📝 License

See the LICENSE⁠ file in the upstream project.