|
|
| Line 1: |
Line 1: |
| {{Todo|This material has been re-organized..., but grouping should be checked: '''Howtos are smaller articles''' and '''tutorials are more detailed document'''}}
| |
|
| |
| [[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, 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 [[Talk:Tutorials_and_Howtos|Discussion]].
| |
|
| |
|
| |
| {{Clear}}
| |
|
| |
| = Howtos =
| |
|
| |
| == Applications ==
| |
|
| |
| === Miscellaneous ===
| |
|
| |
| * [[Ansible]] ''(Configuration management)''
| |
|
| |
| === Monitoring ===
| |
|
| |
| * [[Awstats]] ''(Free log file analyzer)''
| |
| * [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)''
| |
| * [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' <!-- Monitoring and Security -->
| |
| * [[Linfo]]
| |
| * [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' <!-- Networking and Server, <== Using squark-auth-snmp -->
| |
| * [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)''
| |
| * [[Matomo]] ''(A real time web analytics software program)''
| |
| * [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' <!-- draft, solution, Networking and Monitoring and Server -->
| |
| ** [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)'' <!-- Networking and Monitoring -->
| |
| * [[Setting Up Fprobe And Ntop|Ntop]] ''(NetFlow collection and analysis using a remote fprobe instance; for alpine 3.10-3.12 only)'' <!-- Networking and Monitoring -->
| |
| * [[Setting up lm_sensors]]
| |
| * [[SqStat]] ''(Script to look at active squid users connections)''
| |
| * [[Traffic monitoring]] <!-- Networking and Monitoring -->
| |
| ** [[Setting up monitoring using rrdtool (and rrdcollect)]]
| |
| ** [[Setting up traffic monitoring using rrdtool (and snmp)]] <!-- Monitoring -->
| |
| * [[Zabbix|Zabbix - the professional complete manager]] ''(Monitor and track the status of network services and hardware)''
| |
| * [[ZoneMinder video camera security and surveillance]]
| |
|
| |
| === Networking ===
| |
|
| |
| * Alpine Wall ''(a new firewall management framework)''
| |
| ** [[Alpine Wall]]
| |
| ** [https://git.alpinelinux.org/awall/about/ Alpine Wall User's Guide]
| |
| ** [[How-To Alpine Wall]]
| |
| * [[Freeradius Active Directory Integration]]
| |
| * [[GNUnet]]
| |
| * [[Setting up a OpenVPN server|OpenVPN server]] ''(Allowing single users or devices to remotely connect to your network)''
| |
| * [[OpenVSwitch]]
| |
| * [[Using Alpine on Windows domain with IPSEC isolation]]
| |
| * [[Configure a Wireguard interface (wg)|Wireguard]]
| |
|
| |
| === Telephony ===
| |
|
| |
| * [[FreePBX|FreePBX on Alpine Linux]]
| |
| * [[Setting up Zaptel/Asterisk on Alpine]]
| |
| * [[Kamailio]] ''(SIP Server, formerly OpenSER)''
| |
|
| |
| == Backup and data migration ==
| |
|
| |
| * [[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]]
| |
| * [[Migrating data]]
| |
| * [[Rsnapshot]] - setting up periodic backups
| |
|
| |
| == Desktop ==
| |
|
| |
| * [[Alpine and UEFI]]
| |
| * [[Default applications]]
| |
| * Desktop cloud
| |
| ** [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
| |
| * [[Desktop environments and Window managers]] (overall information only)
| |
| * [[Printer Setup]]
| |
| * [[Remote Desktop Server]]
| |
| * Sound Systems
| |
| ** [[ALSA]]
| |
| ** [[PipeWire]]
| |
| ** [[PulseAudio]]
| |
| * [[Configure action when power-button is pressed]]
| |
| * [[Suspend on LID close]]
| |
| * [[Alpine setup scripts#setup-xorg-base|Xorg Setup]]
| |
| * Wayland compositors:
| |
| ** [[Sway]]
| |
| ** [[River]]
| |
| ** [[LabWC]]
| |
|
| |
| == Networking ==
| |
|
| |
| * [[Bluetooth]] - Instructions for installing and configuring Bluetooth
| |
| * [[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]]
| |
| * [[mDNS]] - Howto implement multicast DNS resolution in Alpine.
| |
| * [[Multi ISP]] ''(Dual-ISP setup with load-balancing and automatic failover)''
| |
| * [[PXE boot]]
| |
| * Wi-Fi
| |
| ** [[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 ==
| |
|
| |
| === ARM ===
| |
|
| |
| * [[Alpine on ARM]]
| |
|
| |
| ==== Raspberry Pi ==== | | ==== Raspberry Pi ==== |
|
| |
|
| Line 122: |
Line 6: |
| * [[Linux Router with VPN on a Raspberry Pi (IPv6)|Raspberry Pi - Router with VPN (IPv6)]] | | * [[Linux Router with VPN on a Raspberry Pi (IPv6)|Raspberry Pi - Router with VPN (IPv6)]] |
| * [[Classic install or sys mode on Raspberry Pi|Raspberry Pi - Sys mode install]] | | * [[Classic install or sys mode on Raspberry Pi|Raspberry Pi - Sys mode install]] |
| | * [[Raspberry Pi LVM on LUKS|Raspberry Pi - Sys mode install - LVM on LUKS]] |
| * [[RPI Video Receiver|Raspberry Pi - Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)'' | | * [[RPI Video Receiver|Raspberry Pi - Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)'' |
| * [[Raspberry Pi 3 - Browser Client]] - kiosk or digital sign | | * [[Raspberry Pi 3 - Browser Client]] - kiosk or digital sign |
| Line 128: |
Line 13: |
| * [[Raspberry Pi 4 - Persistent system acting as a NAS and Time Machine]] | | * [[Raspberry Pi 4 - Persistent system acting as a NAS and Time Machine]] |
| * [[How to set up Alpine as a wireless router|Raspberry Pi Zero W - Wireless router]] ''(Setting up a firewalled, Wireless AP with wired network on a Pi Zero W)'' | | * [[How to set up Alpine as a wireless router|Raspberry Pi Zero W - Wireless router]] ''(Setting up a firewalled, Wireless AP with wired network on a Pi Zero W)'' |
|
| |
| === IBM Z (IBM z Systems) ===
| |
|
| |
| * [[s390x|s390x - Installation]]
| |
|
| |
| === PowerPC ===
| |
|
| |
| * [[Ppc64le|Powerpc64le - Installation]]
| |
|
| |
| == Post-Install ==
| |
|
| |
| * [[CPU frequency scaling]]
| |
| * [[Repositories#Enabling_the_community_repository|Enable Community repository]] ''(Providing additional packages)''
| |
| * [[Enable Serial Console on Boot]]
| |
| * [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
| |
| ** [[Multiple Instances of Services|Init System - Multiple Instances of Services]]
| |
| ** [[Writing Init Scripts|Init System - Writing Init Scripts]]
| |
| * [[Installing Oracle Java|Oracle Java (installation)]]
| |
| * [[IGMPproxy]]
| |
| * [[Alpine Package Keeper|Package Management (apk)]] ''(How to add/remove packages on your Alpine)''
| |
| ** [[Comparison with other distros|Package Management - Comparison with other distros]]
| |
| * [[Running glibc programs]]
| |
| * [[Setting up a new user]]
| |
| * [[Upgrading Alpine]]
| |
| * [[Daily driver guide]]
| |
|
| |
| == Remote Administration ==
| |
|
| |
| * ACF
| |
| ** [[Changing passwords for ACF|ACF - changing passwords]]
| |
| ** [[Generating SSL certs with ACF]] <!-- Generating SSL certs with ACF 1.9 -->
| |
| ** [[setup-acf| ACF - setup]] ''(Configures ACF (webconfiguration/webmin) so you can manage your box through https)''
| |
| * [[Setting up a SSH server]] ''(Using ssh is a good way to administer your box remotely)''
| |
| ** [[HOWTO OpenSSH 2FA with password and Google Authenticator |OpenSSH 2FA]] ''(A simple two factor setup for OpenSSH)''
| |
| * [[OpenVCP]] ''(VServer Control Panel)''
| |
| * [[PhpMyAdmin]] ''(Web-based administration tool for MYSQL)''
| |
| * [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)''
| |
| * [[Webmin]] ''(A web-based interface for Linux system)''
| |
|
| |
| == 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]]
| |
| ** [[Apache with php-fpm]]
| |
| ** [[Setting Up Apache with PHP]]
| |
| ** [[Apache authentication: NTLM Single Signon]]
| |
| * [[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)'' <!-- Networking and Server, <== Using squark-auth-snmp -->
| |
| ** [[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)''
| |
| * [[WordPress]] ''(Web software to create website or blog)''
| |
|
| |
| === IRC ===
| |
|
| |
| * [[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 tls]]
| |
| * [[relay email to gmail (msmtp, mailx, sendmail]]
| |
| * [[Roundcube]] ''(Webmail system)''
| |
| * [[Setting up postfix with virtual domains]]
| |
| * Server protection
| |
| ** [[Setting up clamsmtp]]
| |
|
| |
| === Other Servers ===
| |
|
| |
| * [[Chrony and GPSD | 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]]
| |
| * [[Setting up an NFS server|nfs-server]]
| |
| * [[Odoo]]
| |
| * [[Configure OpenLDAP | OpenLDAP]] ''(Installing and configuring the Alpine package for OpenLDAP)''
| |
| * [[Setting up a samba-ad-dc|samba-ad-dc]] ''(Active Directory compatible domain controller)''
| |
| * [[Setting up a Samba server|samba-server]] ''(standard file sharing)''
| |
| * [[Setting up Transmission (bittorrent) with Clutch WebUI]]
| |
|
| |
| === Software development ===
| |
|
| |
| * [[Cgit]]
| |
| * [[OsTicket]] ''(Ticket system)''
| |
| * [[Patchwork]] ''(Patch review management system)''
| |
| * [[Redmine]] ''(Project management system)''
| |
| * [[Request Tracker]] ''(Ticket system)''
| |
| * [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''
| |
|
| |
| == Storage ==
| |
|
| |
| * [[Setting up disks manually|Disk setup (manual)]]
| |
| * [[Filesystems]]
| |
| ** [[Burning ISOs]]
| |
| * [[Setting up iSCSI|iSCSI Setup]]
| |
| ** [[iSCSI Raid and Clustered File Systems]]
| |
| ** [[Linux iSCSI Target (TCM)|iSCSI Target (TCM)/LinuxIO (LIO)]]
| |
| ** [[Linux iSCSI Target (tgt)|User space iSCSI Target (tgt)]]
| |
| * [[Setting up Logical Volumes with LVM|LVM Setup]]
| |
| ** [[Setting up LVM on GPT-labeled disks|LVM on GPT-labeled disks]]
| |
| ** [[Installing on GPT LVM|LVM on GPT-labeled disks (updated)]]
| |
| ** [[LVM on LUKS]]
| |
| * RAID
| |
| ** [[Raid Administration]]
| |
| ** [[Setting up a software RAID array]]
| |
| * ZFS
| |
| ** [[Root on ZFS with native encryption]]
| |
| ** [[Setting up ZFS on LUKS]]
| |
| ** [[Setting up ZFS with native encryption]]
| |
| ** [[ZFS scrub and trim]]
| |
| * [[CEPH|CEPH]]
| |
|
| |
| == Virtualization ==
| |
|
| |
| * [[Docker]]
| |
| * [[Installing Alpine in a virtual machine]]
| |
| ** [[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]]
| |
| ** [[Create Alpine Linux PV DomU|Xen DomU (paravirtualized)]]
| |
| ** [[Xen LiveCD]]
| |
| ** [[Xen PCI Passthrough]]
| |
|
| |
| = Tutorials =
| |
|
| |
| == Miscellaneous ==
| |
|
| |
| * [[TTY_Autologin|TTY Autologin]]
| |
| * [[Kexec|Faster rebooting with kexec]]
| |
| * [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small Office Services]]
| |
| * [[DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs]]
| |
| * [[Fault Tolerant Routing with Alpine Linux]]
| |
| * [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)''
| |
| * [[Linux iSCSI Target (TCM)]]
| |
| * [[ISP Mail Server 3.x HowTo]]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-service ISP mail server)''
| |
| * [[Replacing non-Alpine Linux with Alpine remotely]]
| |
| * [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' <!-- draft -->
| |
| * [[Streaming Security Camera Video with VLC]]
| |
|
| |
| == Newbie corner ==
| |
|
| |
| * [[How to get regular stuff working]] ''some notes on need-to-know topics''
| |
|
| |
| == Servers ==
| |
|
| |
| * [[Alpine production deploy]]
| |
| ** [[Production Web server: Lighttpd|Production web server: Lighttpd]]
| |
| ** [[MySQL|Production database: MySQL]]
| |
| ** [[Production LAMP system: Lighttpd + PHP + MySQL]]
| |
| * Alpine production monitoring
| |
| ** [[Cacti: traffic analysis and monitoring network]]
| |
| ** [[Zabbix|Zabbix - the professional complete manager]]
| |
| * Kubernetes
| |
| ** [[K8s]] Building a K8s Cluster on Alpine Linux
| |