Setting up a Samba server: Difference between revisions

From Alpine Linux
No edit summary
m (1. →‎See also: section started; 2. Amended heading levels)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Installation =
== Installation ==
Install packages:
Install packages:
{{Cmd|# apk add samba samba-common-tools}}
{{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]
    workgroup = WORKGROUP
#to allow symlinks from everywhere
    dos charset = cp850
allow insecure wide links = yes
    unix charset = ISO-8859-1
workgroup = WORKGROUP
    force user = username
dos charset = cp866
unix charset = utf-8
[storage]
force user = username
    browseable = yes
 
    writeable = yes
[storage]
    path = /media/storage
# to follow symlinks
follow symlinks = yes 
# to allow symlinks from outside
wide links = yes     
browseable = yes
writeable = yes
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