UPS (Uninterruptible Power Supplies) arise from this need. In a very brief way, they are batteries that, placed between our electronic devices and the current, not only protect the devices from possible problems in the electrical supply, but also, in the event of a power outage, offer energy for a reasonable time so that we can safeguard the data, shut down the device correctly and avoid problems.

Although, the objective of this article is not to describe what a UPS is, what types exist, what you have to look for when you buy one… but the integration of it in our server to be able to monitor the information it offers and to be able to carry out different functions when we are interested in an automated way. I do recommend analyzing that the UPS we buy can be integrated via USB, since not all of them are.

Although compatible with many brands and models (which we will see later), for this tutorial we are going to integrate the Salicru SPS 900 ONE model using NUT (Network UPS Tools).

NUT Server

NUT (Network UPS Tools) consists of two well-differentiated parts, a software in server mode, which obtains the data from the UPS, and a software in client mode, which displays the data obtained by requesting that information from the server.

We need to know which USB device our server has assigned to the UPS. To do this, in the terminal of the server that is going to manage the UPS, execute lsusb, connect the USB cable from the UPS to the server and launch the command again. We will see a new entry:

...
Bus 002 Device 001: ID 0665:5161 Cypress Semiconductor USB to Serial
...

Take note of Bus (002) and Device (001). With this information we will get the path of the device. Following the example, it would be: /dev/bus/usb/002/001.

Next, and as usual in the blog, we are going to instantiate a Docker container in order to create a service with the purpose we are looking for. In this case, create a Network UPS Tools server.

Execute the following command in a terminal:

docker run -d --name=nut-upsd --hostname=nut-upsd --restart=always --network=host --device /dev/bus/usb/002/001 -e UPS_NAME="server_ups" -e UPS_DESC="Server - Salicru SPS 900 ONE" -e UPS_DRIVER="blazer_usb" -e UPS_PORT="auto" -e API_USER="upsmon" -e API_PASSWORD="123456789ABCDEFGH" -e ADMIN_PASSWORD="123456789ABCDEFGH" -e SHUTDOWN_CMD="echo 'Home has no current. Proceeding to shut down...'" upshift/nut-upsd

We are going to explain each of the parameters that have been used:

• docker run -d: Create a container with the following configuration if it doesn’t exist and start it in the background.
• --name=nut-upsd: The name of the container. It is important because we can have several containers instantiated from the same image.
• --hostname=nut-upsd: Is the name of the host to use inside the container.
• --restart=always: Restart the container automatically if it stops. If it is stopped manually, it is only started when the container is manually started or the Docker service is restarted.
• --network=host: The host network uses the IP address of the server, so a container’s network appears to be the server itself rather than separate.
• --device /dev/bus/usb/002/001: We give the container access to the USB device that we discovered earlier.
• -e UPS_NAME="server_ups -e UPS_DESC="Server - Salicru SPS 900: It is the name and description that we want to give to the UPS, in case we have more than one.
• -e UPS_DRIVER="blazer_usb": The driver that we are going to use with the UPS. Each brand usually has a different driver. Read more below.
• -e UPS_PORT="auto": Indicates the UPS port if by chance you need a specific port. It is not usually necessary to modify this parameter.
• -e API_USER="upsmon" -e API_PASSWORD="123456789ABCDEFGH": Indicates the username and password that we want to use for data read-only mode. It is the user that we will use normally.
• -e ADMIN_PASSWORD="123456789ABCDEFGH": Indicates the password used in administrator mode to perform write functions on the server and the UPS.
• -e SHUTDOWN_CMD="echo 'Home has no current. Proceeding to shut down...'": script/command to run when battery is VERY low. For example, perform a server shutdown.
• upshift/nut-upsd: Indicates the image used to mount the container. If no version is indicated, it will take the latest stable version.

To know which UPS_DRIVER to use, you can consult the NUT compatibility list, in case you can’t find it, there is a list of devices tested by the community.

You also have an example for Docker Compose here.

Clients

Once the server is instantiated, we can use any client to query data or perform different functions.

The server container itself includes a client. If we have enough knowledge of Docker, we can do a *Docker Attach *and execute upsd <UPS_NAME> (UPS_NAME is the name of the UPS that we have indicated when instantiating the server). Commands can also be run with upscmd and upsrw.

docker-webnut

