Tutorials and Howtos

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

• Alpine local backup (lbu) (Permanently store your modifications in case your box needs reboot)
  • Back Up a Flash Memory Installation
  • Manually editing a existing apkovl

• Setting up disks manually
• Setting up a software RAID array
• 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
• Formatting HD/Floppy/Other

• Setting up iSCSI
  • iSCSI Raid and Clustered File Systems
• Setting up NBD
• High performance SCST iSCSI Target on Linux software Raid (deprecated)
• Linux iSCSI Target (TCM)
• Disk Replication with DRBD

• Burning ISOs
• 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
• OpenVSwitch
• How to configure static routes

• 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 a good way to administer your box remotely)
• 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 (Allowing single users or devices to remotely connect to your network)
• Experiences with OpenVPN-client on ALIX.2D3

• Generating SSL certs with ACF
• Setting up unbound DNS server
• Setting up nsd DNS server
• TinyDNS Format
• Fault Tolerant Routing with Alpine Linux
• 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

Post-Install

• Package Management (apk) (How to add/remove packages on your Alpine)
  • Comparison with other distros
• Alpine local backup (lbu) (Permanently store your modifications in case your box needs reboot)
  • Back Up a Flash Memory Installation
  • Manually editing a existing apkovl
• Init System (OpenRC) (Configure a service to automatically boot at next reboot)
  • Multiple Instances of Services
• Setting up Xorg
• Upgrading Alpine

• 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
• Ansible (Configuration management)

• Enable Serial Console on Boot
• How to get regular stuff working some notes on need-to-know topics
• Installing Oracle Java
• Setting up periodic backups with rsnapshot

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

Desktop Environment

• Awesome(wm) Setup
• EyeOS (Cloud Computing Desktop)
• Gnome Setup
• MATE Setup
• Oneye (Cloud Computing Desktop - Dropbox Alternative)
• Owncloud (Cloud Computing Desktop - Dropbox Alternative)
  • (to be merged with OwnCloud (Your personal Cloud for storing and sharing your data on-line))
• Remote Desktop Server
• Suspend on LID close
• XFCE Setup and Desktop Ideas
• Installing Adobe flash player for Firefox
• Sound Setup
• Printer Setup
• Default applications

Raspberry Pi

• Raspberry Pi (Installation)
• Classic install or sys mode on Raspberry Pi
• RPI Video Receiver (network video decoder using Rasperry Pi and omxplayer)
• Linux Router with VPN on a Raspberry Pi
• Raspberry Pi 3 - Configuring it as wireless access point -AP Mode
• Raspberry Pi 3 - Setting Up Bluetooth

Applications

Telephony

• Setting up Zaptel/Asterisk on Alpine
  • Setting up Streaming an Asterisk Channel
• Freepbx on Alpine Linux
• 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
  • 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
  • Lighttpd Https access
  • Setting Up Lighttpd with PHP
  • Setting Up Lighttpd With FastCGI
• Cherokee
• Nginx
  • Nginx with PHP
  • Nginx as reverse proxy with acme (letsencrypt)
• Apache
  • Apache with php-fpm
  • Setting Up Apache with PHP
  • Apache authentication: NTLM Single Signon

• High Availability High Performance Web Cache (uCarp + HAProxy for High Availability Services such as Squid web proxy)

• Setting up Transparent Squid Proxy
  • 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

Other Servers

• Setting up a ssh-server (Using ssh is a good way to administer your box remotely)

• 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
  • Setting up a git repository server with gitolite and cgit
• Roundcube (Webmail system)
• Glpi (Manage inventory of technical resources)

• How to setup a Alpine Linux mirror
• Cups
• 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

Monitoring

• Setting up collectd
• Traffic monitoring
• Setting up traffic monitoring using rrdtool (and snmp)
• Setting up monitoring using rrdtool (and rrdcollect)
• Cacti (Front-end for rrdtool networking monitor)
• LTTng (Kernel and userspace tracing)
• Zabbix (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)
• Smokeping (Network latency monitoring)
  • Setting up MRTG and Smokeping to Monitor Bandwidth Usage and Network Latency
• Ntop (NetFlow collection and analysis using a remote fprobe instance)
• Cvechecker (Compare installed packages for Common Vulnerabilities Exposure)

• IP Accounting
• 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)
• 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

• 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

• DIY Fully working Alpine Linux for Allwinner and Other ARM SOCs
• Replacing non-Alpine Linux with Alpine remotely
• High performance SCST iSCSI Target on Linux software Raid
• Fault Tolerant Routing with Alpine Linux
• Experiences with OpenVPN-client on ALIX.2D3
• Building a cloud with Alpine Linux

• 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)
• High Availability High Performance Web Cache (uCarp + HAProxy for High Availability Services such as Squid web proxy)
• Setting up A Network Monitoring and Inventory System (Nagios + OpenAudit and related components)
• Streaming Security Camera Video with VLC
• Dynamic Multipoint VPN (DMVPN) combined with Small_Office_Services