Tutorials and Howtos: Difference between revisions

From Alpine Linux
m (→‎Postinstall: desktops and applications: move newbie related link to only newbie section.. so editors dont mess with)
 
(140 intermediate revisions by 36 users not shown)
Line 1: Line 1:
{{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 }}
[[Image:package_edutainment.svg|right|link=]]
[[Image:package_edutainment.svg|right|link=]]
{{TOC left}}
{{TOC left}}
'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''
'''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. Howto's have been organized in the below page based on the topics.


'''Howtos are smaller articles''' explaining how to perform a particular task with Alpine Linux, that expects a minimal knowledge from reader to perform actions.
'''The [[#Tutorials|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.


'''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]].
{{Note|
* Contributors are requested to refer to [[Help:Editing]] first and make use of resources like [[How to write a HOWTO]].
* Contributions must be complete articles.
* Don't override already made contributions, unless there is a mistake.  
* If you want to request a topic, please add your request in this page's [[Talk:Tutorials_and_Howtos|Discussion]].}}


== Desktop ==


{{Clear}}
* {{:Daily driver guide}}
=== Power management ===


==== Postinstall: desktops and applications ====
* [[Configure action when power-button is pressed]]
* [[Suspend on LID close]]
* [[Configure Wake-on-LAN]]


* [[Desktop environments and Window managers]] (overall information only)
=== Networking ===
** [[Xfce]]
** [[LXQt]]
** [[Openbox]]
** [[MATE]]
* [[Alpine and UEFI|Alpine and UEFI Support Status and related topics]]


==== Developers: compilers, IDEs and tools ====
* [[Bluetooth]] - Instructions for installing and configuring Bluetooth
 
* [[Bonding]] - Bond (or aggregate) multiple ethernet interfaces
* [[Alpine newbie developer]]
* [[Bridge]] - Configuring a network bridge
** [[Alpine newbie developer: gitea|Alpine newbie developer: Git management web frontend gitea]]
** [[Bridge wlan0 to eth0]]
** [[Alpine newbie developer: full stack web]]
* [[Configure Networking]]
 
* [[How to configure static routes]]
==== Servers: deploy in production ====
* Modem
 
** [[Using HSDPA modem]]
* [[Alpine production deploy]]
** [[Using serial modem]]
** [[Production Web server: Lighttpd‎‎]]
* [[mDNS]] - Howto implement multicast DNS resolution in Alpine.
** [[Production DataBases : mysql]]
* [[Multi ISP]] ''(Dual-ISP setup with load-balancing and automatic failover)''
** [[Production LAMP system: Lighttpd + PHP + MySQL‎‎]]
* [[PXE boot]]
* Alpine production monitoring
* Wi-Fi
** [[Cacti: traffic analysis and monitoring network]]
** [[Wi-Fi|Connecting to a wireless access point]]
** [[Zabbix|Zabbix - the professional complete manager]]
** [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
 
* [[VLAN]]
== Storage ==


* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)'' <!-- Installation and Storage -->
=== Security ===
** [[Back Up a Flash Memory Installation]] <!-- Installation and Storage -->
** [[Manually editing a existing apkovl]]


* [[Setting up disks manually]] <!-- Installation and Storage -->
* [[Securing Alpine Linux]] How to Secure Alpine Linux using Security Technical Implementation Guides (STIGs)
* [[Setting up a software RAID array]]
* Understand [[UEFI]] and enable [[UEFI Secure Boot]]
<!-- ** [[Setting up a /var partition on software IDE raid1]] Obsolete, Installation and Storage -->
* [[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]] <!-- just a stub -->


* [[Setting up iSCSI]]
=== Backup and data migration ===
** [[iSCSI Raid and Clustered File Systems]]
* [[Setting up NBD]]
* [[Setting up ZFS on LUKS]]
* [[Setting up ZFS with native encryption]]
* [[High performance SCST iSCSI Target on Linux software Raid]] ''(deprecated)'' <!-- solution -->
* [[Linux iSCSI Target (TCM)]]
* [[Disk Replication with DRBD]] <!-- draft -->


* [[Burning ISOs]] <!-- just some links now -->
* [[Partitioning and Bootmanagers]]
* [[Migrating data]]
* [[Migrating data]]
* [[Create a bootable SDHC from a Mac]]
* [[Rsnapshot]] - setting up periodic backups
* [[Alpine on ARM]]


== Networking ==
=== Other topics ===


* [[Configure Networking]]
* [[Gaming on Alpine]]
* [[Connecting to a wireless access point]]
* [[Remote Desktop Server]]
* [[Bonding]]
* [[Default applications|How to change default application]]
* [[Vlan]]
* [[CPU frequency scaling]]
* [[Bridge]]
* [[Mimalloc]]
* [[Bridge wlan0 to eth0]]
* [[Enable Serial Console on Boot]]
* [[OpenVSwitch]]
* [[How to build the Alpine Linux kernel]]
* [[How to configure static routes]]
* [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
* [[Configure a Wireguard interface (wg)]]
* [[Setting up lm_sensors]]
* [[Desktop environments and Window managers|List of supported Desktop environments and Window managers]]


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


* [[PXE boot]]
* [[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]]


* [[Using serial modem]]
== Other Architectures ==
* [[Using HSDPA modem]]
* [[Setting up Satellite Internet Connection]]
* [[Using Alpine on Windows domain with IPSEC isolation]]


* [[Setting up a SSH server]] ''(Using SSH is the preferred way to administer your box remotely)'' <!-- Server and Networking -->
=== ARM ===
** [[HOWTO OpenSSH 2FA with password and Google Authenticator]] ''(A simple two factor setup for OpenSSH)''
* [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
* [[How to set up Alpine as a wireless router]] ''(Setting up a firewalled, Wireless AP with wired network on a Pi Zero W)''
* [[Setting up a OpenVPN server with Alpine]] ''(Allowing single users or devices to remotely connect to your network)''
<!-- [[Using Racoon for Remote Sites]] is a different VPN tunnelling method, but that article is just a stub -->
* [[Experiences with OpenVPN-client on ALIX.2D3]]  <!-- solution -->


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


* [[Seafile: setting up your own private cloud]]
==== Raspberry Pi ====


* [[GNUnet]]
* [[Raspberry Pi|Raspberry Pi main page]]
* [[Raspberry Pi Bluetooth Speaker|Raspberry Pi - Bluetooth Speaker]]
* [[Linux Router with VPN on a Raspberry Pi|Raspberry Pi - Router with VPN]]
* [[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]]
* [[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)''
* [[Raspberry Pi 3 - Browser Client]] - kiosk or digital sign
* [[Raspberry Pi 3 - Configuring it as wireless access point -AP Mode]]
* [[Raspberry Pi 3 - Setting Up Bluetooth]]
* [[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)''
* [[RPI Video Receiver]]


== Post-Install ==
=== IBM Z (IBM z Systems) ===
<!-- If you edit this, please coordinate with Installation and Developer_Documentation#Package_management.  Note that these three sections are not exact duplicates. -->


* [[Setting up a new user]]
* [[s390x|s390x - Installation]]
* [[Enable Community Repository]] ''(Providing additional packages)''
* [[Alpine Linux package management|Package Management (apk)]] ''(How to add/remove packages on your Alpine)''
  <!-- [[Alpine Linux package management#Local_Cache|How to enable APK caching]] -->
** [[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]] <!-- new -->
** [[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]]
  <!-- [[Writing Init Scripts]] -->
* [[Alpine setup scripts#setup-xorg-base|Setting up Xorg]]
* [[Upgrading Alpine]]
<!-- Obsolete
[[Upgrading Alpine - v1.9.x]]
[[Upgrading Alpine - CD v1.8.x]]
[[Upgrading Alpine - HD v1.8.x]]
[[Upgrade to repository main|Upgrading to signed repositories]]
-->


* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''
=== PowerPC ===
** [[HOWTO OpenSSH 2FA with password and Google Authenticator]] ''(A simple two factor setup for OpenSSH)''
* [[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]]
* [[Ppc64le|Powerpc64le - Installation]]
<!-- Obsolete?
* [[Error message on boot: Address space collision: host bridge window conflicts with Adaptor ROM]]
-->
* [[How to get regular stuff working]] ''some notes on need-to-know topics''
* [[Installing Oracle Java]]
* [[Rsnapshot|Setting up periodic backups with <samp>rsnapshot</samp>]]


== Virtualization==
== Services ==  


* [[Xen Dom0]] ''(Setting up Alpine as a dom0 for Xen hypervisor)''
{{Note| Services are arranged in alphabetical order.}}
* [[Xen Dom0 on USB or SD]]
* [[Create Alpine Linux PV DomU]]
* [[Xen PCI Passthrough]]
* [[Xen LiveCD]]
* [[QEMU]]
* [[KVM]] ''(Setting up Alpine as a KVM hypervisor)''
* [[LXC]] ''(Setting up a Linux container in Alpine Linux)''
* [[Docker]]
* [[Install_Alpine_on_VirtualBox]]
* [[Install Alpine on VMWare]]


== Desktop Environment ==
=== Content management systems ===


* [[AwesomeWM]]
* [[DokuWiki]]
* [[dwm]]
* [[Drupal]] ''(Content Management System (CMS) written in PHP)''
* [[EyeOS]] ''(Cloud Computing Desktop)''
* [[Kopano]] ''(Microsoft Outlook compatible Groupware)''
* [[Gnome]]
* [[Mahara]] ''(E-portfolio and social networking system)''
* [[KDE]]
* [[MediaWiki]] ''(Free web-based wiki software application)''
* [[MATE]]
* [[Pastebin]] ''(Pastebin software application)''
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
* [[WordPress]] ''(Web software to create website or blog)''
* [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
* [[Moodle]] ''(Online Learning Management system)''
* [[Remote Desktop Server]]
* [[River]]
* [[Suspend on LID close]]
* [[Sway]]
* [[Xfce Desktop]]
* [[Sound Setup]]
* [[PipeWire]]
* [[Printer Setup]]
* [[Default applications]]


== Raspberry Pi ==
=== Database ===  


* [[Raspberry Pi|Raspberry Pi (Installation)]]
* [[MariaDB]] or [[MySQL|MySQL]]
* [[Raspberry Pi - Headless Installation]]
* [[Classic install or sys mode on Raspberry Pi]]
* [[RPI Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''
* [[Linux Router with VPN on a Raspberry Pi]]
* [[Linux Router with VPN on a Raspberry Pi (IPv6)]]
* [[Raspberry Pi 4 - Persistent system acting as a NAS and Time Machine]]
* [[Raspberry Pi 3 - Configuring it as wireless access point -AP Mode]]
* [[Raspberry Pi 3 - Setting Up Bluetooth]]
* [[Raspberry Pi 3 - Browser Client]] - kiosk or digital sign
* [[Raspberry Pi Zero W - Installation]]
* [[Raspberry Pi Bluetooth Speaker]]


== PowerPC ==
=== DNS ===


* [[Ppc64le|Powerpc64le (Installation)]]
* [[DNSCrypt-Proxy]] ''Encrypt and authenticate DNS calls from your system''
* [[Setting up nsd DNS server]]
* [[Small-Time DNS with BIND9]] ''(A simple configuration with ad blocking for your home network)''
* Unbound
** [[Setting up unbound DNS server]]
** [[Using Unbound as an Ad-blocker]] ''(Setup ad blocking for your network)''
* [[TinyDNS Format]]


== IBM Z (IBM z Systems) ==
=== File server ===


* [[s390x|s390x (Installation)]]
* [[Setting up an NFS server|nfs-server]]
* [[Setting up a Samba server|samba-server]] ''(standard file sharing)''
* [[Setting up a samba-ad-dc|samba-ad-dc]] ''(Active Directory compatible domain controller)''


== Applications ==
=== Firewall and VPN ===


=== Telephony ===
* Alpine Wall ''(a new firewall management framework)''
* [[Setting up Zaptel/Asterisk on Alpine]]
** [[Alpine Wall]]
** [[Setting up Streaming an Asterisk Channel]]
** [https://git.alpinelinux.org/awall/about/ Alpine Wall User's Guide]
* [[Freepbx on Alpine Linux]]
** [[How-To Alpine Wall]]
* [[FreePBX_V3]] ''(FreeSWITCH, Asterisk GUI web acces tool)''
* [[Freeradius Active Directory Integration]]
* [[2600hz]] ''(FreeSWITCH, Asterisk GUI web access tool)''
* [[GNUnet]]
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''
* [[IGMPproxy]]
* [[Setting up a OpenVPN server|OpenVPN server]] ''(Allowing single users or devices to remotely connect to your network)''
* [[OpenVSwitch]]
* [[Tor]]
* [[Uncomplicated Firewall|Uncomplicated Firewall or UFW]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Configure a Wireguard interface (wg)|Wireguard]]


=== Mail ===
=== HTTP and web services ===
* [[Hosting services on Alpine]] ''(Hosting mail, webservices and other services)''
** [[Hosting Web/Email services on Alpine]]
* [[ISP Mail Server HowTo]] <!-- solution, Mail -->
** [[ISP Mail Server Upgrade 2.x]]
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
** [[ISP Mail Server 3.x HowTo]]
* [[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]]
* [[relay email to gmail (msmtp, mailx, sendmail]]


=== HTTP ===
* [[Althttpd]]
* [[Apache]]
** [[Apache with php-fpm]]
** [[Setting Up Apache with PHP]]
** [[Apache authentication: NTLM Single Signon]]
* [[Darkhttpd]]
* [[Lighttpd]]
* [[Lighttpd]]
** [[Lighttpd Https access]]
** [[Lighttpd Advanced security]]
** [[Setting Up Lighttpd with PHP]]
** [[Setting Up Lighttpd With FastCGI]]
** [[Setting Up Lighttpd With FastCGI]]
* [[Cherokee]]
** [[Production Web server: Lighttpd|Production web server: Lighttpd‎‎]]
* [[Nginx]]
* [[Nginx]]
** [[Nginx_with_PHP#Nginx_with_PHP|Nginx with PHP]]
** [[Nginx as reverse proxy with acme (letsencrypt)]]
** [[Nginx as reverse proxy with acme (letsencrypt)]]
* [[Apache]]
** [[Nginx with PHP]]
** [[Apache with php-fpm]]
* Squid Proxy
** [[Setting Up Apache with PHP]]
** [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' <!-- Networking and Server, <== Using squark-auth-snmp -->
** [[Apache authentication: NTLM Single Signon]]
** [[Setting up Explicit Squid Proxy]]
 
** [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)'' <!-- solution, Server -->
 
* [[Setting up Transparent Squid Proxy]] <!-- draft -->
** [[SqStat]] ''(Script to look at active squid users connections)''
** [[SqStat]] ''(Script to look at active squid users connections)''
** [[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]]
* [[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]]
* [[Tomcat]]
* [[Tomcat]]
* [[Kopano]] ''(Microsoft Outlook compatible Groupware)''
** [[Production LAMP system: Lighttpd + PHP + MySQL‎‎|Production LAMP system: Lighttpd + PHP + MariaDB/MySQL‎‎]]


=== Other Servers ===
=== IRC ===
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''
** [[HOWTO OpenSSH 2FA with password and Google Authenticator]] ''(A simple two factor setup for OpenSSH)''


* [[Setting up a nfs-server]]
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''
* [[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)''
=== Mail ===
* [[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)''


* [[Alpine_newbie_developer: gitea|Setting up Git management web frontend gitea]]
* [[Hosting services on Alpine]] ''(Hosting mail, webservices and other services)''
* [[Cgit]]
* [[Hosting Web/Email services on Alpine]]
** [[Setting up a git repository server with gitolite and cgit]] <!-- doesn't exist yet -->
* 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]]
* [[relay email (nullmailer)]]
* [[Roundcube]] ''(Webmail system)''
* [[Roundcube]] ''(Webmail system)''
* [[Glpi]] ''(Manage inventory of technical resources)''
* [[Setting up postfix with virtual domains]]
* Server protection
** [[Setting up clamsmtp]]


* [[How to setup a Alpine Linux mirror]]
=== Monitoring ===
* [[Cups]]
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''
* [[How To Setup Your Own IRC Network]] ''(Using {{Pkg|charybdis}} and {{Pkg|atheme-iris}})''
* [[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]]
* [[IPTV How To|Internet Protocol television (IPTV)]]
* [[UniFi_Controller]]
* [[DNSCrypt-Proxy]] ''Encrypt and authenticate DNS calls from your system''
* [[Odoo]]


=== Monitoring ===
* [[Awstats]] ''(Free log file analyzer)''
* Setting up [[collectd]]
* [[Traffic monitoring]] <!-- Networking and Monitoring -->
* [[Setting up traffic monitoring using rrdtool (and snmp)]] <!-- Monitoring -->
* [[Setting up monitoring using rrdtool (and rrdcollect)]]
* [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)''
* [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)''
* [[LTTng]] ''(Kernel and userspace tracing)''
* [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' <!-- Monitoring and Security -->
* [[Zabbix|Zabbix - the professional complete manager]] ''(Monitor and track the status of network services and hardware)''
* [[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)''
* [[Logcheck]] ''(log file monitoring tool)''
* [[Matomo]] ''(A real time web analytics software program)''
* [[Rasdaemon]] ''(Platform Reliability, Availability and Serviceability monitoring tool)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' <!-- draft, solution, Networking and Monitoring and Server -->
* [[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 NRPE daemon]] ''(Performs remote Nagios checks)'' <!-- Networking and Monitoring -->
* [[Setting up Smokeping|Smokeping]] ''(Network latency monitoring)'' <!-- 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 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)'' <!-- Networking and Monitoring -->
* [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' <!-- Monitoring and Security -->
 
* [[IP Accounting]] <!-- Networking and Monitoring -->
* [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' <!-- Networking and Server, <== Using squark-auth-snmp -->
* [[SqStat]] ''(Script to look at active squid users connections)''
* [[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]]


* [[Piwik]] ''(A real time web analytics software program)''
=== Remote Administration ===
* [[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)''


* 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)''
* [[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]]
=== Telephony ===


* [[ZoneMinder video camera security and surveillance]]
* [[FreePBX|FreePBX on Alpine Linux]]
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''


== Misc ==
=== Other Servers ===


* [[:Category:Shell]]
* [[apcupsd]] ''(UPS Monitoring with apcupsd)''
* [[:Category:Programming]]
* [[Chrony and GPSD | Chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
* [[Running glibc programs]]
* [[Glpi]] ''(Manage inventory of technical resources)''
* [[:Category:Drivers]]
* [[How to setup a Alpine Linux mirror]]
* [[:Category:Multimedia]]
* [[nut-ups|NUT UPS]] ''(UPS Monitoring with Network UPS Tools)''
* [[Kernel Modesetting]]
* [[Odoo]]
* [[CPU frequency scaling]]
* [[Configure OpenLDAP | OpenLDAP]] ''(Installing and configuring the Alpine package for OpenLDAP)''
* [[Setting up a LLDAP server|lldap-server]] ''(Directory Server)''
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]


== Complete Solutions ==
* [[DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs]]
* [https://codeberg.org/AVG7/alpine-sway-x86_64 DIY Live-USB-Stick with Sway]
* [[Alpine on the Aopen Chromebase or Chromebox Mini with Mainline Kernel]]
* [[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)''
== Software development ==
** [[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)'' <!-- draft -->
* [[Streaming Security Camera Video with VLC]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small_Office_Services]]


* [[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)''
* [[Ansible]] ''(Configuration management)''
* [[Installing Oracle Java|Oracle Java (installation)]]


<!--
== Storage ==
This does not attempt to be complete. Is it useful to have these listed here? I find them more accessible if grouped with their topics; also, an up-to-date list of all Draft or Obsolete pages can be found at [[Project:Wiki maintenance]].


== Drafts ==
* [[Setting up disks manually|Manual partitioning]]
Currently unfinished/works-in-progress.
* [[Disk Replication with DRBD|DRBD: Disk Replication]]
* [[Using Racoon for Remote Sites]]
* [[Filesystems]]
* [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
** [[Burning ISOs]]
** [[Obtaining user information via SNMP]] ''(Using the Squark Squid authentication helper)'' [!-- no longer a draft --]
* [[Setting up iSCSI|iSCSI Setup]]
* [[Setting up Streaming an Asterisk Channel]]
** [[iSCSI Raid and Clustered File Systems]]
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)''
** [[Linux iSCSI Target (TCM)|iSCSI Target (TCM)/LinuxIO (LIO)]]
* [[Intrusion Detection using Snort]] ''(Installing and configuring Snort and related applications on Alpine 2.0.x)''
** [[Linux iSCSI Target (tgt)|User space iSCSI Target (tgt)]]
* [[IP Accounting]] ''(Installing and configuring pmacct for IP Accounting, Netflow/sFlow collector)''
* [[Setting up Logical Volumes with LVM|LVM Setup]]
* [[Disk Replication with DRBD]]
** [[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]]
* [[CEPH|CEPH]]


== Beginners and Newbies ==
== Virtualization ==


* [[Alpine_newbie]] (for overall information in funny sections)
* [[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]]
** [[K8s]] Building a K8s Kubernetes Cluster on Alpine Linux


* [[Alpine_newbie_apk_packages|Alpine newbie users post install and easy setups]]
== Tutorials ==
** [[Alpine_newbie_apk_packages#New_users:_hostname_and_network_wired_connection|First steps at post install]]
** [[Alpine_newbie_apk_packages#New_users:_common_needed_package_to_install|Enable repositories]]
** [[Alpine_newbie_apk_packages#New_users:_management_of_users_and_logins|Added the first user to use the system]]
** [[Alpine_newbie_apk_packages#install_basic_tools|First packages to install]] (need the previous [[Alpine_newbie_apk_packages#New_users:_common_needed_package_to_install|Enable repositories]]) already done!


==== Installation: Use cases ====
* [[TTY_Autologin|TTY Autologin]]
 
* [[Kexec|Faster rebooting with kexec]]
* [[Alpine newbie install manual]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small Office Services]]
** [[Alpine Install: from a disc to a new computer single only boot]]
* [[DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs]]
** [[Alpine Install: from a disc to a old computer single only boot]]
* [[Fault Tolerant Routing with Alpine Linux]]
** [[Alpine Install: from a disc to a virtualbox machine single only]]
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)''
** [[Alpine Install: from a iso to a virtualbox machine with external disc]]
* [[Linux iSCSI Target (TCM)]]
* [[Alpine_newbie_install_manual#Ways_to_install_Alpine_listed_by_architectures|Ways to install listed by architectures]]
* [[ISP Mail Server 3.x HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-service ISP mail server)''
** [[Alpine_newbie_install_manual#x86_64_x86_32_x86|x86_64 x86_32 x86 s390]]
* [[Grommunio Mail Server]] ''(Mariadb+Postfix+Rspamd+Grommunio - Full-service mail server as MS exchange replacement)''
** [[Alpine_newbie_install_manual#armhf_armv7|armhf armv7 aarch64]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
** [[Alpine_newbie_install_manual#ppc64le|ppc64le others PPC]]
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' <!-- draft -->
 
* [[Streaming Security Camera Video with VLC]]
 
* [[Install Alpine on a btrfs filesystem with refind as boot manager]]
 
* [[Compile software from source|How to Compile a software from source in Alpine Linux]]
[[Category:Newbie]]
[[Category:System_Administration]]
[[Category:Installation]]

Latest revision as of 23:10, 13 April 2025

Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.

Howtos are smaller articles explaining how to perform a particular task with Alpine Linux, that expects a minimal knowledge from reader to perform actions. Howto's have been organized in the below page based on the topics.

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.

Note:
  • Contributors are requested to refer to Help:Editing first and make use of resources like How to write a HOWTO.
  • Contributions must be complete articles.
  • Don't override already made contributions, unless there is a mistake.
  • If you want to request a topic, please add your request in this page's Discussion.

Desktop

Alpine Linux is a general purpose Linux distribution designed for power users. It is built to be small and resource efficient. If you feel the defaults are too lightweight for desktop use, it is easy to get most of the regular stuff working and use it as a daily driver.

This guide assumes you have already installed a minimal Alpine Linux system in system disk mode with working internet.

Once the above mandatory steps are completed, install any desktop of your choice either manually or using setup-desktop script.

Basics

Advanced

Power management

Networking

Security

Backup and data migration

Other topics

Diskless

Other Architectures

ARM

Raspberry Pi

IBM Z (IBM z Systems)

PowerPC

Services

Note: Services are arranged in alphabetical order.

Content management systems

  • 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)
  • Moodle (Online Learning Management system)

Database

DNS

File server

Firewall and VPN

HTTP and web services

IRC

  • NgIRCd (Server for Internet Relay Chat/IRC)

Mail

Monitoring

Remote Administration

Telephony

Other Servers


Software development

Storage

Virtualization

Tutorials

Retrieved from "https://wiki.alpinelinux.org/w/index.php?title=Tutorials_and_Howtos&oldid=29683"