pyrox.dev
1# Samba {#module-services-samba}
2
3[Samba](https://www.samba.org/), a SMB/CIFS file, print, and login server for Unix.
4
5## Basic Usage {#module-services-samba-basic-usage}
6
7A minimal configuration looks like this:
8
9```nix
10{ services.samba.enable = true; }
11```
12
13This configuration automatically enables `smbd`, `nmbd` and `winbindd` services by default.
14
15## Configuring {#module-services-samba-configuring}
16
17Samba configuration is located in the `/etc/samba/smb.conf` file.
18
19### File share {#module-services-samba-configuring-file-share}
20
21This configuration will configure Samba to serve a `public` file share
22which is read-only and accessible without authentication:
23
24```nix
25{
26 services.samba = {
27 enable = true;
28 settings = {
29 "public" = {
30 "path" = "/public";
31 "read only" = "yes";
32 "browseable" = "yes";
33 "guest ok" = "yes";
34 "comment" = "Public samba share.";
35 };
36 };
37 };
38}
39```