Tutorials and Howtos: Difference between revisions

From Alpine Linux
m (formatting of intro)
(Major reorg/expansion, content migrated from User:Dubiousjim/Tutorials and Howtos)
Line 1: Line 1:
[[Image:package_edutainment.svg|left|link=]]
[[Image:package_edutainment.svg|right|link=]]
{{TOC right}}'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''
{{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.
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.
Line 8: Line 9:
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]].
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]].


=System=
{{Clear}}
==Initial setup==
== Storage ==
* [[Setting up a basic vserver]]
 
* [[Alpine Linux package management#Local_Cache | How to enable APK caching]]
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)'' <!-- Installation and Storage -->
* [[Enable Serial Console on Boot]]
** [[Back Up a Flash Memory Installation]] <!-- Installation and Storage -->
* [[Upgrading to Edge]]
** [[Manually editing a existing apkovl]]
==Storage==
 
* [[Setting up disks manually]] <!-- Installation and Storage -->
* [[Setting up a software raid1 array]]
** [[Setting up a /var partition on software IDE raid1]] <!-- Obsolete, Installation and Storage -->
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Setting up Logical Volumes with LVM]]
* [[Setting up a software raid1 array]]
* [[Formatting HD/Floppy/Other]] <!-- just a stub -->
* [[iSCSI Target and Initiator Configuration]]
 
* [[iSCSI Raid and Clustered File Systems]]
* [[Setting up iSCSI]]
* [[High performance SCST iSCSI Target on Linux software Raid]]
** [[iSCSI Raid and Clustered File Systems]]
==Networking==
* [[High performance SCST iSCSI Target on Linux software Raid]] <!-- solution -->
* [[Disk Replication with DRBD]] <!-- draft -->
 
* [[Burning ISOs]] <!-- doesn't exist yet -->
 
== Networking ==
 
* [[Configure Networking]]
* [[Configure Networking]]
* [[Howto Configure a Network Bridge]]
* [[Connecting to a wireless access point]]
* [[Howto Configure static routes]]
* [[How to configure static routes]]
* [[How to configure a network bridge]]
** [[Setting Up a bridge]]
 
* [[Using serial modem]]
* [[Using serial modem]]
* [[Using HSDPA modem]]
* [[Using HSDPA modem]]
* [[Setting up Satellite Internet Connection]]
* [[Setting up Satellite Internet Connection]]
* [[Connecting to a wireless accesspoint]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
==Desktop Environment==
* [[XFCE Setup]]
* [[Gnome Setup]]
==Misc==
* [[Manually editing a existing apkovl]]
* [[Changing passwords for ACF]]
* [[Formatting HD/Floppy/Other]]
* [[Back Up a Flash Memory Installation]]


=Applications=
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)'' <!-- Server and Networking -->
==Networking==
* [[How to setup a wireless access point]] ''(Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)''
* [[Setting up a OpenVPN-server with Alpine]]
* [[Setting up a OpenVPN server with Alpine]] ''(Allowing single users or devices to remotely connect to your network)''
* [[Setting up a ssh-server]]
<!-- [[Using Racoon for Remote Sites]] is a different VPN tunnelling method, but that article is just a stub -->
* [[Generating SSL certs with ACF]]
* [[Experiences with OpenVPN-client on ALIX.2D3]] <!-- solution -->
* [[Setting up traffic monitoring using rrdtool (and snmp)]]
 
* [[Generating SSL certs with ACF]] <!-- Generating SSL certs with ACF 1.9 -->
* [[Setting up unbound DNS server]]
* [[Setting up unbound DNS server]]
* [[Setting up nsd DNS server]]
* [[Setting up nsd DNS server]]
* [[Setting up a git repository server with gitolite and cgit]]
* [[TinyDNS Format]]
* [[Fault Tolerant Routing with Alpine Linux]] <!-- solution -->
* [[Alpine Wall]] ''(Plans for a new firewall management framework)''
* [[Freeradius Active Directory Integration]]
 
== 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. -->
 
