Alpine Linux - User contributions [en]

Setting up a samba-ad-dc

2016-10-29T12:35:27Z

Cscracker:

NOTES:
In all examples below, replace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

CAVEATS:
If you run your domain's PDC Emulator on Alpine, Windows members on your domain will have time sync issues. AD Domain time sync requires MS-SNTP signing support, and none of the NTP daemons available on Alpine (chrony, openntpd, busybox) currently support it, only the ntp.org "ntpd" and Windows do.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify your {{Path|/etc/hosts}} file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one at {{Path|/etc/samba/smb.conf}}.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your {{Path|/etc/resolv.conf}} to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /var/lib/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your {{Path|/etc/init.d/samba}} script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
mkdir -p /var/run/samba
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run this command to start the service on boot.
{{Cmd|rc-update add samba}}

Run this command to start the service right now.
{{Cmd|rc-service samba start}}

Setting up a samba-ad-dc

2016-10-29T12:29:50Z

Cscracker:

NOTES:
In all examples below, replace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

CAVEATS:
If you run your domain's PDC Emulator on Alpine, Windows members on your domain will have time sync issues. AD Domain time sync requires MS-SNTP signing support, and none of the NTP daemons available on Alpine (chrony, openntpd, busybox) currently support it, only the ntp.org "ntpd" and Windows do.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify your {{Path|/etc/hosts}} file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one at {{Path|/etc/samba/smb.conf}}.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your {{Path|/etc/resolv.conf}} to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /var/lib/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your {{Path|/etc/init.d/samba}} script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
mkdir -p /var/run/samba
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

Setting up a samba-ad-dc

2016-10-29T12:28:46Z

Cscracker:

NOTES:
In all examples below, replace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

CAVEATS:
If you run your domain's PDC Emulator on Alpine, Windows members on your domain will have time sync issues. AD Domain time sync requires MS-SNTP signing support, and none of the NTP daemons available on Alpine (chrony, openntpd, busybox) currently support it, only the ntp.org "ntpd" and Windows do.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify your {{Path|/etc/hosts}} file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one at {{Path|/etc/samba/smb.conf}}.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your {{Path|/etc/resolv.conf}} to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /var/lib/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your {{Path|/etc/init.d/samba}} script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
mkdir -p /var/run/samba
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

Setting up a samba-ad-dc

2016-10-29T12:28:07Z

Cscracker: Added caveats about NTP and domain time sync.

NOTES:
In all examples below, replace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

CAVEATS:
If you run your domain's PDC Emulator on Alpine, your domain will have time sync issues. AD Domain time sync requires MS-SNTP signing support, and none of the NTP daemons available on Alpine (chrony, openntpd, busybox) currently support it, only the ntp.org "ntpd" and Windows do.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify your {{Path|/etc/hosts}} file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one at {{Path|/etc/samba/smb.conf}}.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your {{Path|/etc/resolv.conf}} to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /var/lib/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your {{Path|/etc/init.d/samba}} script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
mkdir -p /var/run/samba
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

Setting up a samba-ad-dc

2016-04-06T17:58:09Z

Cscracker: /* Install new init script */ Added line to create /var/run/samba if it doesn't exist.

NOTES:
In all examples below, teplace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify your {{Path|/etc/hosts}} file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one at {{Path|/etc/samba/smb.conf}}.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your {{Path|/etc/resolv.conf}} to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /var/lib/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your {{Path|/etc/init.d/samba}} script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
mkdir -p /var/run/samba
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

Tutorials and Howtos

2016-04-01T00:32:35Z

Cscracker: Added descriptions on Samba entries

[[Image:package_edutainment.svg|right|link=]]
{{TOC left}}
'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''

The tutorials are hands-on and the reader is expected to try and achieve the goals described in each step, possibly with the help of a good example. The output in one step is the starting point for the following step.

Howtos are smaller articles explaining how to perform a particular task with Alpine Linux.

We encourage people to send in both complete articles as well as requesting topics to be covered. If you think you have the skills and knowledge to write an Alpine Linux related article please do so on this Wiki. If you want to request a topic, please add your request in this page's [[Talk:Tutorials_and_Howtos|Discussion]].

{{Clear}}
== Storage ==

* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)'' 
** [[Back Up a Flash Memory Installation]] 
** [[Manually editing a existing apkovl]]

* [[Setting up disks manually]] 
* [[Setting up a software RAID array]]

* [[Raid Administration]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up LVM on LUKS]]
* [[Setting up Logical Volumes with LVM]]
** [[Setting up LVM on GPT-labeled disks]]
** [[Installing on GPT LVM]]
* [[Filesystems|Formatting HD/Floppy/Other]] 

