movalex/01.Compile-Samba-Macos12.md

Forked from thomaswilley/gist:ffcdb83c21c782cbab8a18d6134f87d7

Last active March 16, 2026 12:07

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Select an option

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/movalex/9ee4207c52a291d2eec70d3517c879f3.js"></script>
Save movalex/9ee4207c52a291d2eec70d3517c879f3 to your computer and use it in GitHub Desktop.

Download ZIP

Compile Samba on Macos

Raw

01.Compile-Samba-Macos12.md

Compile Samba 4.23 on macOS (12+)

Tested on macOS Monterey (12), should work on newer versions. For Apple Silicon, adjust Homebrew paths from /usr/local to /opt/homebrew.

Prerequisites

brew install cmake gnutls jansson libarchive openssl pkg-config python@3.11
brew install readline && brew link --force readline
brew install bison icu4c libxcrypt

cpan install Parse::Yapp::Driver
cpan install JSON

Environment Setup

Unlink older ICU versions if present:

brew unlink icu4c@74 2>/dev/null
brew unlink icu4c@76 2>/dev/null
brew link icu4c --force 2>/dev/null || true

Set paths (add to ~/.zshrc for persistence):

export PATH="/usr/local/opt/bison/bin:$PATH"
export PKG_CONFIG_PATH="/usr/local/opt/libarchive/lib/pkgconfig:/usr/local/opt/readline/lib/pkgconfig:/usr/local/opt/icu4c/lib/pkgconfig:/usr/local/opt/libxcrypt/lib/pkgconfig"
export CPPFLAGS="-I/usr/local/opt/libarchive/include -I/usr/local/opt/readline/include -I/usr/local/opt/openssl@3/include -I/usr/local/opt/icu4c/include -I/usr/local/opt/libxcrypt/include"
export LDFLAGS="-L/usr/local/opt/libarchive/lib -L/usr/local/opt/readline/lib -L/usr/local/opt/openssl@3/lib -L/usr/local/opt/icu4c/lib -L/usr/local/opt/libxcrypt/lib"

Clone and Build

git clone https://git.samba.org/samba.git
cd samba
git checkout samba-4.23.5

Minimal build for file server:

./configure --prefix=/opt/samba \
  --without-ad-dc \
  --without-acl-support \
  --without-gettext \
  --without-pam \
  --without-ldap \
  --without-ads \
  --without-winbind \
  --without-json \
  --without-gpgme \
  --without-quotas \
  --without-utmp \
  --without-syslog \
  --without-automount \
  --without-dmapi \
  --without-fam \
  --without-profiling-data \
  --without-libunwind \
  --without-systemd \
  --without-lttng \
  --without-regedit \
  --without-winexe \
  --without-cluster-support \
  --without-prometheus-exporter \
  --disable-spotlight \
  --disable-cups \
  --disable-iprint \
  --disable-python \
  --disable-glusterfs \
  --disable-cephfs

make -j$(sysctl -n hw.ncpu)
sudo make install

Verify Installation

/opt/samba/sbin/smbd --version
otool -L /opt/samba/sbin/smbd | head -5  # Should show /opt/samba/lib paths

Configuration

Create log directory:

sudo mkdir -p /var/log/samba

Create /opt/samba/etc/smb.conf:

[global]
    workgroup = WORKGROUP
    netbios name = server
    load printers = no
    printing = bsd
    printcap name = /dev/null
    log file = /var/log/samba/samba.log
    log level = 1
    max log size = 10000
    passdb backend = tdbsam:/etc/passdb.tdb

    # SMB protocol settings
    server min protocol = SMB2
    server max protocol = SMB3

[MyShare]
    path = /Volumes/MyDrive/
    browsable = yes
    writable = yes
    guest ok = no
    force user = yourusername
    force group = staff
    vfs mkdir use tmp name = no
    veto files = /Thumbs.db/.DS_Store/._*/.Spotlight-V100/.Trashes/
    delete veto files = yes

Important for APFS volumes: The vfs mkdir use tmp name = no setting is required. Without it, directory creation fails with NT_STATUS_ACCESS_DENIED due to how APFS handles renameat() with special characters in temp filenames.

Add Samba User

sudo /opt/samba/bin/smbpasswd -a yourusername

LaunchDaemons Setup

Create three plist files for automatic startup:

1. /Library/LaunchDaemons/com.samba.smbd.plist — File server:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.samba.smbd</string>
    <key>ProgramArguments</key>
    <array>
        <string>/opt/samba/sbin/smbd</string>
        <string>--foreground</string>
        <string>--no-process-group</string>
        <string>-s</string>
        <string>/opt/samba/etc/smb.conf</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <dict>
        <key>SuccessfulExit</key>
        <false/>
        <key>Crashed</key>
        <true/>
    </dict>
</dict>
</plist>

