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)
- 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
- Formatting HD/Floppy/Other
- Setting up iSCSI
- 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)
- 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)
Post-Install
- Package Management (apk) (How to add/remove packages on your Alpine)
- Alpine local backup (lbu) (Permanently store your modifications in case your box needs reboot)
- Init System (OpenRC) (Configure a service to automatically boot at next reboot)
- 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
- Freepbx on Alpine Linux
- FreePBX_V3 (FreeSWITCH, Asterisk GUI web acces tool)
- 2600hz (FreeSWITCH, Asterisk GUI web access tool)
- Kamailio (SIP Server, formerly OpenSER)
- 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
- 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)
- 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)
- 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
- 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
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