Difference between revisions of "Tutorials and Howtos"

From Alpine Linux
Jump to: navigation, search
(Desktop Environment: added printer setup tutorial)
 
(52 intermediate revisions by 26 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, 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]].
 +
 
 +
-----------------------------------------------------------------
  
Howtos are smaller articles explaining how to perform a particular task with Alpine Linux.
+
All of '''those linked pages here will help you make many things''' over the Alpine '''O'''perating '''S'''ystem or Alpine '''OS'''.
  
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]].
+
Alpine are the main program named '''OS''' (means Operating System), that's runs on top of the '''machine/PC/laptop''', and subsequently over this '''OS''' run the programs such like the internet web browser ({{Pkg|firefox}}, {{Pkg|chromium}}), and the web pages like "facebook" runs over that internet web browser.
  
 
{{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)]]
 +
** [[Alpine Newbies XFCE Desktop Environment]]
 +
** [[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]]
 +
 
== Storage ==
 
== Storage ==
  
Line 30: Line 80:
 
** [[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 99:
 
* [[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 115:
 
* [[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 130:
  
 
* [[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 172:
 
-->
 
-->
 
* [[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 121: Line 187:
 
* [[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]]
Line 133: Line 201:
 
* [[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]]
 
* [[Sound Setup]]
 +
* [[PipeWire]]
 
* [[Printer Setup]]
 
* [[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]]
 +
* [[Raspberry Pi Zero W - Installation]]
 +
 +
== PowerPC ==
 +
 +
* [[Ppc64le|Powepc64le (Installation)]]
 +
 +
== IBM Z (IBM z Systems) ==
 +
 +
* [[s390x|s390x (Installation)]]
  
 
== Applications ==
 
== Applications ==
Line 162: Line 247:
 
** [[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 176: Line 262:
 
* [[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 194: Line 281:
 
* [[DokuWiki]]
 
* [[DokuWiki]]
 
* [[Darkhttpd]]
 
* [[Darkhttpd]]
 +
* [[Tomcat]]
  
 
=== Other Servers ===
 
=== Other Servers ===
Line 212: Line 300:
 
* [[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 220: Line 309:
 
* [[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 230: Line 324:
 
* [[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)''
 +
* [[LTTng]] ''(Kernel and userspace tracing)''
 
* [[Setting up Zabbix|Zabbix]] ''(Monitor and track the status of network services and hardware)''
 
* [[Setting up Zabbix|Zabbix]] ''(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 -->
Line 271: Line 366:
 
== 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 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 300: Line 396:
 
* [[Disk Replication with DRBD]]
 
* [[Disk Replication with DRBD]]
 
-->
 
-->
 +
 +
 +
[[Category:Newbie]]

Latest revision as of 22:41, 6 April 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.


All of those linked pages here will help you make many things over the Alpine Operating System or Alpine OS.

Alpine are the main program named OS (means Operating System), that's runs on top of the machine/PC/laptop, and subsequently over this OS run the programs such like the internet web browser (firefox, chromium), and the web pages like "facebook" runs over that internet web browser.


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