docker-webnut is another simple client for querying data. We can instantiate a Docker container with the following command:

docker run -d --name=webnut --hostname=webnut --restart=always --network=host -e UPS_HOST="<IP_SERVIDOR>" -e UPS_PORT="3493" -e UPS_USER="upsmon" -e UPS_PASSWORD="123456789ABCDEFGH" edgd1er/webnut:latest

We only need to indicate the IP of the machine to which the UPS is connected via USB (in our example, the IP of the server), the username and password that we indicated when instantiating the NUT server, and the port, which is 3493 by default.

Next, we access a Web browser and indicate the address http://<Server_IP>:3494.

nut-webui

The nut-webui client is somewhat more complex. We need to previously create the files:

• upsset.conf
  • Uncomment the line to have http://<Server_IP>:6544/cgi-bin/nut/upsset.cgi
  • User admin, password, the one generated automatically in the Docker Log or indicated in the creation of the NUT server.
• hosts.conf
  • Enter the UPS data.
• upsstats.html
• upsstats-single.html

Configuration and sample files: https://github.com/gpdm/nut/tree/master/nut-webui/files/etc/nut

And include them in a folder that we will use when instantiating the container with the following command:

docker run -d --name=nut-webui --hostname=nut-webui --restart=always -p 6495:80 -v <PATH_FOLDER_CONFIGURATION_FILES>:/etc/nut gpdm/nut-webui:latest

Next, we access a Web browser and indicate the address http://<Server_IP>:3495.

Bonus: HomeAssistant integration

We can use Home Assistant as a client, monitor the values offered by the server and perform different automations depending on the status of the sensors created with these values.

Surely, the automatic detection system of Home Assistant detects NUT in our network, but if it is not the case, it is enough to add the integration from Settings -> Devices & Services -> Add Integration -> Network UPS Tools (NUT).

We indicate the data of our NUT server as we have done in other clients and that’s it.

Bonus 2: CheckMK integration

Although we have not talked about CheckMK in this blog, it is a monitoring and alert system that I use frequently. If you are familiar with it, you may be interested in the following Plugin to monitor UPS data: https://github.com/danimart1991/checkmk_nut

References

• Random Bits - Monitoring a UPS with nut on Debian or Ubuntu Linux
• Domology - Integrar un SAI en Home Assistant
• Network UPS Tools - Documentation
• Tinkerings - UPS monitoring with NUT, Nagios and Check_MK
• Professional Review - SAI: Qué es, para qué sirve y que tipos hay en el mercado

Los SAI (Sistemas de Alimentación Ininterrumpida) surgen ante esta necesidad. De manera muy resumida, son baterías que, colocadas entre nuestros dispositivos electrónicos y la corriente, no solo protege a los dispositivos de posibles problemas en el suministro eléctrico, si no que también, ante un corte, ofrecen energía un tiempo prudencial para que podamos salvaguardar los datos, apagar el dispositivo correctamente y evitar problemas.

Si bien, el objetivo de este artículo no es el de describir que es un SAI, que tipos existen, que has de buscar cuando compres uno… si no la integración de éste en nuestro servidor para poder monitorizar la información que ofrece y poder llevar a cabo distintas funciones cuando nos interese de manera automatizada. Si recomiendo, analizar que el SAI que compremos sea integrable por USB, ya que no todos lo son.

Aunque compatible con muchas marcas y modelos (que veremos más adelante), para este tutorial vamos a integrar el modelo Salicru SPS 900 ONE haciendo uso de NUT (Network UPS Tools).

Servidor NUT

NUT (Network UPS Tools) consta de dos partes bien diferenciadas, un software en modo servidor, el cual obtiene los datos del SAI, y un software en modo cliente, que muestra los datos obtenidos pidiendo al servidor esa información.

Necesitamos conocer que dispositivo USB ha asignado nuestro servidor al SAI. Para ello, en la terminal del servidor que va a gestionar el SAI ejecutamos lsusb, enchufamos un cable USB del SAI al servidor y lanzamos el comando de nuevo. Veremos una nueva entrada:

...
Bus 002 Device 001: ID 0665:5161 Cypress Semiconductor USB to Serial
...

Apuntamos Bus (002) y Device (001). Con esta información sacaremos la ruta del device. Siguiendo el ejemplo, quedaría: /dev/bus/usb/002/001.

