Collection of cookbooks for Podman Quadlets
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Nicolas Massé 5828e563f8 documentation 2 weeks ago
..
config WiP 4 weeks ago
tmpfiles.d WiP 4 weeks ago
Makefile WiP 4 weeks ago
README.md documentation 2 weeks ago
hooks.mk WiP 4 weeks ago
samba-build.timer WiP 4 weeks ago
samba.build WiP 4 weeks ago
samba.container WiP 4 weeks ago
samba.target WiP 4 weeks ago

README.md

Podman Quadlet: Samba

Overview

Samba is an SMB/CIFS file sharing server started as a Podman Quadlet. It allows sharing files and directories over the network with Windows, macOS, and Linux clients.

This cookbook:

  • Builds a custom Samba container image locally.
  • Runs Samba with configurable shares via drop-in configuration files.
  • Supports user authentication with system users mapped into the container.
  • Includes a timer to periodically rebuild the container image.
  • Only starts if at least one share configuration file exists.

Prerequisites

  • Share configuration files must exist in /etc/quadlets/samba/smb.conf.d/ with names ending in shares.conf.

Usage

In a separate terminal, follow the logs.

sudo make tail-logs

Install the Podman Quadlets and start Samba.

sudo make clean install

You should see the samba-build.service building the Samba container image. Then, the samba.service should start up.

Verify Samba is running:

sudo systemctl status samba.service

Test connectivity from a client:

smbclient -L //localhost -N

Connect to a share:

smbclient //localhost/sharename -U username

Restart the samba.target unit.

sudo systemctl restart samba.target

Finally, remove the quadlets, their configuration and their data.

sudo make uninstall clean

Integration tests

sudo make test