Setting up a Samba server: Difference between revisions

From Alpine Linux
m (1. →‎See also: section started; 2. Amended heading levels)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Installation =
== Installation ==
Install packages:
Install packages:
{{Cmd|# apk add samba}}
{{Cmd|# apk add samba}}


= Create a share directory =
=== Create a share directory ===
This will be the directory that's shared to clients. You can create as many of these as you wish.
This will be the directory that's shared to clients. You can create as many of these as you wish.
{{Cmd|# mkdir /media/storage}}
{{Cmd|# mkdir /media/storage}}
{{Cmd|# chmod 0777 /media/storage}}
{{Cmd|# chmod 0777 /media/storage}}


= Create smb.conf =
=== Create smb.conf ===
Alpine provides an example configuration file located at /etc/samba/smb.conf. The following is a simple example to get you up and running.
Alpine provides an example configuration file located at /etc/samba/smb.conf. The following is a simple example to get you up and running.
{{cat|/etc/samba/smb.conf|# /etc/samba/smb.conf
{{cat|/etc/samba/smb.conf|# /etc/samba/smb.conf
<nowiki>
<nowiki>
[global]
[global]
  #to allow symlinks from everywhere
#to allow symlinks from everywhere
  allow insecure wide links = yes  
allow insecure wide links = yes  
  workgroup = WORKGROUP
workgroup = WORKGROUP
  dos charset = cp850
dos charset = cp866
  unix charset = ISO-8859-1
unix charset = utf-8
  force user = username
force user = username
 
[storage]
[storage]
  # to follow symlinks
# to follow symlinks
  follow symlinks = yes   
follow symlinks = yes   
  # to allow symlinks from outside
# to allow symlinks from outside
  wide links = yes       
wide links = yes       
  browseable = yes
browseable = yes
  writeable = yes
writeable = yes
  path = /media/storage
path = /media/storage
</nowiki>
</nowiki>
}}
}}
{{note|For each directory share, you'll need to add a subsection to '''smb.conf'''}}
{{note|For each directory share, you'll need to add a subsection to '''smb.conf'''}}


= Create a system user and Samba user =
=== Create a system user and Samba user ===
Create a user on the system. Create a Samba user. Give both users the same password.
Create a user on the system. Create a Samba user. Give both users the same password.
{{Cmd|# adduser username}}
{{Cmd|# adduser username}}
{{Cmd|# smbpasswd -a username}}
{{Cmd|# smbpasswd -a username}}


= Configure the Samba service =
=== Configure the Samba service ===
Run these two commands to start the service on boot and to start the service right now.
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|# rc-update add samba}}
{{Cmd|# rc-update add samba}}
{{Cmd|# rc-service samba start}}
{{Cmd|# rc-service samba start}}
== See also ==
* [[Setting up a samba-ad-dc]]
* [[Samba Roaming Profiles]]
* [https://wiki.samba.org/ Samba homepage]
* [[Main Page|Helpful links to Samba]]


[[Category:Server]]
[[Category:Server]]
[[Category:Printers]]
[[Category:Printers]]
[[Category:Authentication]]
[[Category:Authentication]]

Latest revision as of 05:40, 6 December 2025

Installation

Install packages:

# apk add samba

Create a share directory

This will be the directory that's shared to clients. You can create as many of these as you wish.

# mkdir /media/storage

# chmod 0777 /media/storage

Create smb.conf

Alpine provides an example configuration file located at /etc/samba/smb.conf. The following is a simple example to get you up and running.

Contents of /etc/samba/smb.conf

# /etc/samba/smb.conf [global] #to allow symlinks from everywhere allow insecure wide links = yes workgroup = WORKGROUP dos charset = cp866 unix charset = utf-8 force user = username [storage] # to follow symlinks follow symlinks = yes # to allow symlinks from outside wide links = yes browseable = yes writeable = yes path = /media/storage
Note: For each directory share, you'll need to add a subsection to smb.conf

Create a system user and Samba user

Create a user on the system. Create a Samba user. Give both users the same password.

# adduser username

# smbpasswd -a username

Configure the Samba service

Run these two commands to start the service on boot and to start the service right now.

# rc-update add samba

# rc-service samba start

See also