A continuación, y como viene siendo habitual en el blog, vamos a instanciar un contenedor Docker con el fin de crear un servicio con el propósito que buscamos. En este caso, crear un servidor Network UPS Tools.

Ejecutamos el siguiente comando en un terminal:

docker run -d --name=nut-upsd --hostname=nut-upsd --restart=always --network=host --device /dev/bus/usb/002/001 -e UPS_NAME="server_ups" -e UPS_DESC="Server - Salicru SPS 900 ONE" -e UPS_DRIVER="blazer_usb" -e UPS_PORT="auto" -e API_USER="upsmon" -e API_PASSWORD="123456789ABCDEFGH" -e ADMIN_PASSWORD="123456789ABCDEFGH" -e SHUTDOWN_CMD="echo 'Home has no current. Proceeding to shut down...'" upshift/nut-upsd

Vamos a explicar cada uno de los parámetros que se han usado:

• docker run -d: Crea un contenedor con la siguiente configuración si no existe y lo arranca en segundo plano.
• --name=nut-upsd: El nombre del contenedor. Es importante pues podemos tener varios contenedores instanciados desde la misma imagen.
• --hostname=nut-upsd: Es el nombre del host que se va a usar dentro del contenedor.
• --restart=always: Reinicia el contenedor automáticamente si se para. Si se para manualmente, solo es inciiado cuando el contenedor se inicie manualmente o el servicio Docker sea reiniciado.
• --network=host: La red host utiliza la dirección IP del servidor, de modo que la red de un contenedor parece ser el propio servidor en lugar de estar separado.
• --device /dev/bus/usb/002/001: Damos acceso al contenedor al dispositivo USB que hemos descubierto antes.
• -e UPS_NAME="server_ups -e UPS_DESC="Server - Salicru SPS 900: Es el nombre y descripción que queremos dar al SAI, por si tenemos más de uno.
• -e UPS_DRIVER="blazer_usb": El driver que vamos a usar con el SAI. Cada marca suele tener un driver diferente. Lee más abajo.
• -e UPS_PORT="auto": Indica el puerto del SAI si por un casual necesita un puerto específico. No suele ser necesario modificar este parámetro.
• -e API_USER="upsmon" -e API_PASSWORD="123456789ABCDEFGH": Indica el usuario y contraseña que queremos usar para el modo de solo lectura de datos. Es el usuario que usaremos normalmente.
• -e ADMIN_PASSWORD="123456789ABCDEFGH": Indica la contraseña usada en el modo administrador para realizar funciones de escritura en el servidor y en el SAI.
• -e SHUTDOWN_CMD="echo 'Home has no current. Proceeding to shut down...'": script/comando a ejecutar cuando la batería sea MUY baja. Por ejemplo, realizar un apagado del servidor.
• upshift/nut-upsd: Indica la imagen usada para montar el contenedor. Si no se indica versión cogerá la última versión estable.

Para saber que UPS_DRIVER usar, se puede consultar la lista de compatibilidad de NUT, en el caso de no encontrarlo, hay una lista de dispositivos probados por la comunidad.

También dispones de un ejemplo para Docker Compose aquí.

Clientes

Una vez instanciado el servidor, podremos usar cualquier cliente para consultar datos o realizar diferentes funciones.

El propio contenedor del servidor incluye un cliente. Si tenemos conocimientos suficientes de Docker, podemos realizar un Docker Attach y ejecutar upsd <UPS_NAME> (UPS_NAME es el nombre del SAI que hemos indicado al instanciar el servidor). También se pueden ejecutar comandos con upscmd y upsrw.

docker-webnut

docker-webnut es otro cliente sencillo para consultar datos. Podemos instanciar un contenedor Docker con el siguiente comando:

docker run -d --name=webnut --hostname=webnut --restart=always --network=host -e UPS_HOST="<IP_SERVIDOR>" -e UPS_PORT="3493" -e UPS_USER="upsmon" -e UPS_PASSWORD="123456789ABCDEFGH" edgd1er/webnut:latest

Solo necesitamos indicar la IP de la máquina a la que está conectado por USB el SAI (en nuestro ejemplo, la IP del servidor), el usuario y contraseña que hemos indicado al instanciar el servidor NUT y el puerto, que por defecto es 3493.

A continuación, accedemos a un navegador Web e indicamos la dirección http://<IP_Servidor>:3494.

