Tutorials and Howtos: Difference between revisions

From Alpine Linux
(Reorganizing Other Architectures)
(Ordering sections)
Line 21: Line 21:


{{Warning|Work in Progress: reorganizing as asked in oldid 16474}}
{{Warning|Work in Progress: reorganizing as asked in oldid 16474}}
== Postinstall ==
=== Developers: compilers, IDEs and tools ===
* [[Alpine newbie developer]]
** [[Alpine newbie developer: gitea|Alpine newbie developer: Git management web frontend gitea]]
** [[Alpine newbie developer: full stack web]]
=== Servers: deploy in production ===
* [[Alpine production deploy]]
** [[Production Web server: Lighttpd|Production web server: Lighttpd‎‎]]
** [[Production DataBases : 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
== Storage ==
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)'' <!-- Installation and Storage -->
** [[Back Up a Flash Memory Installation]] <!-- Installation and Storage -->
** [[Manually editing a existing apkovl]]
* [[Setting up disks manually]] <!-- Installation and Storage -->
* [[Setting up a software RAID array]]
<!-- ** [[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]]
** [[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]]
* [[Create a bootable SDHC from a Mac]]
* [[Alpine on ARM]]
== Networking ==
* [[Configure Networking]]
* [[Connecting to a wireless access point]]
* [[Bonding]]
* [[Vlan]]
* [[Bridge]]
* [[Bridge wlan0 to eth0]]
* [[OpenVSwitch]]
* [[How to configure static routes]]
* [[Configure a Wireguard interface (wg)]]
* [[Alpine Wall]] - [[How-To Alpine Wall]] - [[Alpine Wall User's Guide]] ''(a new firewall management framework)''
* [[PXE boot]]
* [[Using serial modem]]
* [[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 -->
** [[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 -->
* [[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]]
* [[GNUnet]]
== Post-Install ==
<!-- If you edit this, please coordinate with Installation and Developer_Documentation#Package_management.  Note that these three sections are not exact duplicates. -->
* [[Installation#Post-Installation|Post install]]
* [[Setting up a new user]]
* [[Repositories#Enabling_the_community_repository|Enabling the 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)''
** [[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]]
<!-- 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==
* [[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]]
* [[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 ==
* [[Desktop environments and Window managers]] (overall information only)
** Desktop Environments
*** [[Gnome]]
*** [[KDE]]
*** [[LXQt]]
*** [[MATE]]
*** [[Xfce]]
** [https://en.wikipedia.org/wiki/Stacking_window_manager Stacking (floating) window managers]
*** X11
**** [[Fluxbox (spanish)]]
**** [[Openbox]]
*** Wayland
**** [[LabWC]]
** [https://en.wikipedia.org/wiki/Tiling_window_manager Tiling (dynamic) window managers]
*** X11
**** [[AwesomeWM]]
**** [[dwm]]
*** Wayland
**** [[River]]
**** [[Sway]]
* [[Alpine and UEFI|Alpine and UEFI Support Status and related topics]]
* [[EyeOS]] ''(Cloud Computing Desktop)''
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
* [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
* [[Remote Desktop Server]]
* [[Suspend on LID close]]
* [[Sound Setup]]
* [[PipeWire]]
* [[Printer Setup]]
* [[Default applications]]
== Other Architectures ==
=== ARM ===
==== Raspberry Pi ====
* [[Linux Router with VPN on a Raspberry Pi]]
* [[Linux Router with VPN on a Raspberry Pi (IPv6)]]
* [[Raspberry Pi Bluetooth Speaker|Raspberry Pi - Bluetooth Speaker]]
* [[Raspberry Pi|Raspberry Pi - Installation]]
* [[Classic install or sys mode on Raspberry Pi|Raspberry Pi - Sys mode install]]
* [[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]]
* [[RPI Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''
=== IBM Z (IBM z Systems) ===
* [[s390x|s390x - Installation]]
=== PowerPC ===
* [[Ppc64le|Powerpc64le - Installation]]


== Applications ==
== Applications ==
Line 352: Line 148:


* [[ZoneMinder video camera security and surveillance]]
* [[ZoneMinder video camera security and surveillance]]
== Misc ==
* [[:Category:Shell]]
* [[:Category:Programming]]
* [[Running glibc programs]]
* [[:Category:Drivers]]
* [[:Category:Multimedia]]
* [[Kernel Modesetting]]
* [[CPU frequency scaling]]


== Complete Solutions ==
== Complete Solutions ==
Line 379: Line 165:
* [[Streaming Security Camera Video with VLC]]
* [[Streaming Security Camera Video with VLC]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small_Office_Services]]
* [[Dynamic Multipoint VPN (DMVPN)]] combined with [[Small_Office_Services]]
== Desktop Environment ==
* [[Desktop environments and Window managers]] (overall information only)
** Desktop Environments
*** [[Gnome]]
*** [[KDE]]
*** [[LXQt]]
*** [[MATE]]
*** [[Xfce]]
** [https://en.wikipedia.org/wiki/Stacking_window_manager Stacking (floating) window managers]
*** X11
**** [[Fluxbox (spanish)]]
**** [[Openbox]]
*** Wayland
**** [[LabWC]]
** [https://en.wikipedia.org/wiki/Tiling_window_manager Tiling (dynamic) window managers]
*** X11
**** [[AwesomeWM]]
**** [[dwm]]
*** Wayland
**** [[River]]
**** [[Sway]]
* [[Alpine and UEFI|Alpine and UEFI Support Status and related topics]]
* [[EyeOS]] ''(Cloud Computing Desktop)''
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
* [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
* [[Remote Desktop Server]]
* [[Suspend on LID close]]
* [[Sound Setup]]
* [[PipeWire]]
* [[Printer Setup]]
* [[Default applications]]


<!--
<!--
Line 394: Line 213:
* [[Disk Replication with DRBD]]
* [[Disk Replication with DRBD]]
-->
-->
== Networking ==
* [[Configure Networking]]
* [[Connecting to a wireless access point]]
* [[Bonding]]
* [[Vlan]]
* [[Bridge]]
* [[Bridge wlan0 to eth0]]
* [[OpenVSwitch]]
* [[How to configure static routes]]
* [[Configure a Wireguard interface (wg)]]
* [[Alpine Wall]] - [[How-To Alpine Wall]] - [[Alpine Wall User's Guide]] ''(a new firewall management framework)''
* [[PXE boot]]
* [[Using serial modem]]
* [[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 -->
** [[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 -->
* [[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]]
* [[GNUnet]]
== Misc ==
* [[:Category:Shell]]
* [[:Category:Programming]]
* [[Running glibc programs]]
* [[:Category:Drivers]]
* [[:Category:Multimedia]]
* [[Kernel Modesetting]]
* [[CPU frequency scaling]]


== Newbies ==
== Newbies ==
Line 401: Line 272:
[[Category:System_Administration]]
[[Category:System_Administration]]
[[Category:Installation]]
[[Category:Installation]]
== Other Architectures ==
=== ARM ===
==== Raspberry Pi ====
* [[Linux Router with VPN on a Raspberry Pi]]
* [[Linux Router with VPN on a Raspberry Pi (IPv6)]]
* [[Raspberry Pi Bluetooth Speaker|Raspberry Pi - Bluetooth Speaker]]
* [[Raspberry Pi|Raspberry Pi - Installation]]
* [[Classic install or sys mode on Raspberry Pi|Raspberry Pi - Sys mode install]]
* [[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]]
* [[RPI Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''
=== IBM Z (IBM z Systems) ===
* [[s390x|s390x - Installation]]
=== PowerPC ===
* [[Ppc64le|Powerpc64le - Installation]]
== Postinstall ==
=== Developers: compilers, IDEs and tools ===
* [[Alpine newbie developer]]
** [[Alpine newbie developer: gitea|Alpine newbie developer: Git management web frontend gitea]]
** [[Alpine newbie developer: full stack web]]
=== Servers: deploy in production ===
* [[Alpine production deploy]]
** [[Production Web server: Lighttpd|Production web server: Lighttpd‎‎]]
** [[Production DataBases : 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
== Post-Install ==
<!-- If you edit this, please coordinate with Installation and Developer_Documentation#Package_management.  Note that these three sections are not exact duplicates. -->
* [[Installation#Post-Installation|Post install]]
* [[Setting up a new user]]
* [[Repositories#Enabling_the_community_repository|Enabling the 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)''
** [[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]]
<!-- 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>]]
== Storage ==
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)'' <!-- Installation and Storage -->
** [[Back Up a Flash Memory Installation]] <!-- Installation and Storage -->
** [[Manually editing a existing apkovl]]
* [[Setting up disks manually]] <!-- Installation and Storage -->
* [[Setting up a software RAID array]]
<!-- ** [[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]]
** [[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]]
* [[Create a bootable SDHC from a Mac]]
* [[Alpine on ARM]]
== 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]]
* [[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]]

Revision as of 18:15, 10 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


Tutorials

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


Applications

Telephony

Mail

HTTP

Other Servers

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

Monitoring

  • 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

Complete Solutions

Desktop Environment


Networking

Misc

Newbies

Other Architectures

ARM

Raspberry Pi

IBM Z (IBM z Systems)

PowerPC

Postinstall

Developers: compilers, IDEs and tools

Servers: deploy in production

Post-Install

Storage

Virtualization