* [[Setting up iSCSI]]
** [[iSCSI Raid and Clustered File Systems]]
* [[Setting up NBD]]
* [[High performance SCST iSCSI Target on Linux software Raid]] ''(deprecated)'' 
* [[Linux iSCSI Target (TCM)]]
* [[Disk Replication with DRBD]] 

* [[Burning ISOs]] 
* [[Partitioning and Bootmanagers]]
* [[Migrating data]]
* [[Raspberry Pi|Raspberry Pi (Installation)]]
* [[Create a bootable SDHC from a Mac]]
* [[Alpine on ARM]]

== Networking ==

* [[Configure Networking]]
* [[Connecting to a wireless access point]]
* [[Raspberry Pi 3 - Configuring it as wireless access point -AP Mode]]
* [[Bonding]]
* [[Vlan]]
* [[Bridge]]
* [[OpenVSwitch]]
* [[How to configure static routes]]

* [[Alpine Wall]] - [[How-To Alpine Wall]] - [[Alpine Wall User's Guide]] ''(a new firewall management framework)''

* [[PXE boot]]

* [[Using serial modem]]
* [[Using HSDPA modem]]
* [[Linux Router with VPN on a Raspberry Pi]]
* [[Setting up Satellite Internet Connection]]
* [[Using Alpine on Windows domain with IPSEC isolation]]

* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)'' 
* [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
* [[Setting up a OpenVPN server with Alpine]] ''(Allowing single users or devices to remotely connect to your network)''

* [[Experiences with OpenVPN-client on ALIX.2D3]] 

* [[Generating SSL certs with ACF]] 
* [[Setting up unbound DNS server]]
* [[Setting up nsd DNS server]]
* [[TinyDNS Format]]
* [[Fault Tolerant Routing with Alpine Linux]] 
* [[Freeradius Active Directory Integration]]
* [[Multi_ISP]] ''(Dual-ISP setup with load-balancing and automatic failover)''
* [[OwnCloud]] ''(Installing OwnCloud)''

* [[Apache with php-fpm]]
* [[Seafile: setting up your own private cloud]]

== Post-Install ==


* [[Alpine Linux package management|Package Management (apk)]] ''(How to add/remove packages on your Alpine)''

** [[Comparison with other distros]]
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)''
** [[Back Up a Flash Memory Installation]] 
** [[Manually editing a existing apkovl]]
* [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
** [[Multiple Instances of Services]]

* [[Alpine setup scripts#setup-xorg-base|Setting up Xorg]]
* [[Upgrading Alpine]]


* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''
* [[setup-acf]] ''(Configures ACF (webconfiguration) so you can manage your box through https)''
* [[Changing passwords for ACF|Changing passwords]]
* [[Ansible]] ''(Configuration management)''

* [[Enable Serial Console on Boot]]

* [[How to get regular stuff working]] ''some notes on need-to-know topics''

== Virtualization==

* [[Xen Dom0]] ''(Setting up Alpine as a dom0 for Xen hypervisor)''
* [[Xen Dom0 on USB or SD]]
* [[Create Alpine Linux PV DomU]]
* [[Xen PCI Passthrough]]
* [[Xen LiveCD]]
* [[qemu]]
* [[LXC]] ''(Setting up a Linux container in Alpine Linux)''
* [[Docker]]

== Desktop Environment ==

* [[Awesome(wm) Setup]]
* [[EyeOS]] ''(Cloud Computing Desktop)''
* [[Gnome Setup]]
* [[MATE|MATE Setup]]
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
* [[Owncloud]] ''(Cloud Computing Desktop - Dropbox Alternative)''
** (to be merged with [[OwnCloud]] ''(Your personal Cloud for storing and sharing your data on-line)'')
* [[Remote Desktop Server]]
* [[Suspend on LID close]]
* [[XFCE Setup]] and [[Xfce Desktop|Desktop Ideas]]
* [[Installing Adobe flash player for Firefox]]

== Applications ==

=== Telephony ===
* [[Setting up Zaptel/Asterisk on Alpine]]
** [[Setting up Streaming an Asterisk Channel]]
* [[Freepbx on Alpine Linux]]
* [[FreePBX_V3]] ''(FreeSWITCH, Asterisk GUI web acces tool)''
* [[2600hz]] ''(FreeSWITCH, Asterisk GUI web access tool)''
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''

=== Mail ===
* [[Hosting services on Alpine]] ''(Hosting mail, webservices and other services)''
** [[Hosting Web/Email services on Alpine]]
* [[ISP Mail Server HowTo]] 
** [[ISP Mail Server Upgrade 2.x]]
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
* [[Roundcube]] ''(Webmail system)''
* [[Setting up postfix with virtual domains]]
* [[Protecting your email server with Alpine]]
* [[Setting up clamsmtp]]
* [[Setting up dovecot with imap and ssl]]

=== HTTP ===
* [[Lighttpd]]
** [[Lighttpd Https access]]
** [[Setting Up Lighttpd with PHP]]
** [[Setting Up Lighttpd With FastCGI]]
* [[Cherokee]]
* [[Nginx]]
* [[Apache]]
** [[Setting Up Apache with PHP]]
** [[Apache authentication: NTLM Single Signon]]

* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)'' 

* [[Setting up Transparent Squid Proxy]] 
** [[SqStat]] ''(Script to look at active squid users connections)''
** [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
* [[Setting up Explicit Squid Proxy]]

* [[Drupal]] ''(Content Management System (CMS) written in PHP)''
* [[WordPress]] ''(Web software to create website or blog)''
* [[MediaWiki]] ''(Free web-based wiki software application)''
* [[DokuWiki]]
* [[Darkhttpd]]

=== Other Servers ===
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''

* [[Setting up a nfs-server]]
* [[Setting up a samba-server]] ''(standard file sharing)''
* [[Setting up a samba-ad-dc]] ''(Active Directory compatible domain controller)''
* [[Phpizabi]] ''(Social Networking Platform)''
* [[Statusnet]] ''(Microblogging Platform)''
* [[Pastebin]] ''(Pastebin software application)''
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]

* [[Patchwork]] ''(Patch review management system)''
* [[Redmine]] ''(Project management system)''
* [[Request-Tracker]] ''(Ticket system)''
* [[OsTicket]] ''(Ticket system)''
* [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''

* [[Cgit]]
** [[Setting up a git repository server with gitolite and cgit]] 
* [[Roundcube]] ''(Webmail system)''
* [[Glpi]] ''(Manage inventory of technical resources)''

* [[How to setup a Alpine Linux mirror]]
* [[Cups]]
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''
* [[OpenVCP]] ''(VServer Control Panel)''
* [[Mahara]] ''(E-portfolio and social networking system)''
* [[Chrony and GPSD | Using chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
* [[Sending SMS using gnokii]]

=== Monitoring ===
* Setting up [[collectd]]
* [[Traffic monitoring]] 
* [[Setting up traffic monitoring using rrdtool (and snmp)]] 
* [[Setting up monitoring using rrdtool (and rrdcollect)]]
* [[Setting up Cacti|Cacti]] ''(Front-end for rrdtool networking monitor)''
* [[Setting up Zabbix|Zabbix]] ''(Monitor and track the status of network services and hardware)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
** [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)'' 
* [[Setting up Smokeping|Smokeping]] ''(Network latency monitoring)'' 
** [[Setting up MRTG and Smokeping to Monitor Bandwidth Usage and Network Latency]]
* [[Setting Up Fprobe And Ntop|Ntop]] ''(NetFlow collection and analysis using a remote fprobe instance)'' 
* [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' 

* [[IP Accounting]] 
* [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
* [[SqStat]] ''(Script to look at active squid users connections)''

* [[Piwik]] ''(A real time web analytics software program)''
* [[Awstats]] ''(Free log file analyzer)''
* [[Intrusion Detection using Snort]]
** [[Intrusion Detection using Snort, Sguil, Barnyard and more]]
* [[Dglog]] ''(Log analyzer for the web content filter DansGuardian)''

* [[Webmin]] ''(A web-based interface for Linux system)''
* [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)''
* [[PhpMyAdmin]] ''(Web-based administration tool for MYSQL)''
* [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)''
* [[Linfo]]

* [[Setting up lm_sensors]]

* [[ZoneMinder video camera security and surveillance]]

== Misc ==

* [[:Category:Shell]]
* [[:Category:Programming]]
* [[Running glibc programs]]
* [[:Category:Drivers]]
* [[:Category:Multimedia]]
* [[Kernel Modesetting]]

== Complete Solutions ==
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[High performance SCST iSCSI Target on Linux software Raid]]
* [[Fault Tolerant Routing with Alpine Linux]]
* [[Experiences with OpenVPN-client on ALIX.2D3]]
* [[Building a cloud with Alpine Linux]]

* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
** [[ISP Mail Server Upgrade 2.x]]
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
* [[Streaming Security Camera Video with VLC]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small_Office_Services]]
* [[RPI Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''

Setting up a samba-ad-dc

2016-04-01T00:27:35Z

Cscracker: more formatting, fixed typo, cleaned up file path names

NOTES:
In all examples below, teplace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify your {{Path|/etc/hosts}} file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one at {{Path|/etc/samba/smb.conf}}.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your {{Path|/etc/resolv.conf}} to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /var/lib/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your {{Path|/etc/init.d/samba}} script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

Setting up a samba-ad-dc

2016-04-01T00:22:09Z

Cscracker: fix formatting

NOTES:
In all examples below, teplace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify the hosts file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your /etc/resolv.conf to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /usr/local/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your /etc/init.d/samba script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

Tutorials and Howtos

2016-04-01T00:21:15Z

Cscracker: Adding howto for Samba Domain Controller

[[Image:package_edutainment.svg|right|link=]]
{{TOC left}}
'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''

The tutorials are hands-on and the reader is expected to try and achieve the goals described in each step, possibly with the help of a good example. The output in one step is the starting point for the following step.

Howtos are smaller articles explaining how to perform a particular task with Alpine Linux.

We encourage people to send in both complete articles as well as requesting topics to be covered. If you think you have the skills and knowledge to write an Alpine Linux related article please do so on this Wiki. If you want to request a topic, please add your request in this page's [[Talk:Tutorials_and_Howtos|Discussion]].

{{Clear}}
== Storage ==

* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)'' 
** [[Back Up a Flash Memory Installation]] 
** [[Manually editing a existing apkovl]]

* [[Setting up disks manually]] 
* [[Setting up a software RAID array]]

* [[Raid Administration]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up LVM on LUKS]]
* [[Setting up Logical Volumes with LVM]]
** [[Setting up LVM on GPT-labeled disks]]
** [[Installing on GPT LVM]]
* [[Filesystems|Formatting HD/Floppy/Other]] 

* [[Setting up iSCSI]]
** [[iSCSI Raid and Clustered File Systems]]
* [[Setting up NBD]]
* [[High performance SCST iSCSI Target on Linux software Raid]] ''(deprecated)'' 
* [[Linux iSCSI Target (TCM)]]
* [[Disk Replication with DRBD]] 

* [[Burning ISOs]] 
* [[Partitioning and Bootmanagers]]
* [[Migrating data]]
* [[Raspberry Pi|Raspberry Pi (Installation)]]
* [[Create a bootable SDHC from a Mac]]
* [[Alpine on ARM]]

== Networking ==

* [[Configure Networking]]
* [[Connecting to a wireless access point]]
* [[Raspberry Pi 3 - Configuring it as wireless access point -AP Mode]]
* [[Bonding]]
* [[Vlan]]
* [[Bridge]]
* [[OpenVSwitch]]
* [[How to configure static routes]]

* [[Alpine Wall]] - [[How-To Alpine Wall]] - [[Alpine Wall User's Guide]] ''(a new firewall management framework)''

* [[PXE boot]]

* [[Using serial modem]]
* [[Using HSDPA modem]]
* [[Linux Router with VPN on a Raspberry Pi]]
* [[Setting up Satellite Internet Connection]]
* [[Using Alpine on Windows domain with IPSEC isolation]]

* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)'' 
* [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
* [[Setting up a OpenVPN server with Alpine]] ''(Allowing single users or devices to remotely connect to your network)''

* [[Experiences with OpenVPN-client on ALIX.2D3]] 

* [[Generating SSL certs with ACF]] 
* [[Setting up unbound DNS server]]
* [[Setting up nsd DNS server]]
* [[TinyDNS Format]]
* [[Fault Tolerant Routing with Alpine Linux]] 
* [[Freeradius Active Directory Integration]]
* [[Multi_ISP]] ''(Dual-ISP setup with load-balancing and automatic failover)''
* [[OwnCloud]] ''(Installing OwnCloud)''

* [[Apache with php-fpm]]
* [[Seafile: setting up your own private cloud]]

== Post-Install ==


* [[Alpine Linux package management|Package Management (apk)]] ''(How to add/remove packages on your Alpine)''

** [[Comparison with other distros]]
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)''
** [[Back Up a Flash Memory Installation]] 
** [[Manually editing a existing apkovl]]
* [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
** [[Multiple Instances of Services]]

* [[Alpine setup scripts#setup-xorg-base|Setting up Xorg]]
* [[Upgrading Alpine]]


* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''
* [[setup-acf]] ''(Configures ACF (webconfiguration) so you can manage your box through https)''
* [[Changing passwords for ACF|Changing passwords]]
* [[Ansible]] ''(Configuration management)''

* [[Enable Serial Console on Boot]]

* [[How to get regular stuff working]] ''some notes on need-to-know topics''

== Virtualization==

* [[Xen Dom0]] ''(Setting up Alpine as a dom0 for Xen hypervisor)''
* [[Xen Dom0 on USB or SD]]
* [[Create Alpine Linux PV DomU]]
* [[Xen PCI Passthrough]]
* [[Xen LiveCD]]
* [[qemu]]
* [[LXC]] ''(Setting up a Linux container in Alpine Linux)''
* [[Docker]]

== Desktop Environment ==

* [[Awesome(wm) Setup]]
* [[EyeOS]] ''(Cloud Computing Desktop)''
* [[Gnome Setup]]
* [[MATE|MATE Setup]]
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
* [[Owncloud]] ''(Cloud Computing Desktop - Dropbox Alternative)''
** (to be merged with [[OwnCloud]] ''(Your personal Cloud for storing and sharing your data on-line)'')
* [[Remote Desktop Server]]
* [[Suspend on LID close]]
* [[XFCE Setup]] and [[Xfce Desktop|Desktop Ideas]]
* [[Installing Adobe flash player for Firefox]]

== Applications ==

=== Telephony ===
* [[Setting up Zaptel/Asterisk on Alpine]]
** [[Setting up Streaming an Asterisk Channel]]
* [[Freepbx on Alpine Linux]]
* [[FreePBX_V3]] ''(FreeSWITCH, Asterisk GUI web acces tool)''
* [[2600hz]] ''(FreeSWITCH, Asterisk GUI web access tool)''
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''

=== Mail ===
* [[Hosting services on Alpine]] ''(Hosting mail, webservices and other services)''
** [[Hosting Web/Email services on Alpine]]
* [[ISP Mail Server HowTo]] 
** [[ISP Mail Server Upgrade 2.x]]
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
* [[Roundcube]] ''(Webmail system)''
* [[Setting up postfix with virtual domains]]
* [[Protecting your email server with Alpine]]
* [[Setting up clamsmtp]]
* [[Setting up dovecot with imap and ssl]]

=== HTTP ===
* [[Lighttpd]]
** [[Lighttpd Https access]]
** [[Setting Up Lighttpd with PHP]]
** [[Setting Up Lighttpd With FastCGI]]
* [[Cherokee]]
* [[Nginx]]
* [[Apache]]
** [[Setting Up Apache with PHP]]
** [[Apache authentication: NTLM Single Signon]]

* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)'' 

* [[Setting up Transparent Squid Proxy]] 
** [[SqStat]] ''(Script to look at active squid users connections)''
** [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
* [[Setting up Explicit Squid Proxy]]

* [[Drupal]] ''(Content Management System (CMS) written in PHP)''
* [[WordPress]] ''(Web software to create website or blog)''
* [[MediaWiki]] ''(Free web-based wiki software application)''
* [[DokuWiki]]
* [[Darkhttpd]]

=== Other Servers ===
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''

* [[Setting up a nfs-server]]
* [[Setting up a samba-server]]
* [[Setting up a samba-ad-dc]]
* [[Phpizabi]] ''(Social Networking Platform)''
* [[Statusnet]] ''(Microblogging Platform)''
* [[Pastebin]] ''(Pastebin software application)''
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]

* [[Patchwork]] ''(Patch review management system)''
* [[Redmine]] ''(Project management system)''
* [[Request-Tracker]] ''(Ticket system)''
* [[OsTicket]] ''(Ticket system)''
* [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''

* [[Cgit]]
** [[Setting up a git repository server with gitolite and cgit]] 
* [[Roundcube]] ''(Webmail system)''
* [[Glpi]] ''(Manage inventory of technical resources)''

* [[How to setup a Alpine Linux mirror]]
* [[Cups]]
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''
* [[OpenVCP]] ''(VServer Control Panel)''
* [[Mahara]] ''(E-portfolio and social networking system)''
* [[Chrony and GPSD | Using chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
* [[Sending SMS using gnokii]]

=== Monitoring ===
* Setting up [[collectd]]
* [[Traffic monitoring]] 
* [[Setting up traffic monitoring using rrdtool (and snmp)]] 
* [[Setting up monitoring using rrdtool (and rrdcollect)]]
* [[Setting up Cacti|Cacti]] ''(Front-end for rrdtool networking monitor)''
* [[Setting up Zabbix|Zabbix]] ''(Monitor and track the status of network services and hardware)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
** [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)'' 
* [[Setting up Smokeping|Smokeping]] ''(Network latency monitoring)'' 
** [[Setting up MRTG and Smokeping to Monitor Bandwidth Usage and Network Latency]]
* [[Setting Up Fprobe And Ntop|Ntop]] ''(NetFlow collection and analysis using a remote fprobe instance)'' 
* [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' 

* [[IP Accounting]] 
* [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
* [[SqStat]] ''(Script to look at active squid users connections)''

* [[Piwik]] ''(A real time web analytics software program)''
* [[Awstats]] ''(Free log file analyzer)''
* [[Intrusion Detection using Snort]]
** [[Intrusion Detection using Snort, Sguil, Barnyard and more]]
* [[Dglog]] ''(Log analyzer for the web content filter DansGuardian)''

* [[Webmin]] ''(A web-based interface for Linux system)''
* [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)''
* [[PhpMyAdmin]] ''(Web-based administration tool for MYSQL)''
* [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)''
* [[Linfo]]

* [[Setting up lm_sensors]]

* [[ZoneMinder video camera security and surveillance]]

== Misc ==

* [[:Category:Shell]]
* [[:Category:Programming]]
* [[Running glibc programs]]
* [[:Category:Drivers]]
* [[:Category:Multimedia]]
* [[Kernel Modesetting]]

== Complete Solutions ==
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[High performance SCST iSCSI Target on Linux software Raid]]
* [[Fault Tolerant Routing with Alpine Linux]]
* [[Experiences with OpenVPN-client on ALIX.2D3]]
* [[Building a cloud with Alpine Linux]]

* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
** [[ISP Mail Server Upgrade 2.x]]
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
* [[Streaming Security Camera Video with VLC]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small_Office_Services]]
* [[RPI Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''

Setting up a samba-ad-dc

2016-04-01T00:21:05Z

Cscracker: Create page, basic Samba Active Directory creation.

NOTES:
In all examples below, teplace EXAMPLE with your NetBIOS domain name in caps, example.com with your DNS domain name, HOSTNAME with your system's host name in caps, and hostname with your system's host name.

Refer to the [https://wiki.samba.org/index.php/Active_Directory_Naming_FAQ Active Directory naming FAQ] before choosing your domain name.

= Installation =
Install packages:
{{Cmd|apk add samba-dc krb5 }}

= Edit hosts file =
You need to modify the hosts file to look similar to this.

127.0.0.1 localhost.localdomain localhost
10.1.1.10 hostname.example.com hostname

= Create smb.conf =
Alpine doesn't provide an example configuration file in the package so you'll need to create one.

[global]
server role = domain controller
workgroup = EXAMPLE
realm = example.com
netbios name = HOSTNAME
passdb backend = samba4
idmap_ldb:use rfc2307 = yes

[netlogon]
path = /var/lib/samba/sysvol/example.com/scripts
read only = No

[sysvol]
path = /var/lib/samba/sysvol
read only = No

= Provision your Samba domain =
Answer the questions with your domain information:
{{Cmd|samba-tool domain provision --use-rfc2307 --interactive}}
Use the SAMBA_INTERNAL DNS option.
When asked for a forwarder IP, choose your internet DNS server. You can use your ISP or other public services (like Google) here.

= Configure resolv.conf =
Modify your /etc/resolv.conf to include your new domain as a search domain and point to itself as the first nameserver.

search example.com
nameserver 10.1.1.10

= Configure Kerberos =
You need to replace krb5.conf with a link to the one generated by samba.
{{Cmd|ln -sf /usr/local/samba/private/krb5.conf /etc/krb5.conf}}

= Install new init script =
As of 3/31/2016 and Alpine 3.3.3, the included samba init script doesn't support starting it as a domain controller. Modify your /etc/init.d/samba script like the one below.

#!/sbin/openrc-run

extra_started_commands="reload"

DAEMON=${SVCNAME#samba.}
SERVER_ROLE=`samba-tool testparm --parameter-name="server role" 2>/dev/null | tail -1`
if [ "$SERVER_ROLE" = "active directory domain controller" ]; then
daemon_list="samba"
elif [ "$DAEMON" != "samba" ]; then
daemon_list=$DAEMON
fi

depend() {
need net
after firewall
}

start_samba() {
start-stop-daemon --start --quiet --exec /usr/sbin/samba --
}

stop_samba() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/samba.pid
}

start_smbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/smbd -- \
${smbd_options:-"-D"}
}

stop_smbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/smbd.pid
}

start_nmbd() {
start-stop-daemon --start --quiet --exec /usr/sbin/nmbd -- \
${nmbd_options:-"-D"}
}

stop_nmbd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/nmbd.pid
}

start_winbindd() {
start-stop-daemon --start --quiet --exec /usr/sbin/winbindd -- \
$winbindd_options
}

stop_winbindd() {
start-stop-daemon --stop --quiet --pidfile /var/run/samba/winbindd.pid
}

start() {
for i in $daemon_list; do
ebegin "Starting $i"
start_$i
eend $?
done
}

stop() {
for i in $daemon_list; do
ebegin "Stopping $i"
stop_$i
eend $?
done
}

reload() {
for i in $daemon_list; do
ebegin "Reloading $i"
killall -HUP $i
eend $?
done
}

= Configure the Samba service =
Run these two commands to start the service on boot and to start the service right now.
{{Cmd|rc-update add samba}}
{{Cmd|rc-service samba start}}

ZoneMinder video camera security and surveillance

2015-12-06T22:48:53Z

Cscracker: Added rc-update commands to start on boot

ZoneMinder usually runs with apache, but in this short howto we use lighttpd.

First add the needed packages to our system

apk add zoneminder mysql mysql-client lighttpd php-fpm php-pdo php-pdo_mysql

Initialize mysql database

/etc/init.d/mariadb setup

set root password for mysql as instructed by mysql setup

/usr/bin/mysqladmin -u root password 'your_secure_root_mysql_password'

Create a zoneminder MySQL database and user

mysql> create database zm;

mysql> CREATE USER zm@localhost IDENTIFIED BY 'your_zm_password_as_set_in_config';

mysql> grant CREATE, INSERT, SELECT, DELETE, UPDATE, DROP on zm.* to zm@localhost;

We are running lighttpd so lets run php-fpm as lighttpd user/group

vim /etc/php/php-fpm.conf

Which should look like:

; Unix user/group of processes
; Note: The user is mandatory. If the group is not set, the default user's group
; will be used.
;user = nobody
;group = nobody
user = lighttpd
group = lighttpd

Enable the php cgi fpm config in lighttpd.conf

vim /etc/lighttpd/lighttpd.conf

Go down to the includes section, it should look like:
# {{{ includes
include "mime-types.conf"
# uncomment for cgi support
include "mod_cgi.conf"
# uncomment for php/fastcgi support
# include "mod_fastcgi.conf"
# uncomment for php/fastcgi fpm support
include "mod_fastcgi_fpm.conf"

# }}}

Edit lighttpd cgi config and add old style cgi support by adding to cgi.assign

vim /etc/lighttpd/mod_cgi.conf

which should look like

cgi.assign = (
"" => "",
".pl" => "/usr/bin/perl",
".cgi" => "/usr/bin/perl"
)

start php-fpm

/etc/init.d/php-fpm start

start lighttpd

/etc/init.d/lighttpd start

Set the MySQL hostname, username, password.

Change the ZoneMinder user (ZM_WEB_USER) and group (ZM_WEB_GROUP) to lighttpd

And set ZM_SERVER_HOST to your zoneMinder hostname/ipaddress

vim /etc/zm.conf

Which should look like:

# Username and group that web daemon (httpd/apache) runs as
ZM_WEB_USER=lighttpd
ZM_WEB_GROUP=lighttpd

# ZoneMinder database type: so far only mysql is supported
ZM_DB_TYPE=mysql

# ZoneMinder database hostname or ip address
ZM_DB_HOST=localhost

# ZoneMinder database name
ZM_DB_NAME=zm

# ZoneMinder database user
ZM_DB_USER=zm

# ZoneMinder database password
ZM_DB_PASS=your_zm_password_as_set_in_config

# Host of this machine
ZM_SERVER_HOST=yourserver

Change ownership of zm.conf to lighttpd

chown lighttpd.lighttpd /etc/zm.conf

Initialize the zoneminder database

/etc/init.d/zoneminder setup

Start zoneminder

/etc/init.d/zoneminder start

Profit!

To access zoneminder, browse to http://yourserver/zm/

To make it start automatically on boot:

rc-update add lighttpd default
rc-update add mariadb default
rc-update add php-fpm default
rc-update add zoneminder default

ZoneMinder video camera security and surveillance

2015-11-27T23:08:11Z

Cscracker: Added more details, consolidated lighttpd configuration steps

ZoneMinder video camera security and surveillance

2015-08-22T02:45:06Z

Cscracker: No longer requires edge; Added missing required packages; Replaced mysql with mariadb as requred; Added DROP privilege as required by setup step; Added required permission change to use lighttpd; Added missing setup step

ZoneMinder video camera security and surveillance

2015-08-22T02:34:24Z

Cscracker: Added missing required packages

Currently zoneminder has to be installed from edge, make sure you have edge as pinned repo when you use stable.

ZoneMinder usually runs with apache, but in this short howto we use lighttpd.

First add the needed packages to our system

apk add zoneminder@edge mysql mysql-client lighttpd php-fpm php-pdo php-pdo_mysql

Initialize mysql database

/etc/init.d/mysql setup

set root password for mysql as instructed by mysql setup

Create a zoneminder MySQL database and user

mysql> create database zm;

mysql> CREATE USER zm@localhost IDENTIFIED BY 'your_zm_password_as_set_in_config';

mysql> grant CREATE, INSERT, SELECT, DELETE, UPDATE on zm.* to zm@localhost;

We are running lighttpd so lets run php-fpm as lighttpd user/group

vim /etc/php/php-fpm.conf

uncomment the php cgi fpm config in lighttpd.conf

vim /etc/lighttpd/lighttpd.conf

start php-fpm

/etc/init.d/php-fpm start

start lighttpd

/etc/init.d/lighttpd start

Set the MySQL hostname, username, password.

Change the ZoneMinder user (ZM_WEB_USER) and group (ZM_WEB_GROUP) to lighttpd

And set ZM_SERVER_HOST to your zoneMinder hostname/ipaddress

vim /etc/zm.conf

Edit lighttpd cgi config and add old style cgi support by adding to cgi.assign

vim /etc/lighttpd/mod_cgi.conf

which should look like

cgi.assign = (
"" => "",
".pl" => "/usr/bin/perl",
".cgi" => "/usr/bin/perl"
)

Edit lighttpd.conf and uncomment mod_cgi.conf

vim /etc/lighttpd/lighttpd.conf

Start zoneminder

/etc/init.d/zoneminder start

Profit!

ZoneMinder video camera security and surveillance

2015-08-22T02:27:37Z

Cscracker: Added required permission change to use lighttpd

Currently zoneminder has to be installed from edge, make sure you have edge as pinned repo when you use stable.

ZoneMinder usually runs with apache, but in this short howto we use lighttpd.

First add the needed packages to our system

apk add zoneminder@edge mysql mysql-client lighttpd php-fpm

Initialize mysql database

/etc/init.d/mysql setup

set root password for mysql as instructed by mysql setup

Create a zoneminder MySQL database and user

mysql> create database zm;

mysql> CREATE USER zm@localhost IDENTIFIED BY 'your_zm_password_as_set_in_config';

mysql> grant CREATE, INSERT, SELECT, DELETE, UPDATE on zm.* to zm@localhost;

We are running lighttpd so lets run php-fpm as lighttpd user/group

vim /etc/php/php-fpm.conf

uncomment the php cgi fpm config in lighttpd.conf

vim /etc/lighttpd/lighttpd.conf

start php-fpm

/etc/init.d/php-fpm start

start lighttpd

/etc/init.d/lighttpd start

Set the MySQL hostname, username, password.

Change the ZoneMinder user (ZM_WEB_USER) and group (ZM_WEB_GROUP) to lighttpd

And set ZM_SERVER_HOST to your zoneMinder hostname/ipaddress

vim /etc/zm.conf

Change owner and group-owner of zm.conf to lighttpd

chown lighttpd.lighttpd /etc/zm.conf

Edit lighttpd cgi config and add old style cgi support by adding to cgi.assign

vim /etc/lighttpd/mod_cgi.conf

which should look like

cgi.assign = (
"" => "",
".pl" => "/usr/bin/perl",
".cgi" => "/usr/bin/perl"
)

Edit lighttpd.conf and uncomment mod_cgi.conf

vim /etc/lighttpd/lighttpd.conf

Start zoneminder

/etc/init.d/zoneminder start

Profit!

ZoneMinder video camera security and surveillance

2015-08-22T02:25:01Z

Cscracker: No longer requires edge; Replaced mysql with mariadb as requred; Added DROP privilege as required by setup step; Added missing setup step

ZoneMinder usually runs with apache, but in this short howto we use lighttpd.

First add the needed packages to our system

apk add zoneminder mysql mysql-client lighttpd php-fpm

Initialize mysql database

/etc/init.d/mariadb setup

set root password for mysql as instructed by mysql setup

Create a zoneminder MySQL database and user

mysql> create database zm;

mysql> CREATE USER zm@localhost IDENTIFIED BY 'your_zm_password_as_set_in_config';

mysql> grant CREATE, INSERT, SELECT, DELETE, UPDATE, DROP on zm.* to zm@localhost;

We are running lighttpd so lets run php-fpm as lighttpd user/group

vim /etc/php/php-fpm.conf

uncomment the php cgi fpm config in lighttpd.conf

vim /etc/lighttpd/lighttpd.conf

start php-fpm

/etc/init.d/php-fpm start

start lighttpd

/etc/init.d/lighttpd start

Set the MySQL hostname, username, password.

Change the ZoneMinder user (ZM_WEB_USER) and group (ZM_WEB_GROUP) to lighttpd

And set ZM_SERVER_HOST to your zoneMinder hostname/ipaddress

vim /etc/zm.conf

Edit lighttpd cgi config and add old style cgi support by adding to cgi.assign

vim /etc/lighttpd/mod_cgi.conf

which should look like

cgi.assign = (
"" => "",
".pl" => "/usr/bin/perl",
".cgi" => "/usr/bin/perl"
)

Edit lighttpd.conf and uncomment mod_cgi.conf

vim /etc/lighttpd/lighttpd.conf

Initialize the zoneminder database

/etc/init.d/zoneminder setup

Start zoneminder

/etc/init.d/zoneminder start

Profit!