nut-webui

](/assets/posts/es/integrando-sai-servidor/nut-webui-dashboard-01.png)

](/assets/posts/es/integrando-sai-servidor/nut-webui-dashboard-02.png)

El cliente nut-webui es algo más complejo. Necesitamos crear previamente los archivos:

• upsset.conf
  • Descomentar la línea para disponer de http://<IP_Servidor>:6544/cgi-bin/nut/upsset.cgi
  • Usuario admin, contraseña, la generada automáticamente en el Log de Docker o indicada en la creación del servidor NUT.
• hosts.conf
  • Poner dentro los datos del SAI.
• upsstats.html
• upsstats-single.html

Configuración y archivos de ejemplo: https://github.com/gpdm/nut/tree/master/nut-webui/files/etc/nut

E incluirlos en una carpeta que usaremos al instanciar el contenedor con el siguiente comando:

docker run -d --name=nut-webui --hostname=nut-webui --restart=always -p 6495:80 -v <RUTA_CARPETA_ARCHIVOS_CONFIGURACIÓN>:/etc/nut gpdm/nut-webui:latest

A continuación, accedemos a un navegador Web e indicamos la dirección http://<IP_Servidor>:3495.

Bonus: Integración en Home Assistant

Podemos usar Home Assistant como cliente, monitorizar los valores que ofrece el servidor y realizar diferentes automatizaciones dependiendo del estado de los sensores creados con estos valores.

Seguramente, el sistema de detección automático de Home Assistant detecte NUT en nuestra red, pero si no es el caso, basta con añadir la integración desde Ajustes -> Dispositivos y Servicios -> Añadir Integración -> Network UPS Tools (NUT).

Indicamos los datos de nuestro servidor NUT como hemos hecho en otros clientes y listo.

Bonus 2: Integración en CheckMK

Aunque no hemos hablado en este blog sobre CheckMK, es un sistema de monitorización y alertas que uso con frecuencia. Si estás familiarizado con él, puede interesarte el siguiente Plugin para poder monitorizar los datos del SAI: https://github.com/danimart1991/checkmk_nut

Referencias

• Random Bits - Monitoring a UPS with nut on Debian or Ubuntu Linux
• Domology - Integrar un SAI en Home Assistant
• Network UPS Tools - Documentation
• Tinkerings - UPS monitoring with NUT, Nagios and Check_MK
• Professional Review - SAI: Qué es, para qué sirve y que tipos hay en el mercado

Webmin solves the management of a server in an elegant way, since it is a system configuration tool accessible via the web for Unix systems. With it, you can configure user accounts, view and edit files, view the status of system resources, and much more from the comfort of your browser. This application helps us eliminate the need to edit the configuration and service files manually and provides an interface to do it easily and with little tips.

WARNING: Webmin allows you to modify settings and data at the core level of the system, this means that before touching any module, it is advisable to read documentation about how it works and how it can affect our server.

Installation and Use

We are going to install Webmin on the system itself by apt package. The reason for doing it this way and not in a Docker container is because Webmin needs to have full access to the entire system, both files and services. Also, if for any reason the Docker service goes down, you can still use Webmin to fix the problem.

Assuming that your server has a distribution based on Debian, Ubuntu or Mint. Execute the following commands:

$ sudo wget -qO - http://www.webmin.com/jcameron-key.asc | sudo apt-key add -
$ sudo sh -c 'echo "deb http://download.webmin.com/download/repository sarge contrib" > /etc/apt/sources.list.d/webmin.list'
$ sudo apt install apt-transport-https -y
$ sudo apt update
$ sudo apt install webmin -y

For the rest of the distributions and available installation types, you can consult this Wiki.

And that’s all, finally, open a browser and access the address https://<ip_of_your_server>:10000. On the main screen (Dashboard) you will have summary information on the status of your server. In the bar on the left you will have different utilities to manage the server. Remember, before touching, it is convenient to read the documentation of that module and tool.

It is possible that, when entering for the first time, a certificate error is displayed, agree to enter in a non-secure way.

References

• Webmin - Official Web
• Webmin - Wiki
• Raiola Networks - Manual completo Webmin, Usermin y Virtualmin
• Linuxize - How to Install Webmin on Debian 10 Linux

