{"id":37843271,"url":"https://github.com/samba-in-kubernetes/samba-container","last_synced_at":"2026-01-16T16:01:22.022Z","repository":{"id":38960768,"uuid":"262246344","full_name":"samba-in-kubernetes/samba-container","owner":"samba-in-kubernetes","description":"Build Samba Container Images / Kubernetes \u0026 Container Runtime Example Files","archived":false,"fork":false,"pushed_at":"2025-12-29T15:09:46.000Z","size":278,"stargazers_count":83,"open_issues_count":15,"forks_count":21,"subscribers_count":9,"default_branch":"master","last_synced_at":"2026-01-01T18:59:34.133Z","etag":null,"topics":["docker","kubernetes","podman","samba","smb3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/samba-in-kubernetes.png","metadata":{"files":{"readme":"README.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-05-08T06:36:42.000Z","updated_at":"2025-12-29T15:09:51.000Z","dependencies_parsed_at":"2025-12-18T14:00:12.029Z","dependency_job_id":null,"html_url":"https://github.com/samba-in-kubernetes/samba-container","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/samba-in-kubernetes/samba-container","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samba-in-kubernetes%2Fsamba-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samba-in-kubernetes%2Fsamba-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samba-in-kubernetes%2Fsamba-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samba-in-kubernetes%2Fsamba-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samba-in-kubernetes","download_url":"https://codeload.github.com/samba-in-kubernetes/samba-container/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samba-in-kubernetes%2Fsamba-container/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479455,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["docker","kubernetes","podman","samba","smb3"],"created_at":"2026-01-16T16:01:20.470Z","updated_at":"2026-01-16T16:01:21.739Z","avatar_url":"https://github.com/samba-in-kubernetes.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# samba-container\n\nContainer images for [Samba](https://samba.org) services.\n\n### Our images:\n* Are [OCI](https://opencontainers.org/) formatted container images\n* Provide application-like high-level entrypoint scripts\n* Are available as pre-built stable and \"nightly\" [variants](#image-variants)\n* Are used by the [samba-operator](https://github.com/samba-in-kubernetes/samba-operator) for Kubernetes\n* Don't require Kubernetes\n* Are [available at quay.io](https://quay.io/organization/samba.org)\n* Are used by the [ceph project](https://github.com/ceph/ceph) to provide  SMB services on CephFS\n\n### Image Types:\n\n|Image Type   | Repository | Custom Entrypoint | Features |\n|-------------|------------|-------------------|----------|\n|[Samba Server](#samba-server) | [quay.io](https://quay.io/repository/samba.org/samba-server) | Yes | Standalone file server, Domain member file server |\n|[AD Domain Controller](#ad-dc) | [quay.io](https://quay.io/repository/samba.org/samba-ad-server) | Yes | Active Directory Domain Controller |\n|[Client](#client) | [quay.io](https://quay.io/repository/samba.org/samba-client) | No | Basic Userspace Client Utilities |\n|[Toolbox](#toolbox) | [quay.io](https://quay.io/repository/samba.org/samba-toolbox) | No | Extra debugging and testing tools |\n\n\n## Samba Server\n\nThe Samba server image defaults to the `samba-container` entrypoint.\n\nIn the default configuration, the server container image exports one share,\nnamed \"share\", with the path `/share` which is expected to be a volume provided\nby the host. A default user, named \"sambauser\" is predefined with a password of\n\"samba\". This simple mode of operation is great for quick demos. Example:\n\n```sh\npodman run --name samba --publish 10445:445 --volume=/path/on/host/to/share:/share:Z --rm  quay.io/samba.org/samba-server:latest\n```\n\u003e **Note**\n\u003e The port mapping option (`--publish`) is only needed when running\n\u003e as non-root, e.g. for testing purposes.\n\nThe `samba-container` entrypoint can perform many functions and is\ndesigned to make the container image act like a cohesive application.\nIt can automate the management of Samba as well as the container environment\nto make them work together. This tool is provided by the\n[sambacc project](https://github.com/samba-in-kubernetes/sambacc).\n\n```sh\n# print help\npodman run --rm quay.io/samba.org/samba-server:latest --help\n# print help for the run subcommand\npodman run --rm quay.io/samba.org/samba-server:latest run --help\n```\n\n### Changing the configuration\n\nThe behavior of the container can be changed by invoking it with specific\narguments for the `samba-container` script and/or setting environment\nvariables.\n\nYou can include a custom configuration via the following method:\n```\n$EDITOR /path/to/config/config.json\npodman run --name samba  --publish 10445:445 --volume=/path/on/host/to/share:/share:Z --volume=/path/to/config:/etc/samba-container -e SAMBACC_CONFIG=/etc/samba-container/config.json -e SAMBA_CONTAINER_ID=myid  --rm  quay.io/samba.org/samba-server:latest\n```\n\n\u003c!-- TODO: link to advanced docs for samba server --\u003e\n\n## AD DC\n\nThe AD DC image defaults to the `samba-dc-container` entrypoint.\n\nIn the default configuration, the AD DC container image automatically\nprovisions and serves a simple stock domain `DOMAIN1.SINK.TEST`.\nBecause the Samba AD DC uses certain file system xattrs this container\nmust currently be run with privileges. Example:\n\n```sh\npodman run --rm --privileged  quay.io/samba.org/samba-ad-server:latest\n```\n\nThe `samba-dc-container` entrypoint can perform multiple functions as is\ndesigned to make the container image act like a cohesive application.\nIt helps automate the provisioning of and/or connection to a domain.\nThis tool is provided by the\n[sambacc project](https://github.com/samba-in-kubernetes/sambacc).\n\n\u003c!-- TODO: link to advanced docs for samba server --\u003e\n\n## Client\n\nThe project provides a simple samba client container image that can be\nuseful for testing. One does not need to install the user space samba client\nlocally but rather use the container image. It can run the samba client\ninteractively when a TTY is available and can also be scripted for\nautomated testing purposes. Example:\n\n```sh\npodman run --rm -it   quay.io/samba.org/samba-client:latest\n[root@dc0419d28c4e /]# smbclient -U 'sambauser' //foo.example.org/share\n```\n\n## Toolbox\n\nThe project provides a container image container containing the samba test\nsuite program\n([smbtorture](https://wiki.samba.org/index.php/Writing_Torture_Tests)) as well\nas the user space client. This can be used for debugging and testing purposes.\nExample:\n\n```sh\npodman run --rm -it   quay.io/samba.org/samba-toolbox:latest\n[root@dc0419d28c4e /]# smbtorture --help\n```\n## Image Variants\n\nThe server images come in two variants: stable and nightly. The\nstable variant is what you get with the \"latest\" tag and includes\nSamba packages from the Linux distribution used in our base images.\nThe \"nightly\" images are based on Samba RPM packages created by the\n[samba-build project](https://github.com/samba-in-kubernetes/samba-build)\nwhich builds and tests Samba builds before release. The nightly images\nare tagged with \"nightly\" instead of \"latest\".\n\n## Developers\n\n### Building the containers\n\n```sh\n# Build Everything\nmake build\n```\n\nEach container image type has a build target:\n```sh\n# Build the server image\nmake build-server\n# Build the server with \"nightly\" samba\nmake build-nightly-server\n# Build the client\nmake build-client\n# And so on...\n```\n\nThere are matching `push-*` rules that default to pushing the images to the\n\"official\" quay.io repositories. These rules can be executed by the appropriate\ngithub actions or by project maintainers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamba-in-kubernetes%2Fsamba-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamba-in-kubernetes%2Fsamba-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamba-in-kubernetes%2Fsamba-container/lists"}