* [[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 local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)''
** [[Manually editing a existing apkovl]]
** [[Back Up a Flash Memory Installation]] <!-- new -->
* [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
** [[Multiple Instances of Services]]
  <!-- [[Writing Init Scripts]] -->
* [[Upgrading Alpine - v1.9.x|Upgrading Alpine]] using the stable or [[Edge|edge]] repositories
<!-- Obsolete
[[Upgrading Alpine|top]]
[[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)''
* [[setup-acf]] ''(Configures ACF (webconfiguration) so you can manage your box through https)''
* [[Changing passwords for ACF|Changing passwords]]
 
 
* [[Enable Serial Console on Boot]]
* [[Error message on boot: Address space collision: host bridge window conflicts with Adaptor ROM]]
 
== Desktop Environment ==
 
* [[XFCE Setup]] and [[Xfce Desktop|Desktop Ideas]]
* [[EyeOS]] ''(Cloud Computing Desktop)''
* [[Gnome Setup]]


==VoIP==
== Applications ==
 
=== Telephony ===
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Setting up Zaptel/Asterisk on Alpine]]
** [[Setting up Streaming an Asterisk Channel]]
* [[Freepbx on Alpine Linux]]
* [[Freepbx on Alpine Linux]]
==Web==
* [[FreePBX_V3]] ''(FreeSWITCH, Asterisk GUI web acces tool)''
* [[2600hz]] ''(FreeSWITCH, Asterisk GUI web access tool)''
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''
 
=== Mail ===
* [[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)''
* [[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]]
 
=== HTTP ===
* [[Lighttpd]]
** [[Lighttpd Https access]]
** [[Setting Up Lighttpd with PHP]]
** [[Setting Up Lighttpd With FastCGI]]
* [[Cherokee]]
* [[Cherokee]]
* [[Setting Up Lighttpd With FastCGI]]
* [[Nginx]]
* [[Apache authentication: NTLM Single Signon]]
* [[Apache]]
===Webapps===
** [[Apache authentication: NTLM Single Signon]]
* [[2600hz]] ''FreeSWITCH, Asterisk GUI web acces tool.''
 
* [[Awstats]] ''Free log file analyzer.''
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)'' <!-- solution, Server -->
* [[Setting up Cacti|Cacti]]
* [[Drupal]] ''Content Management System (CMS) written in PHP.''
* [[EyeOS]] ''Cloud Computing Desktop.''
* [[FreePBX_V3]] ''FreeSWITCH, Asterisk GUI web acces tool.''
* [[Glpi]] ''Information Resource-Manager.''
* [[MediaWiki]] ''Free web-based wiki software application''
* [[Setting Up Fprobe And Ntop|Ntop]] ''NetFlow collection and analysis using a remote fprobe instance''
* [[Pastebin]] ''Pastebin software application''
* [[Phpizabi]] ''Social Networking Platform.''
* [[PhpPgAdmin]] ''Web-based administration tool for PostgreSQL.''
* [[Phpmyadmin]] ''Web-based administration tool for MYSQL.''
* [[Piwik]] ''A real time web analytics software program.''
* [[Phpsysinfo]] ''A simple application that displays information about the host it's running on''
* [[Redmine]] ''Project management system ''
* [[Request-Tracker]] ''Ticket system''
* [[Roundcube]] ''Webmail system''
* [[Setting up Smokeping|Smokeping]] ''Network latency monitoring''
* [[Statusnet]] ''Microblogging Platform.''
* [[Sqstat]] ''Script to look active squid users connections.''
* [[Setting up trac wiki|Trac]] ''Enhanced wiki and issue tracking system for software development projects.''
* [[Webmin]] ''A web-based interface for Linux system.''
* [[WordPress]] ''Web software to create website or blog. ''
* [[Setting up Zabbix|Zabbix]]


==Mail==
* [[Setting up Transparent Squid Proxy]] <!-- draft -->
* [[Hosting services on Alpine]] ''(This applies to hosting mail, webservices and other services)''
** [[SqStat]] ''(Script to look at active squid users connections)''
** [[Setting up postfix with virtual domains]]
** [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' <!-- Networking and Server, <== Using squark-auth-snmp -->
** [[Protecting your email server with Alpine]]
 
** [[Hosting Web/Email services on Alpine]]
* [[Drupal]] ''(Content Management System (CMS) written in PHP)''
==Misc==
* [[WordPress]] ''(Web software to create website or blog)''
* [[Multiple Instances of Services]]
* [[MediaWiki]] ''(Free web-based wiki software application)''
* [[DokuWiki]]
 
=== Other Servers ===
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''
 
* [[Phpizabi]] ''(Social Networking Platform)''
* [[Statusnet]] ''(Microblogging Platform)''
* [[Pastebin]] ''(Pastebin software application)''
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[Freeradius Active Directory Integration]]
 
* [[Traffic monitoring]] ''(For Alpine Linux firewalls)''
* [[Redmine]] ''(Project management system)''
* [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)''
* [[Request-Tracker]] ''(Ticket system)''
* [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''
 
* [[Cgit]]
** [[Development using git:Cgit]] <!-- Proposed to merge this with [[Development using git:Developer repositories]] -->
** [[Setting up a git repository server with gitolite and cgit]] <!-- doesn't exist yet -->
* [[Roundcube]] ''(Webmail system)''
* [[Glpi]] ''(Manage inventory of technical resources)''
 
* [[How to setup a Alpine Linux mirror]]
* [[Cups]]
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''
* [[OpenVCP]] ''(VServer Control Panel)''
 
=== Monitoring ===
* [[Traffic monitoring]] <!-- Networking and Monitoring -->
* [[Setting up traffic monitoring using rrdtool (and snmp)]] <!-- Monitoring -->
* [[Setting up monitoring using rrdtool (and rrdcollect)]]
* [[Setting up Cacti|Cacti]] ''(Front-end for rrdtool networking monitor)''
* [[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 NRPE daemon]] ''(Performs remote Nagios checks)'' <!-- Networking and Monitoring -->
* [[Setting up Smokeping|Smokeping]] ''(Network latency monitoring)'' <!-- 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 -->
 
* [[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)''
 
* [[Piwik]] ''(A real time web analytics software program)''
* [[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)''
 
* [[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]]
* [[Setting up lm_sensors]]
* [[Screen on console]]
 
* [[Using espeak on Alpine Linux]]
== Others ==
* [[IPTV How To]]
 
* [[Pllua]]
* [[:Category:Shell]]
* [[Error message on boot: Address space collision: host bridge window conflicts with Adaptor ROM]]
* [[:Category:Multimedia]]
=Complete Solutions=
* [[:Category:Programming]]
 
== Complete Solutions ==
 
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[High performance SCST iSCSI Target on Linux software Raid]]
* [[Fault Tolerant Routing with Alpine Linux]]
* [[Fault Tolerant Routing with Alpine Linux]]
* [[Experiences with OpenVPN-client on ALIX.2D3]]
* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
** [[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)''
* [[High Availability High Performance Web Cache]] ''uCarp + HAProxy for High Availability Services such as Squid web proxy''
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)''
= Drafts =
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' <!-- draft -->
Currently unfinished docs.
 
* [[Install Alpine on coLinux]]
 
<!--
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 ==
Currently unfinished/works-in-progress.
* [[Using Racoon for Remote Sites]]
* [[Using Racoon for Remote Sites]]
* [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
* [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
** [[Obtaining user information via SNMP]] ''(Using the Squark Squid authentication helper)''
** [[Obtaining user information via SNMP]] ''(Using the Squark Squid authentication helper)'' [!-- no longer a draft --]
* [[Setting up Streaming an Asterisk Channel]]
* [[Setting up Streaming an Asterisk Channel]]
* [[Setting up A Network Monitoring and Inventory System]] ''((Nagios + OpenAudit and related components)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)''
* [[Intrusion Detection using Snort]] ''Installing and configuring Snort and related applications on Alpine 2.0.x''
* [[Intrusion Detection using Snort]] ''(Installing and configuring Snort and related applications on Alpine 2.0.x)''
* [[IP Accounting]] ''Installing and configuring pmacct for IP Accounting, Netflow/sFlow collector''
* [[IP Accounting]] ''(Installing and configuring pmacct for IP Accounting, Netflow/sFlow collector)''
* [[Howto Setup a Wireless Access Point]] ''Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network''
* [[Xen Dom0]] ''Setting up Alpine as a dom0 for Xen hypervisor''
* [[Disk Replication with DRBD]]
* [[Disk Replication with DRBD]]
 
-->
= Obsolete Docs =
Those are candidates for rewriting/removal.
* [[Bootstrapping Alpine on Soekris net4xxx]]
* [[Bootstrapping Alpine on PC Engines ALIX.3]]
* [[Installing XUbuntu using Alpine boot floppy]]

Revision as of 11:26, 26 March 2012

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.

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 Discussion.


Storage

Networking

Post-Install


Desktop Environment

Applications

Telephony

Mail

HTTP

  • Drupal (Content Management System (CMS) written in PHP)
  • WordPress (Web software to create website or blog)
  • MediaWiki (Free web-based wiki software application)
  • DokuWiki

Other Servers

  • Redmine (Project management system)
  • Request-Tracker (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

Others

Complete Solutions