2. /Library/LaunchDaemons/com.samba.nmbd.plist — Windows/NetBIOS discovery:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.samba.nmbd</string>
    <key>ProgramArguments</key>
    <array>
        <string>/opt/samba/sbin/nmbd</string>
        <string>--foreground</string>
        <string>--no-process-group</string>
        <string>-s</string>
        <string>/opt/samba/etc/smb.conf</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

3. /Library/LaunchDaemons/com.samba.bonjour.plist — Mac/Bonjour discovery:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.samba.bonjour</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/dns-sd</string>
        <string>-R</string>
        <string>server</string>
        <string>_smb._tcp</string>
        <string>local</string>
        <string>445</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

Load all services:

sudo launchctl load /Library/LaunchDaemons/com.samba.smbd.plist
sudo launchctl load /Library/LaunchDaemons/com.samba.nmbd.plist
sudo launchctl load /Library/LaunchDaemons/com.samba.bonjour.plist

Service Management

Stop services:

sudo launchctl unload /Library/LaunchDaemons/com.samba.smbd.plist
sudo launchctl unload /Library/LaunchDaemons/com.samba.nmbd.plist
sudo launchctl unload /Library/LaunchDaemons/com.samba.bonjour.plist

Reload config without restart:

sudo /opt/samba/bin/smbcontrol all reload-config

Discovery Notes

nmbd — NetBIOS discovery for Windows clients (UDP ports 137-138)
dns-sd — Bonjour/mDNS discovery for Mac clients (uses macOS built-in mDNSResponder)

Avahi is not used on macOS because it conflicts with the built-in mDNSResponder on port 5353.

Windows Client Notes

If Windows doesn't see the server in Network:

Set network to Private (not Public)
Enable "SMB 1.0/CIFS Client" in Windows Features (for NetBIOS discovery)
Or connect directly: \\server\ShareName or \\192.168.x.x\ShareName

Disable Thumbs.db creation on Windows (recommended):

reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v DisableThumbnailCache /t REG_DWORD /d 1 /f

Troubleshooting

Check services are running:

ps aux | grep -E "smbd|nmbd|dns-sd"

Test from Mac terminal:

smbutil view //username@server

Test from Windows:

net view \\server

View logs:

tail -f /var/log/samba/samba.log

References

https://wiki.samba.org/index.php/Build_Samba_from_Source
https://bugzilla.samba.org/show_bug.cgi?id=15864 (vfs mkdir tmp name issue)

Raw

02.Compile-Samba-Macos10-Legacy.md

Compile Samba 4.13.17 on macOS 10.13 (High Sierra)

This is for legacy/unsupported macOS versions where newer Samba won't build.

Prerequisites

brew install jansson libarchive
brew install readline && brew link --force readline
cpan install Parse::Yapp::Driver

Environment Setup

export LDFLAGS="-L/usr/local/opt/libarchive/lib"
export CPPFLAGS="-I/usr/local/opt/libarchive/include"

Clone and Build

git clone https://git.samba.org/samba.git
cd samba
git checkout samba-4.13.17
./configure --prefix=/opt/samba --without-ad-dc --without-acl-support --without-gettext

Required Patches

Patch these files before running make:

source4/torture/libsmbclient/libsmbclient.c
source3/lib/system_smbd.c
source3/libsmb/libsmb_stat.c
libcli/smbreadline/smbreadline.c

diff --git a/libcli/smbreadline/smbreadline.c b/libcli/smbreadline/smbreadline.c
index 6929209be20..90a2dea12c5 100644
--- a/libcli/smbreadline/smbreadline.c
+++ b/libcli/smbreadline/smbreadline.c
@@ -53,6 +53,7 @@ static bool smb_rl_done;
  * readline.so has it
  */
 extern int rl_done;
+extern Function *rl_event_hook;
 #endif

 void smb_readline_done(void)
