Samba#

Samba Export your VLAB storage_dirs as CIFS/SMB file shares - Uses the dperson/samba image.

amd64
arm64
armv7

Information#

Docker Image: !!! LINK TO DOCKER IMAGE/ DOCKER HUB !!!
Current Image Version: latest

SETUP#

Enabling samba#

Command:#

vlab set samba.enable True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

samba
enable: True

Finalising changes:#

run: vlab update_one service=samba

FIRST RUN#

!!! DEVELOPERS: make sure that you include any information that the user requires to get started, below. !!!
!!! Below are some examples with headings, and with some example instructions !!!

ADMINISTRATOR SETUP#

Create an account with your desired username; as this is the first user, samba makes this account the administrator.

SMTP/ MAIL#

  1. run vlab decrypt to decrypt the vault.yml file
  2. make some changes

SMTP Settings#

smtp:
host:
port:
user:
pass:
from_email:
from_name:
  1. run vlab update_one service=samba to complete the changes

Access#

This container exposes your /mnt/nas/* folders as a SMB/CIFS (Windows file sharing) network share.

You can connect to it using windows, linux and mac via

smb://[email protected]/VivumLab

OPTIONS#

HTTPS_ONLY#

Default: False
Options: True/False

Command:#

vlab set samba.https_only True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

samba
https_only: True
Finalising changes:#

run: vlab update_one service=samba

AUTH#

Default: False
Options: True/False

Command:#

vlab set samba.auth True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

samba
auth: True
Finalising changes:#

run: vlab update_one service=samba

DOMAIN#

Default: False
NOTE: include the sitename and top level domain suffix. eg. name.com, site.net

Command:#

vlab set samba.domain samba.com

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

samba
domain: samba.com
Finalising changes:#

run: vlab update_one service=samba

SUBDOMAIN#

Default: samba
NOTE: Periods/ delimiters are not required. eg. 'media' will set the full URL as 'media.vivumlab.xyz'

Command:#

vlab set samba.subdomain media

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

samba
subdomain: media
Finalising changes:#

run: vlab update_one service=samba

VERSION#

Default: latest
NOTE: Ensure that the version exists

Command:#

vlab set samba.version 2.7

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

samba
version: 2.7
Finalising changes:#

run: vlab update_one service=samba

Need more help?#

Further information regarding services can be found.
General Information can be found in the documentation.
Additional assistance can be found on our Contact Us page.