Revision as of 17:07, 14 September 2022

Todo: This material needs to be re-organized .. as Howtos are smaller articles and tutorials are more detailed document both need to be reordered as independent sections

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, that expects a minimal knowledge from reader to perform actions.

IMPORTANT: contributions on those pages must be complete articles as well as requesting topics to be covered, don't override already made contributions. If you want to request a topic, please add your request in this page's Discussion.

Howtos

Warning: Work in Progress: reorganizing as asked in oldid 16474

Applications

Ansible (Configuration management)

Monitoring

Traffic monitoring
Setting up traffic monitoring using rrdtool (and snmp)
Setting up monitoring using rrdtool (and rrdcollect)
Cacti: traffic analysis and monitoring network (Front-end for rrdtool networking monitor)
Zabbix - the professional complete manager (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)
Ntop (NetFlow collection and analysis using a remote fprobe instance)
Cvechecker (Compare installed packages for Common Vulnerabilities Exposure)
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)
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

Networking applications

Alpine Wall (a new firewall management framework)
Freeradius Active Directory Integration
GNUnet
OpenVPN server (Allowing single users or devices to remotely connect to your network)
OpenVSwitch
Using Alpine on Windows domain with IPSEC isolation
Wireguard

Telephony

Freepbx on Alpine Linux
FreePBX_V3 (FreeSWITCH, Asterisk GUI web acces tool)
Sending SMS using gnokii
Setting up Zaptel/Asterisk on Alpine
Kamailio (SIP Server, formerly OpenSER)

Backup and data migration

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
Migrating data
Rsnapshot - setting up periodic backups

Desktop

Alpine and UEFI
Default applications
Desktop cloud
- EyeOS (Cloud Computing Desktop)
- Nextcloud (Self hostable cloud suite - Dropbox Alternative)
- Oneye (Cloud Computing Desktop - Dropbox Alternative)
- OwnCloud (Installing OwnCloud)
- Seafile: setting up your own private cloud
Desktop environments and Window managers (overall information only)
- Desktop Environments
  - Gnome
  - KDE
  - LXQt
  - MATE
  - Xfce
- Stacking (floating) window managers
  - X11
    - Openbox
  - Wayland
    - LabWC
- Tiling (dynamic) window managers
  - X11
    - AwesomeWM
    - dwm
  - Wayland
    - River
    - Sway
Printer Setup
Remote Desktop Server
Sound Setup
- PipeWire
Suspend on LID close
Xorg Setup

Networking

Bonding - Bond (or aggregate) multiple ethernet interfaces
Bridge - Configuring a network bridge
- Bridge wlan0 to eth0
Configure Networking
How to configure static routes
Modem
- Using HSDPA modem
- Using serial modem
Multi ISP (Dual-ISP setup with load-balancing and automatic failover)
PXE boot
Satellite Internet Connection setup
Wi-Fi
- Connecting to a wireless access point
- How to setup a wireless access point (Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)
Vlan

Other Architectures

Post-Install

CPU frequency scaling
Enable Community repository (Providing additional packages)
Enable Serial Console on Boot
Init System (OpenRC) (Configure a service to automatically boot at next reboot)
- Init System - Multiple Instances of Services
- Init System - Writing Init Scripts
Oracle Java (installation)
Internet Protocol television (IPTV)
Package Management (apk) (How to add/remove packages on your Alpine)
- Package Management - Comparison with other distros
Running glibc programs
Setting up a new user
Upgrading Alpine

Remote Administration

ACF
- ACF - changing passwords
- Generating SSL certs with ACF
- ACF - setup (Configures ACF (webconfiguration/webmin) so you can manage your box through https)
ssh-server setup (Using ssh is a good way to administer your box remotely)
- OpenSSH 2FA (A simple two factor setup for OpenSSH)
OpenVCP (VServer Control Panel)

Server

Hosting services on Alpine (Hosting mail, webservices and other services)
Hosting Web/Email services on Alpine

DNS

DNSCrypt-Proxy Encrypt and authenticate DNS calls from your system
Setting up nsd DNS server
Setting up unbound DNS server
TinyDNS Format

HTTP

Apache
Cherokee
Darkhttpd
Lighttpd
- Lighttpd Advanced security
- Setting Up Lighttpd With FastCGI
Nginx
- Nginx as reverse proxy with acme (letsencrypt)
- Nginx with PHP
Squid Proxy
- Obtaining user information via SNMP (Using squark-auth-snmp as a Squid authentication helper)
- Setting up Explicit Squid Proxy
- Setting up Transparent Squid Proxy (Covers Squid proxy and URL Filtering system)
- SqStat (Script to look at active squid users connections)
Tomcat

Hostable Content

DokuWiki
Drupal (Content Management System (CMS) written in PHP)
Kopano (Microsoft Outlook compatible Groupware)
Mahara (E-portfolio and social networking system)
MediaWiki (Free web-based wiki software application)
Pastebin (Pastebin software application)
Phpizabi (Social Networking Platform)
Statusnet (Microblogging Platform)
WordPress (Web software to create website or blog)

IRC

How To Setup Your Own IRC Network (Using charybdis and atheme-iris)
NgIRCd (Server for Internet Relay Chat/IRC)

Mail

Exim/Dovecot
- Small-Time Email with Exim and Dovecot (A simple configuration for your home network.)
- Setting up dovecot with imap and ssl
relay email to gmail (msmtp, mailx, sendmail
Roundcube (Webmail system)
Setting up postfix with virtual domains
Server protection
- Protecting your email server with Alpine
- Setting up clamsmtp

Other Servers

Chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source
Glpi (Manage inventory of technical resources)
How to setup a Alpine Linux mirror
nfs-server
Odoo
OpenLDAP (Installing and configuring the Alpine package for OpenLDAP)
samba-ad-dc (Active Directory compatible domain controller)
samba-server (standard file sharing)
Setting up Transmission (bittorrent) with Clutch WebUI
UniFi Controller

Software development

Cgit
OsTicket (Ticket system)
Patchwork (Patch review management system)
Redmine (Project management system)
Request Tracker (Ticket system)
Trac (Enhanced wiki and issue tracking system for software development projects)

Storage

Virtualization

Docker
Installing Alpine in a virtual machine
- Install Alpine on VirtualBox
- Install Alpine on VMware ESXi
KVM (Setting up Alpine as a KVM hypervisor)
LXC (Setting up a Linux container in Alpine Linux)
QEMU
Xen
- Xen Dom0 (Setting up Alpine as a dom0 for Xen hypervisor)
- Xen Dom0 on USB or SD
- Xen DomU (paravirtualized)
- Xen LiveCD
- Xen PCI Passthrough

Tutorials