Tutorials and Howtos: Difference between revisions
(Deleting drafts. Commented out section with comment "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 fo") |
(Removing drafts with too few information (see previous edit)) |
||
Line 28: | Line 28: | ||
* [[Setting up Zaptel/Asterisk on Alpine]] | * [[Setting up Zaptel/Asterisk on Alpine]] | ||
* [[Freepbx on Alpine Linux]] | * [[Freepbx on Alpine Linux]] | ||
* [[FreePBX_V3]] ''(FreeSWITCH, Asterisk GUI web acces tool)'' | * [[FreePBX_V3]] ''(FreeSWITCH, Asterisk GUI web acces tool)'' | ||
Line 64: | Line 63: | ||
** [[Setting Up Apache with PHP]] | ** [[Setting Up Apache with PHP]] | ||
** [[Apache authentication: NTLM Single Signon]] | ** [[Apache authentication: NTLM Single Signon]] | ||
* [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)'' <!-- solution, Server --> | * [[High Availability High Performance Web Cache]] ''(uCarp + HAProxy for High Availability Services such as Squid web proxy)'' <!-- solution, Server --> | ||
* [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)'' | * [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)'' | ||
** [[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 --> | ** [[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]] | * [[Setting up Explicit Squid Proxy]] | ||
* [[Drupal]] ''(Content Management System (CMS) written in PHP)'' | * [[Drupal]] ''(Content Management System (CMS) written in PHP)'' | ||
* [[WordPress]] ''(Web software to create website or blog)'' | * [[WordPress]] ''(Web software to create website or blog)'' | ||
Line 84: | Line 80: | ||
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)'' | * [[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)'' | ** [[HOWTO OpenSSH 2FA with password and Google Authenticator]] ''(A simple two factor setup for OpenSSH)'' | ||
* [[Configure OpenLDAP]] ''(Installing and configuring the Alpine package for OpenLDAP)'' | * [[Configure OpenLDAP]] ''(Installing and configuring the Alpine package for OpenLDAP)'' | ||
* [[Setting up a nfs-server]] | * [[Setting up a nfs-server]] | ||
Line 93: | Line 88: | ||
* [[Pastebin]] ''(Pastebin software application)'' | * [[Pastebin]] ''(Pastebin software application)'' | ||
* [[Setting up Transmission (bittorrent) with Clutch WebUI]] | * [[Setting up Transmission (bittorrent) with Clutch WebUI]] | ||
* [[Patchwork]] ''(Patch review management system)'' | * [[Patchwork]] ''(Patch review management system)'' | ||
* [[Redmine]] ''(Project management system)'' | * [[Redmine]] ''(Project management system)'' | ||
Line 99: | Line 93: | ||
* [[OsTicket]] ''(Ticket system)'' | * [[OsTicket]] ''(Ticket system)'' | ||
* [[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)'' | ||
* [[Cgit]] | * [[Cgit]] | ||
* [[Roundcube]] ''(Webmail system)'' | * [[Roundcube]] ''(Webmail system)'' | ||
* [[Glpi]] ''(Manage inventory of technical resources)'' | * [[Glpi]] ''(Manage inventory of technical resources)'' | ||
* [[How to setup a Alpine Linux mirror]] | * [[How to setup a Alpine Linux mirror]] | ||
* [[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}})'' | * [[How To Setup Your Own IRC Network]] ''(Using {{Pkg|charybdis}} and {{Pkg|atheme-iris}})'' | ||
Line 120: | Line 110: | ||
=== Monitoring === | === Monitoring === | ||
* [[Traffic monitoring]] <!-- Networking and Monitoring --> | * [[Traffic monitoring]] <!-- Networking and Monitoring --> | ||
* [[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)]] | ||
* [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)'' | * [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)'' | ||
* [[Zabbix|Zabbix - the professional complete manager]] ''(Monitor and track the status of network services and hardware)'' | * [[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 --> | ||
* [[Setting Up Fprobe And Ntop|Ntop]] ''(NetFlow collection and analysis using a remote fprobe instance)'' <!-- Networking and Monitoring --> | * [[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 --> | * [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' <!-- Monitoring and Security --> | ||
* [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' <!-- Networking and Server, <== Using squark-auth-snmp --> | * [[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)'' | ||
* [[Piwik]] ''(A real time web analytics software program)'' | * [[Piwik]] ''(A real time web analytics software program)'' | ||
* [[Awstats]] ''(Free log file analyzer)'' | * [[Awstats]] ''(Free log file analyzer)'' | ||
* [[Dglog]] ''(Log analyzer for the web content filter DansGuardian)'' | * [[Dglog]] ''(Log analyzer for the web content filter DansGuardian)'' | ||
* [[Webmin]] ''(A web-based interface for Linux system)'' | * [[Webmin]] ''(A web-based interface for Linux system)'' | ||
* [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)'' | * [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)'' | ||
Line 149: | Line 129: | ||
* [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)'' | * [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)'' | ||
* [[Linfo]] | * [[Linfo]] | ||
* [[Setting up lm_sensors]] | * [[Setting up lm_sensors]] | ||
* [[ZoneMinder video camera security and surveillance]] | * [[ZoneMinder video camera security and surveillance]] | ||
Revision as of 13:15, 11 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
Applications
- Ansible (Configuration management)
- Setting up unbound DNS server
- Setting up nsd DNS server
- TinyDNS Format
Telephony
- Setting up Zaptel/Asterisk on Alpine
- Freepbx on Alpine Linux
- FreePBX_V3 (FreeSWITCH, Asterisk GUI web acces tool)
- 2600hz (FreeSWITCH, Asterisk GUI web access tool)
- Kamailio (SIP Server, formerly OpenSER)
- Small-Time Email with Exim and Dovecot (A simple configuration for your home network.)
- Hosting services on Alpine (Hosting mail, webservices and other services)
- ISP Mail Server HowTo
- 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
- Lighttpd
- Cherokee
- Nginx
- Apache
- High Availability High Performance Web Cache (uCarp + HAProxy for High Availability Services such as Squid web proxy)
- Setting up Transparent Squid Proxy (Covers Squid proxy and URL Filtering system)
- SqStat (Script to look at active squid users connections)
- Obtaining user information via SNMP (Using squark-auth-snmp as a Squid authentication helper)
- 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
- Kopano (Microsoft Outlook compatible Groupware)
Other Servers
- 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)
- Configure OpenLDAP (Installing and configuring the Alpine package for OpenLDAP)
- Setting up a nfs-server
- 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)
- Redmine (Project management system)
- Request-Tracker (Ticket system)
- OsTicket (Ticket system)
- Trac (Enhanced wiki and issue tracking system for software development projects)
- Cgit
- Roundcube (Webmail system)
- Glpi (Manage inventory of technical resources)
- How to setup a Alpine Linux mirror
- NgIRCd (Server for Internet Relay Chat/IRC)
- How To Setup Your Own IRC Network (Using charybdis and atheme-iris)
- OpenVCP (VServer Control Panel)
- Mahara (E-portfolio and social networking system)
- Using chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source
- Sending SMS using gnokii
- Internet Protocol television (IPTV)
- UniFi_Controller
- DNSCrypt-Proxy Encrypt and authenticate DNS calls from your system
- Odoo
Monitoring
- Traffic monitoring
- Setting up traffic monitoring using rrdtool (and snmp)
- Setting up monitoring using rrdtool (and rrdcollect)
- Cacti: traffic analysis and monitoring network (Front-end for rrdtool networking monitor)
- 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)
- Setting up NRPE daemon (Performs remote Nagios checks)
- Ntop (NetFlow collection and analysis using a remote fprobe instance)
- Cvechecker (Compare installed packages for Common Vulnerabilities Exposure)
- Obtaining user information via SNMP (Using squark-auth-snmp as a Squid authentication helper)
- SqStat (Script to look at active squid users connections)
- Piwik (A real time web analytics software program)
- Awstats (Free log file analyzer)
- 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
- ZoneMinder video camera security and surveillance
Backup and data migration
- Alpine local backup (lbu) (Permanently store your modifications in case your box needs reboot)
- Migrating data
- Rsnapshot - setting up periodic backups
Desktop
- Alpine and UEFI
- Default applications
- Desktop cloud
- EyeOS (Cloud Computing Desktop)
- Nextcloud (Self hostable cloud suite - Dropbox Alternative)
- Oneye (Cloud Computing Desktop - Dropbox Alternative)
- OwnCloud (Installing OwnCloud)
- Seafile: setting up your own private cloud
- Desktop environments and Window managers (overall information only)
- Printer Setup
- Remote Desktop Server
- Sound Setup
- Suspend on LID close
- Xorg Setup
Networking
- Bonding - Bond (or aggregate) multiple ethernet interfaces
- Bridge - Configuring a network bridge
- Configure Networking
- How to configure static routes
- Modem
- Multi ISP (Dual-ISP setup with load-balancing and automatic failover)
- PXE boot
- Satellite Internet Connection setup
- Wi-Fi
- Connecting to a wireless access point
- How to setup a wireless access point (Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network)
- Vlan
Networking applications
- Alpine Wall (a new firewall management framework)
- Freeradius Active Directory Integration
- GNUnet
- OpenVPN server (Allowing single users or devices to remotely connect to your network)
- OpenVSwitch
- Using Alpine on Windows domain with IPSEC isolation
- Wireguard
Other Architectures
ARM
Raspberry Pi
- Raspberry Pi - Bluetooth Speaker
- Raspberry Pi - Installation
- Raspberry Pi - Router with VPN
- Raspberry Pi - Router with VPN (IPv6)
- Raspberry Pi - Sys mode install
- 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
- Raspberry Pi Zero W - Wireless router (Setting up a firewalled, Wireless AP with wired network on a Pi Zero W)
IBM Z (IBM z Systems)
PowerPC
Post-Install
- CPU frequency scaling
- Enable Community repository (Providing additional packages)
- Enable Serial Console on Boot
- Init System (OpenRC) (Configure a service to automatically boot at next reboot)
- Oracle Java (installation)
- Package Management (apk) (How to add/remove packages on your Alpine)
- Running glibc programs
- Setting up a new user
- Upgrading Alpine
Remote Administration
- ACF
- ACF - changing passwords
- Generating SSL certs with ACF
- ACF - setup (Configures ACF (webconfiguration/webmin) so you can manage your box through https)
- ssh-server setup (Using ssh is a good way to administer your box remotely)
- OpenSSH 2FA (A simple two factor setup for OpenSSH)
Storage
Virtualization
- Docker
- Installing Alpine in a virtual machine
- 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
- Xen DomU (paravirtualized)
- Xen LiveCD
- Xen PCI Passthrough
Tutorials
Warning: Work in Progress: reorganizing as asked in oldid 16474
Miscellaneous
- Dynamic Multipoint VPN (DMVPN) combined with Small Office Services
- DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs
- Experiences with OpenVPN-client on ALIX.2D3
- Fault Tolerant Routing with Alpine Linux
- High Availability High Performance Web Cache (uCarp + HAProxy for High Availability Services such as Squid web proxy)
- High performance SCST iSCSI Target on Linux software Raid
- 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 2.x HowTo (Beta, please test)
- Replacing non-Alpine Linux with Alpine remotely
- Setting up A Network Monitoring and Inventory System (Nagios + OpenAudit and related components)
- Streaming Security Camera Video with VLC
Newbie corner
- Alpine newbie (overall information)
- Alpine newbie developer (Developers: compilers, IDEs and tools)
- How to get regular stuff working some notes on need-to-know topics
Servers
- Alpine production deploy
- Alpine production monitoring
- Kubernetes
- K8s Building a K8s Cluster on Alpine Linux