@@ -147,7 +148,11 @@ char *smb_readline(const char *prompt, void (*callback)(void),

 #ifdef HAVE_DECL_RL_EVENT_HOOK
        if (callback)
-               rl_event_hook = (rl_hook_func_t *)callback;
+#if defined(_RL_FUNCTION_TYPEDEF)
+        rl_event_hook = (rl_hook_func_t *)callback;
+#else
+    rl_event_hook = (Function *)callback;
+#endif
 #endif
        ret = readline(prompt);
        if (ret && *ret)
diff --git a/source3/lib/system_smbd.c b/source3/lib/system_smbd.c
index 3b1ac9c1c2a..896105a1ae5 100644
--- a/source3/lib/system_smbd.c
+++ b/source3/lib/system_smbd.c
@@ -205,7 +205,11 @@ bool getgroups_unix_user(TALLOC_CTX *mem_ctx, const char *user,
                         gid_t primary_gid,
                         gid_t **ret_groups, uint32_t *p_ngroups)
 {
+#if defined(DARWINOS)
+    int max_grp = 128;
+#else
        int max_grp = MIN(128, groups_max());
+#endif
        gid_t stack_groups[max_grp];
        uint32_t ngrp;
        gid_t *temp_groups = stack_groups;
diff --git a/source3/libsmb/libsmb_stat.c b/source3/libsmb/libsmb_stat.c
index 790934bd565..fed2c8c63c3 100644
--- a/source3/libsmb/libsmb_stat.c
+++ b/source3/libsmb/libsmb_stat.c
@@ -102,6 +102,11 @@ void setup_stat(struct stat *st,
        }

        st->st_dev = dev;
+    #if defined(__APPLE__) || defined(__NetBSD__)
+        #define st_atim st_atimespec
+        #define st_ctim st_ctimespec
+        #define st_mtim st_mtimespec
+    #endif
        st->st_atim = access_time_ts;
        st->st_ctim = change_time_ts;
        st->st_mtim = write_time_ts;
diff --git a/source4/torture/libsmbclient/libsmbclient.c b/source4/torture/libsmbclient/libsmbclient.c
index 3f3992593f9..6275bad1159 100644
--- a/source4/torture/libsmbclient/libsmbclient.c
+++ b/source4/torture/libsmbclient/libsmbclient.c
@@ -1231,6 +1231,11 @@ static bool torture_libsmbclient_utimes(struct torture_context *tctx)
        ret = smbc_fstat(fhandle, &st);
        torture_assert_int_not_equal(tctx, ret, -1, "smbc_fstat failed");

+    #if defined(__APPLE__) || defined(__NetBSD__)
+        #define st_atim st_atimespec
+        #define st_mtim st_mtimespec
+    #endif
+
        tbuf[0] = convert_timespec_to_timeval(st.st_atim);
        tbuf[1] = convert_timespec_to_timeval(st.st_mtim);

Build and Install

make -j$(sysctl -n hw.ncpu)
sudo make install

References

https://wiki.samba.org/index.php/Build_Samba_from_Source

Raw

03.Samba-PostInstall-Setup.md

Create samba launchers plists

/Library/LaunchDaemons/com.samba.smbd.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.samba.smbd</string>
    <key>ProgramArguments</key>
    <array>
        <string>/opt/samba/sbin/smbd</string>
        <string>--foreground</string>
        <string>--no-process-group</string>
        <string>-s</string>
        <string>/opt/samba/etc/smb.conf</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <dict>
        <key>SuccessfulExit</key>
        <false/>
        <key>Crashed</key>
        <true/>
    </dict>
</dict>
</plist>

/Library/LaunchDaemons/com.samba.nmbd.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.samba.nmbd</string>
    <key>ProgramArguments</key>
    <array>
        <string>/opt/samba/sbin/nmbd</string>
        <string>-F</string>
        <string>--no-process-group</string>
    </array>
    <key>KeepAlive</key>
        <false/>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

Create log folder:

sudo mkdir /var/log/samba/

Optionally disable native NETBIOS service:

sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.netbiosd.plist

see additional info here

Create basic samba config file:

# /opt/samba/etc/smb.conf
[global]
    workgroup = WORKGROUP
    netbios name = server
    debug hires timestamp = No
    debug timestamp = yes
    idmap cache time = 604800
    ldap ssl = start tls
    log file = /var/log/samba/%m.log
    log level = 1
    max log size = 10000
    passdb backend = tdbsam://etc/passdb.tdb
[SHARE_NAME]
    path = /Volumes/DISK_NAME
    public = yes
    browsable = yes
    writable = yes
    directory mask = 0755
    create mask = 0644
    guest ok = no

Add samba directory to the PATH variable:

export PATH=/opt/samba/bin:/opt/samba/sbin:$PATH

Setup username and password for samba share:

sudo smbpasswd -a <username>

Load the services:

sudo launchctl bootstrap system/ /Library/LaunchDaemons/com.samba.smbd.plist
sudo launchctl bootstrap system/ /Library/LaunchDaemons/com.samba.nmbd.plist
sudo launchctl list | grep samba
launchctl print system/com.samba.smbd | grep "state"

movalex/01.Compile-Samba-Macos12.md

Select an option

No results found

Select an option

No results found

Compile Samba 4.23 on macOS (12+)

Prerequisites

Environment Setup

Clone and Build

Verify Installation

Configuration

Add Samba User

LaunchDaemons Setup

Service Management

Discovery Notes

Windows Client Notes

Troubleshooting

References

Compile Samba 4.13.17 on macOS 10.13 (High Sierra)

Prerequisites

Environment Setup

Clone and Build

Required Patches

Build and Install

References

Create samba launchers plists

Create log folder:

Optionally disable native NETBIOS service:

Create basic samba config file:

Add samba directory to the PATH variable:

Setup username and password for samba share:

Load the services: