Samba

CharjaBox uses the bertvv.samba role to set up and configure SMB.

Your shares are set up in smb.yml in your settings folder. The default/example setup looks like this and sets up a "Media" Share readable and writable by guests:

samba_shares:
  - name: Media 
    comment: 'Media Share'
    guest_ok: yes
    public: yes
    writable: yes
    browsable: yes
    path: "/mnt/Media"

These are the most important options:

  - name (required): Name of your share
    comment: 'Comment to describe your share'
    guest_ok: yes/no # Allow guest access
    public: yes/no # Controls read access for guest users
    writable: yes/no # Writable for guests.
    browsable: yes/no # Controls whether this share appears in file browser.
    path: "/mnt/Media" # Path to the share
    group: $group # The user group files in the share will be added to.
    owner: $user # The owner of the share path
    valid_users: $user # Controls read access for registered users. Use the syntax of the corresponding Samba setting.
    write_list: $user # Controls write access for registered users. Use the syntax of the corresponding Samba setting.

For more options and information read the README for the SMB role.

If you can't access your Shares on a recent Mac, try setting samba_mitigate_cve_2017_7494 to false.