{"id":19871941,"url":"https://github.com/saltstack-formulas/samba-formula","last_synced_at":"2025-08-29T03:41:22.915Z","repository":{"id":41308875,"uuid":"10653696","full_name":"saltstack-formulas/samba-formula","owner":"saltstack-formulas","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-26T04:17:50.000Z","size":90,"stargazers_count":15,"open_issues_count":9,"forks_count":72,"subscribers_count":33,"default_branch":"master","last_synced_at":"2025-06-26T05:25:30.954Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saltstack-formulas.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-06-12T22:22:06.000Z","updated_at":"2025-06-26T04:17:55.000Z","dependencies_parsed_at":"2025-01-11T16:33:02.847Z","dependency_job_id":"a345666f-6d30-4abf-a206-73655974a9ec","html_url":"https://github.com/saltstack-formulas/samba-formula","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/saltstack-formulas/samba-formula","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Fsamba-formula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Fsamba-formula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Fsamba-formula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Fsamba-formula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saltstack-formulas","download_url":"https://codeload.github.com/saltstack-formulas/samba-formula/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Fsamba-formula/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272619998,"owners_count":24965452,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T16:14:02.150Z","updated_at":"2025-08-29T03:41:22.870Z","avatar_url":"https://github.com/saltstack-formulas.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"samba\n=====\nInstall and configure a samba server.\n\n.. note::\n\n    See the full `Salt Formulas installation and usage instructions\n    \u003chttp://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html\u003e`_.\n\nAvailable states\n================\n\n.. contents::\n    :local:\n    \n``samba``\n---------\n\nInstalls the samba server and client packages and starts the samba service.\n\n``samba.client``\n----------------\n\nInstalls the samba client package.\n\n``samba.config``\n----------------\n\nIncludes the ``samba`` state.\n\nCreates a ``smb.conf`` based on defaults. Pillars if defined override default values.\n\n``samba.users``\n----------------\n\nIncludes the ``samba`` state.\n\nCreates samba users (via ``smbpasswd``)  based on pillar data.\n\n``samba.winbind``\n----------------\n\nIncludes the ``samba`` state.\n\nInstalls samba-winbind packages and updates NSS (nsswitch.conf). Run this state after joining the Domain.\n\n``samba.winbind-ad``\n----------------\n\nIncludes the ``winbind`` state.\n\nBy default this state provides full Active Directory (AD) domain membership if ``samba.role`` equals ``ROLE_DOMAIN_MEMBER``.\n\n``samba.clean``\n--------------\n\nCalls `clean` state for all modules to completely remove samba and winbind.\n\nConfiguration\n=============\nThe distro samba package includes a default ``smb.conf`` which is overridden by ``samba.config`` state. This formula has good defaults for samba ROLE_STANDALONE and ROLE_DOMAIN_MEMBER roles, but can be extended/overridden in pillars.\n\n\nAD integration\n==================\n\nEnsure host's assigned (dhcp) ipaddress is reflecting DNS.\n\n.. code-block:: bash\n\n     [myhost]$ ip addr\n     [myhost]$ host myhost.example.com\n\nEnsure system time is NTP synchronized (yes)!!\n\n.. code-block:: bash\n\n     $ # timedatectl\n               Local time: Fri 2018-02-09 08:34:10 MST\n           Universal time: Fri 2018-02-09 15:34:10 UTC\n                 RTC time: Fri 2018-02-09 15:34:21\n                Time zone: America/Denver (MST, -0700)\n          Network time on: yes\n         NTP synchronized: yes\n          RTC in local TZ: no\n\nJoin the domain in three commands-\n\n.. code-block:: bash\n\n     $ sudo net ads join EXAMPLE.COM -U 'domainAdminUser'\n     Enter domainAdminUser password:\n     Using short domain name -- EXAMPLE\n     Joined MYHOST to dns domain ‘example.com'\n\n     $ sudo kinit -k MYHOST\\$@EXAMPLE.COM\n\n     $ sudo systemctl restart winbind\n\nIf 'kinit' fails then try rebooting and checking for issues with time and dns.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack-formulas%2Fsamba-formula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaltstack-formulas%2Fsamba-formula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack-formulas%2Fsamba-formula/lists"}