This docker image provides an easy-to-setup SAMBA server, based on CentOS 8.
This SAMBA server takes a JSON configuration file as input and, based on that file, it sets up the container's environment. For example, here's what you can do:
-
Write a configuration file, where:
-
there are two users (
user1
anduser2
); -
there are two shared folders (
/share/public
and/share/user2
); -
/share/public
can be read and written by anyone; -
/share/user2
, instead, can be accessed only byuser2
.
-
-
After writing this configuration file, you start the docker image
adevur/easy-samba
. -
This image reads your configuration file, creates the two users, creates the folders (if they don't exist), and then configure their filesystem permissions accordingly to your configuration file.
-
Now you can connect to your container using Windows or any other SAMBA client.
See also the
Tutorial
in order to get started.
Available tags:
-
Latest unstable release (2.4.0):
latest
.NOTE:
latest
tag works foramd64
,arm64v8
andppc64le
architectures; however, you can also use tagslatest-amd64
,latest-arm64v8
andlatest-ppc64le
, if you need to download a specific architecture. -
Latest stable release (1.19.1):
stable
.NOTE: at the moment, stable branch (i.e.
easy-samba
version1.x.x
) only supportsamd64
architecture. Tagstable-amd64
is also available as an alias forstable
. -
Latest long-term release (none at the moment):
lts
. This tag cannot be used yet since there is no long-term release at the moment.
See also chapters
Versioning
andBranches
for more info.
If you're looking for version history and changelogs, take a look at the
Changelog
.
Versions are in this format: x.y.z
. Where:
-
x
is a major release, and when it gets updated it may break compatibility with older major releases; so that you could be forced to change your software after this update. -
y
is a minor release, and when it gets updated it adds new features, but it maintains compatibility with the major release; so you're not obliged to change your software after this update (unless you want to take advantage of the new features, of course). -
z
is a bugfix release, and when it gets updated it brings bug-fixes and security fixes; so you're not obliged to change your software after this update.
There are three branches: unstable
, stable
and long-term
. Where:
-
unstable
is the latest unstable release. It is not recommended for use in production, because it brings new features more often, and these features are not finalized: they could change in the future and, if you use them, you would be forced to change your software. -
stable
is the latest stable release. It can be used in production, because it brings new features less often, only when they're already finalized and stable. -
long-term
is the latest long-term release. It is based on a previous major release than the one instable
andunstable
branches; it only gets bugfixes and security fixes, since new features are only introduced instable
andunstable
branches. You may want to uselong-term
in production, if you don't need latest features ofstable
branch.
-
To build latest unstable release, run:
docker build --tag local/easy-samba:latest ./unstable/latest
-
To build latest stable release, run:
docker build --tag local/easy-samba:stable ./stable/latest
-
To build a specific release, run (for example):
docker build --tag local/easy-samba:1.0.0 ./stable/1.0.0
In order to use this image, you can have a look at the Tutorial
.
If you need more information for advanced use, have a look at the Documentation
.