Webmin resuelve la gestión de un servidor de manera elegante, ya que se trata de una herramienta de configuración de sistemas accesible vía web para sistemas Unix. Con ella, puedes desde la comodidad del navegador configurar cuentas de usuario, visualizar y editar archivos, ver el estado de los recursos del sistema y un largo etcétera. Este aplicativo nos ayuda a eliminar la necesidad de editar los archivos de configuración y de los servicios manualmente y brinda una interfaz para hacerlo de manera sencilla y con pequeños consejos.

AVISO: Webmin permite modificar configuraciones y datos a nivel de núcleo del sistema, esto significa que antes de tocar cualquier módulo, conviene leer documentación acerca de cómo funciona y en que puede afectar a nuestro servidor.

Instalación y Uso

Vamos a instalar Webmin en el propio sistema por paquete apt. La razón de hacerlo así y no en un contenedor Docker, es porque Webmin necesita tener acceso completo a todo el sistema, tanto a archivos como a servicios. Además, si por cualquier motivo el servicio Docker cae, podremos seguir usando Webmin para solucionar el problema.

Suponiendo que nuestro servidor tiene una distribución basada en Debian, Ubuntu o Mint. Ejecutamos los siguientes comandos:

$ sudo wget -qO - http://www.webmin.com/jcameron-key.asc | sudo apt-key add -
$ sudo sh -c 'echo "deb http://download.webmin.com/download/repository sarge contrib" > /etc/apt/sources.list.d/webmin.list'
$ sudo apt install apt-transport-https -y
$ sudo apt update
$ sudo apt install webmin -y

Para el resto de distribuciones y tipos de instalación disponibles puedes consultar esta Wiki.

Y poco más, por último, abrimos un navegador y accede a la dirección https://<ip_de_tu_server>:10000. En la pantalla principal (Dashboard) tendrás información resumida del estado de tu servidor. En la barra de la izquierda dispondrás de distintas utilidades para gestionar el servidor. Recuerda, antes de tocar, conviene leer la documentación de ese módulo y herramienta.

Es posible que, al entrar por primera vez, se muestre un error de certificados, acepta entrar de manera no segura.

Referencias

• Webmin - Official Web
• Webmin - Wiki
• Raiola Networks - Manual completo Webmin, Usermin y Virtualmin
• Linuxize - How to Install Webmin on Debian 10 Linux

Why do we need a Samba server to access files from Windows on a Linux server? Okay. By default, both systems use different file sharing protocols. Samba is a free implementation of the Microsoft Windows File Sharing Protocol (formerly called SMB, recently renamed CIFS) for UNIX-like systems.

Installation

Most of the following commands require root privileges to run. You can use sudo or log in as root user and save yourself typing the prefix in each command.

Install the Samba server package:

$ sudo apt update
$ sudo apt install samba -y

Enable the Samba service to start with the system:

$ sudo systemctl enable smbd

If you use the system firewall, you need to open the following ports:

$ sudo ufw allow 139
$ sudo ufw allow 445

Restart the smbd service and check that it’s running:

$ sudo systemctl restart smbd
$ sudo systemctl status smbd

  ? smbd.service - Samba SMB Daemon
  ...
  Status: "smbd: ready to serve connections..."
  ...

Setting up Samba Share

Edit the smb.conf file with the command sudo nano /etc/samba/smb.conf, adding the following to the end of the document:

[media]
comment = media folder
path = /media
writeable = yes
browsable = yes
public = no
valid users = danimart1991, root

I attach an explanation of each line:

• [media]: It is the short name that describes what we are going to share. An identifier.
• comment: A comment to describe what we are sharing.
• path: The path of the folder we want to share.
• writeable: Indicates if we want the folder to be read-only or if you want to allow writes and deletions to be carried out on it.
• browsable: If this share is seen in the list of available shares in a network view and in the navigation list.
• public: Indicates if the folder does NOT need a password to access it.
• valid users: List of users who will have access to the folder.

You can see more options in the documentation of the configuration file.

We save the file with the F3 key and exit with F2.

Setting up Users

As you can see, I have indicated in the valid users field which users can access the files. These users must have access to the shared folder and its files, otherwise they will not be able to see them when access it from Windows.

In addition, these users have to be created on our server. If not, just use the command:

$ sudo useradd danimart1991

Next. You have to declare that user in Samba and assign a unique password for this service. For this, use the following command:

