Difference between revisions of "Tutorials and Howtos"

From Alpine Linux
Jump to: navigation, search
m (Post-Install)
(finally zabbix monitoring now! the older one was so crappy (as always here))
 
(64 intermediate revisions by 29 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.
+
'''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.
+
'''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]].
  
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}}
 
{{Clear}}
 +
 +
== New users and Newbies ==
 +
 +
* [[Newbie Alpine Ecosystem]] (for overall information in funny sections)
 +
 +
==== Installation: Use cases ====
 +
 +
* [[Alpine newbie install manual]]
 +
** [[Alpine Install: from a disc to a new computer single only boot]]
 +
** [[Alpine Install: from a disc to a old computer single only boot]]
 +
** [[Alpine Install: from a disc to a virtualbox machine single only]]
 +
** [[Alpine Install: from a iso to a virtualbox machine with external disc]]
 +
* [[Alpine_newbie_install_manual#Ways_to_install_Alpine_listed_by_architectures|Ways to install listed by architectures]]
 +
** [[Alpine_newbie_install_manual#x86_64_x86_32_x86|x86_64 x86_32 x86 s390]]
 +
** [[Alpine_newbie_install_manual#armhf_armv7|armhf armv7 aarch64]]
 +
** [[Alpine_newbie_install_manual#ppc64le|ppc64le others PPC]]
 +
 +
==== Postinstall: desktops and applications ====
 +
 +
* [[Alpine newbie apk packages|Overall info and minimal packages common to any working desktop]]
 +
** [[Alpine newbie desktops|Alpine newbie desktops, (overall information only)]]
 +
** [[XFCE Setup]]
 +
** [[Alpine Newbies LXDE Desktop Environment]]
 +
** [[Alpine Newbies Openbox Window Manager|Alpine Newbies Xorg and Openbox Window Manager]]
 +
** [[MATE|Alpine Newbies MATE Desktop Environment]]
 +
* [[Alpine and UEFI|Alpine and UEFI Support Status and related topics]]
 +
 +
==== Developers: compilers, IDE's 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 DataBases : mysql]]
 +
** [[Production LAMP system: Lighttpd + PHP + MySQL‎‎]]
 +
* Alpine production monitoring
 +
** [[Cacti: traffic analysis and monitoring network]]
 +
** [[Zabbix|Zabbix - the professional complete manager]]
 +
 
== Storage ==
 
== Storage ==
  
Line 30: Line 76:
 
** [[iSCSI Raid and Clustered File Systems]]
 
** [[iSCSI Raid and Clustered File Systems]]
 
* [[Setting up NBD]]
 
* [[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 -->
 
* [[High performance SCST iSCSI Target on Linux software Raid]] ''(deprecated)'' <!-- solution -->
 
* [[Linux iSCSI Target (TCM)]]
 
* [[Linux iSCSI Target (TCM)]]
Line 47: Line 95:
 
* [[Vlan]]
 
* [[Vlan]]
 
* [[Bridge]]
 
* [[Bridge]]
 +
* [[Bridge wlan0 to eth0]]
 
* [[OpenVSwitch]]
 
* [[OpenVSwitch]]
 
* [[How to configure static routes]]
 
* [[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)''
 
* [[Alpine Wall]] - [[How-To Alpine Wall]] - [[Alpine Wall User's Guide]] ''(a new firewall management framework)''
Line 61: Line 111:
 
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)'' <!-- Server and Networking -->
 
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)'' <!-- Server and Networking -->
 
* [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
 
* [[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)''
 
* [[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 -->
 
<!-- [[Using Racoon for Remote Sites]] is a different VPN tunnelling method, but that article is just a stub -->
Line 75: Line 126:
  
 
* [[Seafile: setting up your own private cloud]]
 
* [[Seafile: setting up your own private cloud]]
 +
 +
* [[GNUnet]]
  
 
== Post-Install ==
 
== Post-Install ==
<!-- If you edit this, please coordinate with Installation#Post-Install and Developer_Documentation#Package_management.  Note that these three sections are not exact duplicates. -->
+
<!-- If you edit this, please coordinate with Installation and Developer_Documentation#Package_management.  Note that these three sections are not exact duplicates. -->
  
 +
* [[Alpine_newbie_apk_packages|Alpine newbie users post install and easy setups]]
 +
** [[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!
 +
 +
* [[Setting up a new user]]
 +
* [[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|Package Management (apk)]] ''(How to add/remove packages on your Alpine)''
 
   <!-- [[Alpine Linux package management#Local_Cache|How to enable APK caching]] -->
 
   <!-- [[Alpine Linux package management#Local_Cache|How to enable APK caching]] -->
Line 107: Line 168:
 
-->
 
-->
 
* [[How to get regular stuff working]] ''some notes on need-to-know topics''
 
* [[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>]]
 
* [[Rsnapshot|Setting up periodic backups with <samp>rsnapshot</samp>]]
  
Line 117: Line 179:
 
* [[Xen LiveCD]]
 
* [[Xen LiveCD]]
 
* [[qemu]]
 
* [[qemu]]
 +
* [[KVM]] ''(Setting up Alpine as a KVM hypervisor)''
 
* [[LXC]] ''(Setting up a Linux container in Alpine Linux)''
 
* [[LXC]] ''(Setting up a Linux container in Alpine Linux)''
 
* [[Docker]]
 
* [[Docker]]
 
* [[Install_Alpine_on_VirtualBox]]
 
* [[Install_Alpine_on_VirtualBox]]
 +
* [[Install Alpine on VMWare]]
  
 
== Desktop Environment ==
 
== Desktop Environment ==
  
 
* [[Awesome(wm) Setup]]
 
* [[Awesome(wm) Setup]]
 +
* [[dwm]] ''(dynamic window manager for X)''
 
* [[EyeOS]] ''(Cloud Computing Desktop)''
 
* [[EyeOS]] ''(Cloud Computing Desktop)''
 
* [[Gnome Setup]]
 
* [[Gnome Setup]]
 +
* [[KDE]]
 
* [[MATE|MATE Setup]]
 
* [[MATE|MATE Setup]]
 
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
 
* [[Oneye]] ''(Cloud Computing Desktop - Dropbox Alternative)''
Line 132: Line 198:
 
* [[Remote Desktop Server]]
 
* [[Remote Desktop Server]]
 
* [[Suspend on LID close]]
 
* [[Suspend on LID close]]
 +
* [[Sway]]
 
* [[XFCE Setup]] and [[Xfce Desktop|Desktop Ideas]]
 
* [[XFCE Setup]] and [[Xfce Desktop|Desktop Ideas]]
 
* [[Installing Adobe flash player for Firefox]]
 
* [[Installing Adobe flash player for Firefox]]
 +
* [[Sound Setup]]
 +
* [[PipeWire]]
 +
* [[Printer Setup]]
 +
* [[Default applications]]
  
 
== Raspberry Pi ==
 
== Raspberry Pi ==
  
 
* [[Raspberry Pi|Raspberry Pi (Installation)]]
 
* [[Raspberry Pi|Raspberry Pi (Installation)]]
 +
* [[Raspberry Pi - Headless Installation]]
 +
* [[Classic install or sys mode on Raspberry Pi]]
 
* [[RPI Video Receiver]] ''(network video decoder using Rasperry Pi and omxplayer)''
 
* [[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]]
 +
* [[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 - Configuring it as wireless access point -AP Mode]]
 
* [[Raspberry Pi 3 - Setting Up Bluetooth]]
 
* [[Raspberry Pi 3 - Setting Up Bluetooth]]
 +
* [[Raspberry Pi 3 - Browser Client]] - kiosk or digital sign
 +
* [[Raspberry Pi Zero W - Installation]]
 +
 +
== PowerPC ==
 +
 +
* [[Ppc64le|Powepc64le (Installation)]]
 +
 +
== IBM Z (IBM z Systems) ==
 +
 +
* [[s390x|s390x (Installation)]]
  
 
== Applications ==
 
== Applications ==
Line 159: Line 244:
 
** [[ISP Mail Server Upgrade 2.x]]
 
** [[ISP Mail Server Upgrade 2.x]]
 
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
 
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
 +
** [[ISP Mail Server 3.x HowTo]]
 
* [[Roundcube]] ''(Webmail system)''
 
* [[Roundcube]] ''(Webmail system)''
 
* [[Setting up postfix with virtual domains]]
 
* [[Setting up postfix with virtual domains]]
Line 173: Line 259:
 
* [[Cherokee]]
 
* [[Cherokee]]
 
* [[Nginx]]
 
* [[Nginx]]
* [[Nginx as reverse proxy with acme (letsencrypt)]]
+
** [[Nginx_with_PHP#Nginx_with_PHP|Nginx with PHP]]
 +
** [[Nginx as reverse proxy with acme (letsencrypt)]]
 
* [[Apache]]
 
* [[Apache]]
 
** [[Apache with php-fpm]]
 
** [[Apache with php-fpm]]
Line 191: Line 278:
 
* [[DokuWiki]]
 
* [[DokuWiki]]
 
* [[Darkhttpd]]
 
* [[Darkhttpd]]
 +
* [[Tomcat]]
  
 
=== Other Servers ===
 
=== Other Servers ===
Line 209: Line 297:
 
* [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''
 
* [[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]]
 
* [[Cgit]]
 
* [[Cgit]]
 
** [[Setting up a git repository server with gitolite and cgit]] <!-- doesn't exist yet -->
 
** [[Setting up a git repository server with gitolite and cgit]] <!-- doesn't exist yet -->
Line 217: Line 306:
 
* [[Cups]]
 
* [[Cups]]
 
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''
 
* [[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)''
 
* [[OpenVCP]] ''(VServer Control Panel)''
 
* [[Mahara]] ''(E-portfolio and social networking system)''
 
* [[Mahara]] ''(E-portfolio and social networking system)''
 
* [[Chrony and GPSD | Using chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
 
* [[Chrony and GPSD | Using chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
 
* [[Sending SMS using gnokii]]
 
* [[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 ===
 
=== Monitoring ===
Line 227: Line 321:
 
* [[Setting up traffic monitoring using rrdtool (and snmp)]] <!-- Monitoring -->
 
* [[Setting up traffic monitoring using rrdtool (and snmp)]] <!-- Monitoring -->
 
* [[Setting up monitoring using rrdtool (and rrdcollect)]]
 
* [[Setting up monitoring using rrdtool (and rrdcollect)]]
* [[Setting up Cacti|Cacti]] ''(Front-end for rrdtool networking monitor)''
+
* [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)''
* [[Setting up Zabbix|Zabbix]] ''(Monitor and track the status of network services and hardware)''
+
* [[LTTng]] ''(Kernel and userspace tracing)''
 +
* [[Zabbix|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)'' <!-- 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 -->
Line 268: Line 363:
 
== Complete Solutions ==
 
== Complete Solutions ==
 
* [[DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs]]
 
* [[DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs]]
 +
* [[Alpine on the Aopen Chromebase or Chromebox Mini with Mainline Kernel]]
 
* [[Replacing non-Alpine Linux with Alpine remotely]]
 
* [[Replacing non-Alpine Linux with Alpine remotely]]
 
* [[High performance SCST iSCSI Target on Linux software Raid]]
 
* [[High performance SCST iSCSI Target on Linux software Raid]]
Line 297: Line 393:
 
* [[Disk Replication with DRBD]]
 
* [[Disk Replication with DRBD]]
 
-->
 
-->
 +
 +
 +
[[Category:Newbie]]

Latest revision as of 18:37, 12 June 2021

Underconstruction clock icon gray.svg
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


Package edutainment.svg

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.



New users and Newbies

Installation: Use cases

Postinstall: desktops and applications

Developers: compilers, IDE's and tools

Servers: deploy in production

Storage

Networking

Post-Install

Virtualization

Desktop Environment

Raspberry Pi

PowerPC

IBM Z (IBM z Systems)

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

Misc

Complete Solutions