nixos/modules/services/network-filesystems/samba.md

   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
   7 A minimal configuration looks like this:
   8
   9 ```nix
  10 {
  11   services.samba.enable = true;
  12 }
  13 ```
  14
  15 This configuration automatically enables `smbd`, `nmbd` and `winbindd` services by default.
  16
  17 ## Configuring {#module-services-samba-configuring}
  18
  19 Samba configuration is located in the `/etc/samba/smb.conf` file.
  20
  21 ### File share {#module-services-samba-configuring-file-share}
  22
  23 This configuration will configure Samba to serve a `public` file share
  24 which is read-only and accessible without authentication:
  25
  26 ```nix
  27 {
  28   services.samba = {
  29     enable = true;
  30     settings = {
  31       "public" = {
  32         "path" = "/public";
  33         "read only" = "yes";
  34         "browseable" = "yes";
  35         "guest ok" = "yes";
  36         "comment" = "Public samba share.";
  37       };
  38     };
  39   };
  40 }
  41 ```