$ sudo smbpasswd -a danimart1991
New SMB password: xxxxxxxx
Retype new SMB password: xxxxxxxx

Finally, restart the service:

$ sudo systemctl restart smbd

Conclusion

We have already configured our Samba server for access from Windows. It is enough to open a File Explorer, write the server address and access indicating the credentials that have been previously created.

Now you will have quick and easy access from your Windows devices to the server folders.

References

• Thanks to José Antonio Simancas (JASimancas)
• Samba
• Server World - Debian 11 Bullseye : Samba
• Linuxito - Instalar y configurar un servidor Samba en Debian
• Unixcop - How to configure Samba Server with Debian 11
• smb.conf — The configuration file for the Samba suite

¿Por qué necesitamos un servidor Samba para acceder desde Windows a los archivos en un servidor Linux? Bueno. Por defecto, ambos sistemas utilizan protocolos de archivos compartidos distintos. Samba es una implementación libre del protocolo de archivos compartidos de Microsoft Windows (antiguamente llamado SMB, renombrado recientemente a CIFS) para sistemas de tipo UNIX.

Instalación

La mayoría de los siguientes comandos necesitan privilegios root para su ejecución. Puedes usar sudo o iniciar sesión como usuario root y ahorrarte escribir el prefijo en cada comando.

Instalamos el paquete Samba server:

$ sudo apt update
$ sudo apt install samba -y

Habilitamos el servicio Samba para que inicie con el sistema:

$ sudo systemctl enable smbd

Si usamos el firewall del sistema, necesitamos abrir los siguientes puertos:

$ sudo ufw allow 139
$ sudo ufw allow 445

Reiniciamos el servicio smbd y comprobamos que está ejecutándose:

$ sudo systemctl restart smbd
$ sudo systemctl status smbd

  ? smbd.service - Samba SMB Daemon
  ...
  Status: "smbd: ready to serve connections..."
  ...

Configurando Samba Share

Edita el archivo smb.conf con el comando sudo nano /etc/samba/smb.conf, añadiendo al final del documento lo siguiente:

[media]
comment = media folder
path = /media
writeable = yes
browsable = yes
public = no
valid users = danimart1991, root

Adjunto una explicación de cada línea:

• [media]: Es el nombre corto que describe aquello que vamos a compartir. Un identificador.
• comment: Un comentario para describir que estamos compartiendo.
• path: La ruta de la carpeta que queremos compartir.
• writeable: Indica si queremos que la carpeta sea de solo lectura o si quieres permitir que se realizan escrituras y borrados sobre ella.
• browsable: Si este recurso compartido se ve en la lista de recursos compartidos disponibles en una vista de red y en la lista de navegación.
• public: Indica si la carpeta NO necesita contraseña para acceder a ella.
• valid users: Listado de usuarios que tendrán acceso a la carpeta.

Puedes consultar más opciones en la documentación del archivo de configuración.

Guardamos el archivo con la tecla F3 y salimos con F2.

Configurando Usuarios

Como has podido ver, he indicado en el campo valid users que usuarios pueden acceder a los archivos. Estos usuarios han de tener acceso a la carpeta compartida y sus archivos, de lo contrario no podrán verlos cuando accedamos desde Windows.

Además, estos usuarios tienen que estar creados en nuestro servidor. De no ser así, basta con usar el comando:

$ sudo useradd danimart1991

A continuación. Tenemos que declarar ese usuario en Samba y asignarle una contraseña exclusiva para este servicio. Para ello usamos el siguiente comando:

$ sudo smbpasswd -a danimart1991
New SMB password: xxxxxxxx
Retype new SMB password: xxxxxxxx

Finalmente reiniciamos el servicio:

$ sudo systemctl restart smbd

Conclusión

Ya tenemos configurado nuestro servidor Samba para su acceso desde Windows. Basta con abrir un Explorador de Archivos, escribir la dirección del servidor y acceder indicando las credenciales que hemos creado previamente.

Ahora tendrás un acceso rápido y sencillo desde tus dispositivos Windows a las carpetas del servidor.

Referencias

• Agradecimientos a José Antonio Simancas (JASimancas)
• Samba
• Server World - Debian 11 Bullseye : Samba
• Linuxito - Instalar y configurar un servidor Samba en Debian
• Unixcop - How to configure Samba Server with Debian 11
• smb.conf — The configuration file for the Samba suite