Files
calypso/docs/alpha/components/samba/Samba-Installation-Guide.md
2026-01-09 16:54:39 +00:00

1.8 KiB

Samba Installation and Configuration Guide for Ubuntu 24.04

1. Introduction

This guide provides step-by-step instructions for installing and configuring Samba on Ubuntu 24.04. The configuration file will be moved to a custom directory: /etc/calypso/conf/smb.

2. Installation

First, update the package lists and install the samba package.

sudo apt-get update
sudo apt-get install -y samba

3. Configuration File Migration

Create the new configuration directory and copy the default configuration file.

sudo mkdir -p /etc/calypso/conf/smb
sudo cp /etc/samba/smb.conf /etc/calypso/conf/smb/smb.conf

4. Systemd Service Configuration

Create override files for the smbd and nmbd services to point to the new configuration file location.

4.1. smbd Service

sudo mkdir -p /etc/systemd/system/smbd.service.d
sudo bash -c 'cat > /etc/systemd/system/smbd.service.d/override.conf <<EOF
[Service]
ExecStart=
ExecStart=/usr/sbin/smbd --foreground --no-process-group -s /etc/calypso/conf/smb/smb.conf $SMBDOPTIONS
EOF'

4.2. nmbd Service

sudo mkdir -p /etc/systemd/system/nmbd.service.d
sudo bash -c 'cat > /etc/systemd/system/nmbd.service.d/override.conf <<EOF
[Service]
ExecStart=
ExecStart=/usr/sbin/nmbd --foreground --no-process-group -s /etc/calypso/conf/smb/smb.conf $NMBDOPTIONS
EOF'

Reload the systemd daemon to apply the changes.

sudo systemctl daemon-reload

5. Starting and Verifying Services

Restart the Samba services and check their status to ensure they are using the new configuration file.

sudo systemctl restart smbd nmbd
sudo systemctl status smbd nmbd

You should see in the status output that the services are being started with the -s /etc/calypso/conf/smb/smb.conf option.