Samba - Revision history

Slickdomi: Renamed "services.samba.securityType" to "services.samba.settings.global.security" in the User Authentication section

2026-02-17T20:12:14Z

Renamed "services.samba.securityType" to "services.samba.settings.global.security" in the User Authentication section

← Older revision		Revision as of 20:12, 17 February 2026
Line 124:		Line 124:
	services.samba = {		services.samba = {
	enable = true;		enable = true;
	~~securityType = "user";~~
	openFirewall = true;		openFirewall = true;
	settings.my_share_directory = {		settings = {
	# ...		global = {
	"valid users" = "my_user";		# ...
			"security" = "user";
			};
			my_share_directory = {
			# ...
			"valid users" = "my_user";
			};
	};		};
	};		};

34j: Fix broken code

2026-02-12T13:29:44Z

Fix broken code

← Older revision		Revision as of 13:29, 12 February 2026
Line 14:		Line 14:
	enable = true;		enable = true;
	openFirewall = true;		openFirewall = true;
	};
	};		};

Line 32:		Line 31:

	Then, logout and login (to make sure your group change has been taken into account), open Dolphin, right click on a folder you'd like to share, go to Properties, Tab "Share", and configure it the way you want.		Then, logout and login (to make sure your group change has been taken into account), open Dolphin, right click on a folder you'd like to share, go to Properties, Tab "Share", and configure it the way you want.


	== Server setup ==		== Server setup ==

JLC: /* CIFS mount configuration */ - Added "nofail" to template config with explanation as to why

2025-12-21T17:08:40Z

CIFS mount configuration: - Added "nofail" to template config with explanation as to why

← Older revision		Revision as of 17:08, 21 December 2025
Line 349:		Line 349:
	=== CIFS mount configuration ===		=== CIFS mount configuration ===

	The following snippets shows how to mount a CIFS (Windows) share in NixOS.		The following snippets shows how to mount a CIFS (Windows) share in NixOS.

			Note the inclusion of the <code>"nofail"</code> option; NixOS will treat CIFS shares like any other mounted drive, and this will allow the system to boot correctly if the mounted NAS is off or if the network is slow to initialize.

	Replace all <code><FIELDS></code> with concrete values:		Replace all <code><FIELDS></code> with concrete values:

Line 363:		Line 366:
	automount_opts = "x-systemd.automount,noauto,x-systemd.idle-timeout=60,x-systemd.device-timeout=5s,x-systemd.mount-timeout=5s";		automount_opts = "x-systemd.automount,noauto,x-systemd.idle-timeout=60,x-systemd.device-timeout=5s,x-systemd.mount-timeout=5s";

	in ["${automount_opts},credentials=/etc/nixos/smb-secrets"];		in ["${automount_opts},credentials=/etc/nixos/smb-secrets" "nofail"];
	};		};
	}		}

TobiasBora at 17:14, 16 September 2025

2025-09-16T17:14:49Z

← Older revision		Revision as of 17:14, 16 September 2025
Line 8:		Line 8:
	{ pkgs, config, ... }: {		{ pkgs, config, ... }: {
	services.samba = {		services.samba = {
			# The full package is needed to register mDNS records (for discoverability), see discussion in
			# https://gist.github.com/vy-let/a030c1079f09ecae4135aebf1e121ea6
			package = pkgs.samba4Full;
	usershares.enable = true;		usershares.enable = true;
	enable = true;		enable = true;

TobiasBora: Add usershare explaination

2025-09-12T14:55:39Z

Add usershare explaination

← Older revision		Revision as of 14:55, 12 September 2025
Line 1:		Line 1:
	This guide will help you on how to use samba on nixos.		This guide will help you on how to use samba on nixos.

			== Usershares ==

			You can allow some users to share via samba a given directory simply via a right click in their file browser (tested with Dolphin). For that, first add this configuration (make sure to add your user in the samba group):

			{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>
			{ pkgs, config, ... }: {
			services.samba = {
			usershares.enable = true;
			enable = true;
			openFirewall = true;
			};
			};

			# To be discoverable with windows
			services.samba-wsdd = {
			enable = true;
			openFirewall = true;
			};

			# Make sure your user is in the samba group
			users.users.YOURUSER = {
			isNormalUser = true;
			extraGroups = [ "samba" ];
			};
			}
			</nowiki>}}

			Then, logout and login (to make sure your group change has been taken into account), open Dolphin, right click on a folder you'd like to share, go to Properties, Tab "Share", and configure it the way you want.


	== Server setup ==		== Server setup ==

Yakidofu: /* See also */ Add smb.conf man page

2025-09-05T18:30:32Z

Jaythomas: /* User Authentication */ add robust automated authentication example that provides full context and aims to give a basic, typical password-protected folder share

2025-07-31T21:54:56Z

User Authentication: add robust automated authentication example that provides full context and aims to give a basic, typical password-protected folder share

@@ Line 69: / Line 69: @@
 === User Authentication ===
-For a user called <code>my_user</code>to be authenticated on the samba server, you must add their password using
+For a user called <code>my_user</code>to be authenticated on the samba server, you can add a password using:
 <syntaxhighlight lang="bash">
 sudo smbpasswd -a my_user
 </syntaxhighlight>
 === Configuration ===

Zeal: sudo is needed for this

2025-02-25T11:54:32Z

sudo is needed for this

← Older revision		Revision as of 11:54, 25 February 2025
Line 72:		Line 72:

	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	smbpasswd -a my_user		sudo smbpasswd -a my_user
	</syntaxhighlight>		</syntaxhighlight>

Xanderio: add note to change avahi service file if modifying share name

2025-02-21T10:01:30Z

add note to change avahi service file if modifying share name

← Older revision		Revision as of 10:01, 21 February 2025
Line 118:		Line 118:
	<service>		<service>
	<type>_adisk._tcp</type>		<type>_adisk._tcp</type>
			<!--
			change tm_share to share name, if you changed it.
			-->
	<txt-record>dk0=adVN=tm_share,adVF=0x82</txt-record>		<txt-record>dk0=adVN=tm_share,adVF=0x82</txt-record>
	<txt-record>sys=waMa=0,adVF=0x100</txt-record>		<txt-record>sys=waMa=0,adVF=0x100</txt-record>

Xanderio: securityType was moved to `settings.global`

2025-02-21T09:53:15Z

securityType was moved to `settings.global`

← Older revision		Revision as of 09:53, 21 February 2025
Line 8:		Line 8:
	services.samba = {		services.samba = {
	enable = true;		enable = true;
	~~securityType = "user";~~
	openFirewall = true;		openFirewall = true;
	settings = {		settings = {

← Older revision		Revision as of 18:30, 5 September 2025
Line 496:		Line 496:
	* [https://search.nixos.org/options?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=services.samba Samba Options in NixOS on unstable]		* [https://search.nixos.org/options?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=services.samba Samba Options in NixOS on unstable]
	* [https://wiki.archlinux.org/title/Samba Samba in the Arch Linux Wiki]		* [https://wiki.archlinux.org/title/Samba Samba in the Arch Linux Wiki]
			* [https://www.samba.org/samba/docs/current/man-html/smb.conf.5.html smb.conf man page]

	[[Category:Server]]		[[Category:Server]]
	[[Category:Applications]]		[[Category:Applications]]