Alpine Linux - User contributions [en]

TTY Autologin

2023-09-15T07:30:02Z

MarcoDG: minor edits

=By using agetty=

== How ==
Install {{pkg|agetty}}: {{cmd|# apk add agetty}}
Edit {{path|/etc/inittab}} to use agetty 
Example for the virtual terminal tty1: 
<code>tty1::respawn:/sbin/agetty --autologin root tty1 linux</code>

Example inittab entry for a serial terminal on ttys01: 
<code>ttyS0::respawn:/sbin/agetty --autologin root ttyS0 vt100</code>
{{tip|You can change the `tty1` or `ttyS0` to a different serial port or virtual terminal as you please. `root` can be changed to a different user as well. Finally the terminal type (`linux` and `vt100` in our examples) can be changed to a wide variety of serial terminals.}}

=By compiling your own autologin wrapper=

== How ==
# Writing a wrapper, called autologin, around {{path|/bin/login}} and moving it in {{path|/usr/sbin/}}
# Editing {{path|/etc/inittab}} specifying the use of {{path|/usr/sbin/autologin}} instead of {{path|/bin/login}}

== Prerequisites ==
* A C compiler (e.g. '''''{{pkg|gcc}}''''' or '''''{{pkg|tcc}}''''')
* The '''''{{pkg|musl-dev}}''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add gcc
# apk add musl-dev}}

== Writing the autologin.c program ==

Create a file in this example called autologin.c

{{cat|autologin.c|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The program makes a system call to execute the ''login'' binary (part of busybox) which will be searched in $PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, its username can be used instead.

== Compiling the autologin.c program ==
If using gcc:
{{Cmd|# gcc -o autologin autologin.c }}

Move the binary autologin to {{path|/usr/sbin}}
{{Cmd|# mv autologin /usr/sbin/}}

== Editing /etc/inittab ==

Open {{path|/etc/inittab}}

replace "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''" for each TTY you want to enable autologin.
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of {{path|/bin/login}}; in our case it is set to invoke {{path|/usr/sbin/autologin}}

==== Note ====
To perform such a replacement on all TTYs, the following command can be used:
{{Cmd|# sed -i 's@:respawn:/sbin/getty@:respawn:/sbin/getty -n -l /usr/sbin/autologin@g' /etc/inittab }}
* "'''@'''" is used as a delimiter
* The '''-i''' flag edits the file in-place

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the {{pkg|musl-dev}} package

== References ==
* [https://git.busybox.net/busybox/tree/init/init.c Busybox init source, substantial comments documenting /etc/inittab are at the bottom]
* [http://littlesvr.ca/linux-stuff/articles/autologinconsole/autologinconsole.php Linux-Stuff: Log in automatically to a console when Linux boots]
* [https://wiki.gumstix.com/index.php/AutoLogin AutoLogin - Gumstix User Wiki]
* [https://busybox.net/downloads/BusyBox.html#getty Busybox getty arguments]
* [https://github.com/util-linux/util-linux/blob/master/term-utils/agetty.8.adoc agetty(8) Manual Page]

TTY Autologin

2023-09-15T06:50:24Z

MarcoDG: Changing tcc to gcc cause tcc is on edge while gcc on main

=By using agetty=

== How ==
Install {{pkg|agetty}}: {{cmd|# apk add agetty}}
Edit {{path|/etc/inittab}} to use agetty 
Example for the virtual terminal tty1: 
<code>tty1::respawn:/sbin/agetty --autologin root tty1 linux</code>

Example inittab entry for a serial terminal on ttys01: 
<code>ttyS0::respawn:/sbin/agetty --autologin root ttyS0 vt100</code>
{{tip|You can change the `tty1` or `ttyS0` to a different serial port or virtual terminal as you please. `root` can be changed to a different user as well. Finally the terminal type (`linux` and `vt100` in our examples) can be changed to a wide variety of serial terminals.}}

=By compiling your own autologin wrapper=

== How ==
# Writing a wrapper, called autologin, around {{path|/bin/login}} and moving it in {{path|/usr/sbin/}}
# Editing {{path|/etc/inittab}} specifying the use of {{path|/usr/sbin/autologin}} instead of {{path|/bin/login}}

== Prerequisites ==
* A C compiler
* The '''''{{pkg|musl-dev}}''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add gcc
# apk add musl-dev}}

== Writing the autologin.c program ==

Create a file; in this example called autologin.c
{{Cmd|# vi autologin.c }}

Write into it the following C program.

{{cat|autologin.c|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The only thing it does is a system call to execute the ''login'' binary (part of busybox) which will be searched in $PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, its username can be used instead.

== Compiling the autologin.c program ==
If using gcc:
{{Cmd|# gcc -o autologin autologin.c }}

Move the binary autologin to {{path|/usr/sbin}}
{{Cmd|# mv autologin /usr/sbin/}}

== Editing /etc/inittab ==

Open {{path|/etc/inittab}}

{{Cmd|# vi /etc/inittab }}

replace "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''" for each TTY you want to enable autologin.
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of {{path|/bin/login}}; in our case it is set to invoke {{path|/usr/sbin/autologin}}

==== Note ====
To perform such a replacement on all TTYs, the following command can be used:
{{Cmd|# sed -i 's@:respawn:/sbin/getty@:respawn:/sbin/getty -n -l /usr/sbin/autologin@g' /etc/inittab }}
* "'''@'''" is used as a delimiter
* The '''-i''' flag edits the file in-place

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the {{pkg|musl-dev}} package
{{Cmd|# rm autologin.c
# apk del gcc musl-dev}}

== References ==
* [https://git.busybox.net/busybox/tree/init/init.c Busybox init source, substantial comments documenting /etc/inittab are at the bottom]
* [http://littlesvr.ca/linux-stuff/articles/autologinconsole/autologinconsole.php Linux-Stuff: Log in automatically to a console when Linux boots]
* [https://wiki.gumstix.com/index.php/AutoLogin AutoLogin - Gumstix User Wiki]
* [https://busybox.net/downloads/BusyBox.html#getty Busybox getty arguments]
* [https://github.com/util-linux/util-linux/blob/master/term-utils/agetty.8.adoc agetty(8) Manual Page]

Talk:TTY Autologin

2023-09-15T06:47:14Z

MarcoDG:

== Isn't this just reinventing the wheel? ==
<s>Instead of going through the trouble of compiling something, wouldn't it be much easier to <code>apk add {{pkg|agetty}}</code> (from main) and use the {{key|-a}} ({{key|--autologin}}) option?</s> –zcrayfish ([[User talk:zcrayfish|talk]]•[[Special:Contributions/zcrayfish|contribs]]•[[Special:EmailUser/zcrayfish|send email]]) 02:13, 11 September 2023 (UTC)
:Disregard because I edited the article to have both. (the agetty option was needed for the non-edge users in any case) –[[User:zcrayfish|zcrayfish]] ([[User talk:zcrayfish|talk]]•[[Special:Contributions/zcrayfish|contribs]]•[[Special:EmailUser/zcrayfish|send email]]) 08:32, 12 September 2023 (UTC)
::tcc is not a mandatory package, it is just a C compiler, I initially choose it because it is small (~1Mb) in contrast to gcc (>100Mb), but if the issue is that it is on edge, then it is enough to use gcc which is in main, simple as that. Also agetty is times larger then a mere system call. –[[User:MarcoDG |MarcoDG]] 08:39, 15 September 2023 (CET)

Talk:TTY Autologin

2023-09-15T06:46:27Z

MarcoDG:

TTY Autologin

2023-09-11T15:13:21Z

MarcoDG:

What follows is one from many different ways to get autologin.

== How ==
# Writing a wrapper, called autologin, around /bin/login and moving it in /usr/sbin/
# Editing /etc/inittab specifying the use of /usr/sbin/autologin instead of /bin/login

== Prerequisites ==
* A C compiler
* The '''''musl-dev''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing tcc
# apk add musl-dev }}

== Writing the autologin.c program ==

Create a file; in this example called autologin.c
{{Cmd|# vi autologin.c }}

Write into it the following C program.

{{ cmd|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The only thing it does is a system call to execute the ''login'' binary (part of busybox) which will be searched in PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, its username can be used instead.

== Compiling the autologin.c program ==
If using tcc:
{{Cmd|# tcc -o autologin autologin.c }}

Move the binary autologin to /usr/sbin
{{Cmd|# mv autologin /usr/sbin/ }}

== Editing /etc/inittab ==

Open /etc/inittab

{{Cmd|# vi /etc/inittab }}

replace "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''" for each TTY you want to enable autologin.
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of /bin/login; in our case it is set to invoke /usr/sbin/autologin

==== Note ====
To perform such a replacement on all TTYs, the following command can be used:
{{Cmd|# sed -i 's@:respawn:/sbin/getty@:respawn:/sbin/getty -n -l /usr/sbin/autologin@g' /etc/inittab }}
* "'''@'''" is used as a delimiter
* The '''-i''' flag edits the file in-place

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the '''musl-dev''' package
{{Cmd|# rm autologin.c
# apk del tcc
# apk del musl-dev}}

== References ==
# http://littlesvr.ca/linux-stuff/articles/autologinconsole/autologinconsole.php
# https://wiki.gumstix.com/index.php/AutoLogin

TTY Autologin

2023-09-10T20:00:12Z

MarcoDG:

What follows is one from many different ways to get autologin.

== How ==
# Writing a wrapper, called autologin, around /bin/login and moving it in /usr/sbin/
# Editing /etc/inittab specifying the use of /usr/sbin/autologin instead of /bin/login

== Prerequisites ==
* A C compiler
* The '''''musl-dev''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing tcc
# apk add musl-dev }}

== Writing the autologin.c program ==

Create a file; in this example called autologin.c
{{Cmd|# vi autologin.c }}

Write into it the following C program.

{{ cmd|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The only thing it does is a system call to execute the ''login'' binary (part of busybox) which will be searched in PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, the user username can be used instead.

== Compiling the autologin.c program ==
If using tcc:
{{Cmd|# tcc -o autologin autologin.c }}

Move the binary autologin to /usr/sbin
{{Cmd|# mv autologin /usr/sbin/ }}

== Editing /etc/inittab ==

Open /etc/inittab

{{Cmd|# vi /etc/inittab }}

replace each "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''"
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of /bin/login; in our case it is set to invoke /usr/sbin/autologin

==== Note ====
To perform such replacement the following command can be used:
{{Cmd|# sed -i 's@:respawn:/sbin/getty@:respawn:/sbin/getty -n -l /usr/sbin/autologin@g' /etc/inittab }}
* "'''@'''" is used as a delimiter
* The '''-i''' flag edits the file in-place

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the '''musl-dev''' package
{{Cmd|# rm autologin.c
# apk del tcc
# apk del musl-dev}}

== References ==
# http://littlesvr.ca/linux-stuff/articles/autologinconsole/autologinconsole.php
# https://wiki.gumstix.com/index.php/AutoLogin

TTY Autologin

2023-09-10T19:56:35Z

MarcoDG:

What follows is one from many different ways to get autologin.

== How ==
# Writing a wrapper, called autologin, around /bin/login and moving it in /usr/sbin/
# Editing /etc/inittab specifying the use of /usr/sbin/autologin instead of /bin/login

== Prerequisites ==
* A C compiler
* The '''''musl-dev''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing tcc
# apk add musl-dev }}

== Writing the autologin.c program ==

Create a file; in this example called autologin.c
{{Cmd|# vi autologin.c }}

Write into it the following C program.

{{ cmd|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The only thing it does is a system call to execute the ''login'' binary (part of busybox) which will be searched in PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, the user username can be used instead.

== Compiling the autologin.c program ==
If using tcc:
{{Cmd|# tcc -o autologin autologin.c }}

Move the binary autologin to /usr/sbin
{{Cmd|# mv autologin /usr/sbin/ }}

== Editing /etc/inittab ==

Open /etc/inittab

{{Cmd|# vi /etc/inittab }}

replace each "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''"
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of /bin/login; in our case it is set to invoke /usr/sbin/autologin

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the '''musl-dev''' package
{{Cmd|# rm autologin.c
# apk del tcc
# apk del musl-dev}}

== References ==
# http://littlesvr.ca/linux-stuff/articles/autologinconsole/autologinconsole.php
# https://wiki.gumstix.com/index.php/AutoLogin

TTY Autologin

2023-09-10T19:43:35Z

MarcoDG: Added references

What follows is one from many different ways to get autologin.

== How ==
# Writing a wrapper, called autologin, around /bin/login and moving it in /usr/sbin/
# Editing /etc/inittab specifying the use of /usr/sbin/autologin instead of /bin/login

== Prerequisites ==
* A C compiler
* The '''''musl-dev''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing tcc
# apk add musl-dev }}

== Writing the autologin.c program ==

Create a file; in this example called autologin.c
{{Cmd|# vi autologin.c }}

Write into it the following C program.

{{ cmd|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The only thing it does is a system call to execute the ''login'' binary (part of busybox) which will be searched in PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, the user username can be used instead.

== Compiling the autologin.c program ==
If using tcc:
{{Cmd|# tcc -o autologin autologin.c }}

Move the binary autologin to /usr/sbin
{{Cmd|# mv autologin /usr/sbin/ }}

== Editing /etc/inittab ==

{{Cmd|# sed -i 's@:respawn:/sbin/getty@:respawn:/sbin/getty -n -l /usr/sbin/autologin@g' /etc/inittab }}

The above command:
* replaces "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''"
* "'''@'''" is used as a delimiter
* The '''-i''' flag edits the file in-place
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of /bin/login; in our case it is set to invoke /usr/sbin/autologin

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the '''musl-dev''' package
{{Cmd|# rm autologin.c
# apk del tcc
# apk del musl-dev}}

== References ==
# http://littlesvr.ca/linux-stuff/articles/autologinconsole/autologinconsole.php
# https://wiki.gumstix.com/index.php/AutoLogin

Tutorials and Howtos

2023-09-10T19:32:46Z

MarcoDG: Adding the just created "TTY Autologin" page in "Miscellaneous"

{{Todo|This material has been re-organized..., but grouping should be checked: '''Howtos are smaller articles''' and '''tutorials are more detailed document'''}}

[[Image:package_edutainment.svg|right|link=]]
{{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.

'''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]].

{{Clear}}

= Howtos =

== Applications ==

=== Miscellaneous ===

* [[Ansible]] ''(Configuration management)''

=== Monitoring ===

* [[Awstats]] ''(Free log file analyzer)''
* [[Cacti: traffic analysis and monitoring network]] ''(Front-end for rrdtool networking monitor)''
* [[Cvechecker]] ''(Compare installed packages for Common Vulnerabilities Exposure)'' 
* [[Linfo]]
* [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
* [[PhpSysInfo]] ''(A simple application that displays information about the host it's running on)''
* [[Matomo]] ''(A real time web analytics software program)''
* [[Setting up A Network Monitoring and Inventory System]] ''(Nagios + OpenAudit and related components)'' 
** [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)'' 
* [[Setting Up Fprobe And Ntop|Ntop]] ''(NetFlow collection and analysis using a remote fprobe instance; for alpine 3.10-3.12 only)'' 
* [[Setting up lm_sensors]]
* [[SqStat]] ''(Script to look at active squid users connections)''
* [[Traffic monitoring]] 
** [[Setting up monitoring using rrdtool (and rrdcollect)]]
** [[Setting up traffic monitoring using rrdtool (and snmp)]] 
* [[Zabbix|Zabbix - the professional complete manager]] ''(Monitor and track the status of network services and hardware)''
* [[ZoneMinder video camera security and surveillance]]

=== Networking ===

* Alpine Wall ''(a new firewall management framework)''
** [[Alpine Wall]]
** [https://git.alpinelinux.org/awall/about/ Alpine Wall User's Guide]
** [[How-To Alpine Wall]]
* [[Freeradius Active Directory Integration]]
* [[GNUnet]]
* [[Setting up a OpenVPN server|OpenVPN server]] ''(Allowing single users or devices to remotely connect to your network)''
* [[OpenVSwitch]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Configure a Wireguard interface (wg)|Wireguard]]

=== Telephony ===

* [[FreePBX|FreePBX on Alpine Linux]]
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Kamailio]] ''(SIP Server, formerly OpenSER)''

== Backup and data migration ==

* [[Alpine local backup|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]]
* [[Migrating data]]
* [[Rsnapshot]] - setting up periodic backups

== Desktop ==

* [[Alpine and UEFI]]
* [[Default applications]]
* Desktop cloud
** [[Nextcloud]] ''(Self hostable cloud suite - Dropbox Alternative)''
* [[Desktop environments and Window managers]] (overall information only)
* [[Printer Setup]]
* [[Remote Desktop Server]]
* Sound Systems
** [[ALSA]]
** [[PipeWire]]
** [[PulseAudio]]
* [[Suspend on LID close]]
* [[Alpine setup scripts#setup-xorg-base|Xorg Setup]]

== Networking ==

* [[Bluetooth]] - Instructions for installing and configuring Bluetooth
* [[Bonding]] - Bond (or aggregate) multiple ethernet interfaces
* [[Bridge]] - Configuring a network bridge
** [[Bridge wlan0 to eth0]]
* [[Configure Networking]]
* [[How to configure static routes]]
* Modem
** [[Using HSDPA modem]]
** [[Using serial modem]]
* [[Multi ISP]] ''(Dual-ISP setup with load-balancing and automatic failover)''
* [[PXE boot]]
* Wi-Fi
** [[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]]

== Other Architectures ==

=== ARM ===

* [[Alpine on ARM]]

==== Raspberry Pi ====

* [[Raspberry Pi Bluetooth Speaker|Raspberry Pi - Bluetooth Speaker]]
* [[Raspberry Pi|Raspberry Pi - Installation]]
* [[Linux Router with VPN on a Raspberry Pi|Raspberry Pi - Router with VPN]]
* [[Linux Router with VPN on a Raspberry Pi (IPv6)|Raspberry Pi - Router with VPN (IPv6)]]
* [[Classic install or sys mode on Raspberry Pi|Raspberry Pi - Sys mode install]]
* [[RPI Video Receiver|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]]
* [[How to set up Alpine as a wireless router|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) ===

* [[s390x|s390x - Installation]]

=== PowerPC ===

* [[Ppc64le|Powerpc64le - Installation]]

== Post-Install ==

* [[CPU frequency scaling]]
* [[Repositories#Enabling_the_community_repository|Enable Community repository]] ''(Providing additional packages)''
* [[Enable Serial Console on Boot]]
* [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
** [[Multiple Instances of Services|Init System - Multiple Instances of Services]]
** [[Writing Init Scripts|Init System - Writing Init Scripts]]
* [[Installing Oracle Java|Oracle Java (installation)]]
* [[IGMPproxy]]
* [[Alpine Linux package management|Package Management (apk)]] ''(How to add/remove packages on your Alpine)''
** [[Comparison with other distros|Package Management - Comparison with other distros]]
* [[Running glibc programs]]
* [[Setting up a new user]]
* [[Upgrading Alpine]]

== Remote Administration ==

* ACF
** [[Changing passwords for ACF|ACF - changing passwords]]
** [[Generating SSL certs with ACF]] 
** [[setup-acf| ACF - setup]] ''(Configures ACF (webconfiguration/webmin) so you can manage your box through https)''
* [[Setting up a SSH server]] ''(Using ssh is a good way to administer your box remotely)''
** [[HOWTO OpenSSH 2FA with password and Google Authenticator |OpenSSH 2FA]] ''(A simple two factor setup for OpenSSH)''
* [[OpenVCP]] ''(VServer Control Panel)''
* [[PhpMyAdmin]] ''(Web-based administration tool for MYSQL)''
* [[PhpPgAdmin]] ''(Web-based administration tool for PostgreSQL)''
* [[Webmin]] ''(A web-based interface for Linux system)''

== Server ==

* [[Hosting services on Alpine]] ''(Hosting mail, webservices and other services)''
* [[Hosting Web/Email services on Alpine]]

=== DNS ===

* [[DNSCrypt-Proxy]] ''Encrypt and authenticate DNS calls from your system''
* [[Setting up nsd DNS server]]
* [[Setting up unbound DNS server]]
* [[TinyDNS Format]]

=== HTTP ===

* [[Apache]]
** [[Apache with php-fpm]]
** [[Setting Up Apache with PHP]]
** [[Apache authentication: NTLM Single Signon]]
* [[Darkhttpd]]
* [[Lighttpd]]
** [[Lighttpd Advanced security]]
** [[Setting Up Lighttpd With FastCGI]]
* [[Nginx]]
** [[Nginx as reverse proxy with acme (letsencrypt)]]
** [[Nginx with PHP]]
* Squid Proxy
** [[Obtaining user information via SNMP]] ''(Using squark-auth-snmp as a Squid authentication helper)'' 
** [[Setting up Explicit Squid Proxy]]
** [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
** [[SqStat]] ''(Script to look at active squid users connections)''
* [[Tomcat]]

==== Hostable Content ====

* [[DokuWiki]]
* [[Drupal]] ''(Content Management System (CMS) written in PHP)''
* [[Kopano]] ''(Microsoft Outlook compatible Groupware)''
* [[Mahara]] ''(E-portfolio and social networking system)''
* [[MediaWiki]] ''(Free web-based wiki software application)''
* [[Pastebin]] ''(Pastebin software application)''
* [[WordPress]] ''(Web software to create website or blog)''

=== IRC ===

* [[How To Setup Your Own IRC Network]] ''(Using {{Pkg|charybdis}} and {{Pkg|atheme-iris}})''
* [[NgIRCd]] ''(Server for Internet Relay Chat/IRC)''

=== Mail ===

* Exim/Dovecot
** [[Small-Time Email with Exim and Dovecot]] ''(A simple configuration for your home network.)
** [[Setting up dovecot with imap and ssl]]
* [[relay email to gmail (msmtp, mailx, sendmail]]
* [[Roundcube]] ''(Webmail system)''
* [[Setting up postfix with virtual domains]]
* Server protection
** [[Protecting your email server with Alpine]]
** [[Setting up clamsmtp]]

=== Other Servers ===

* [[Chrony and GPSD | Chrony, gpsd, and a garmin LVC 18 as a Stratum 1 NTP source ]]
* [[Glpi]] ''(Manage inventory of technical resources)''
* [[How to setup a Alpine Linux mirror]]
* [[Setting up an NFS server|nfs-server]]
* [[Odoo]]
* [[Configure OpenLDAP | OpenLDAP]] ''(Installing and configuring the Alpine package for OpenLDAP)''
* [[Setting up a samba-ad-dc|samba-ad-dc]] ''(Active Directory compatible domain controller)''
* [[Setting up a Samba server|samba-server]] ''(standard file sharing)''
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[UniFi Controller]]

=== Software development ===

* [[Cgit]]
* [[OsTicket]] ''(Ticket system)''
* [[Patchwork]] ''(Patch review management system)''
* [[Redmine]] ''(Project management system)''
* [[Request Tracker]] ''(Ticket system)''
* [[Setting up trac wiki|Trac]] ''(Enhanced wiki and issue tracking system for software development projects)''

== Storage ==

* [[Setting up disks manually|Disk setup (manual)]]
* [[Filesystems]]
** [[Burning ISOs]]
* [[Setting up iSCSI|iSCSI Setup]]
** [[iSCSI Raid and Clustered File Systems]]
** [[Linux iSCSI Target (TCM)|iSCSI Target (TCM)/LinuxIO (LIO)]]
** [[Linux iSCSI Target (tgt)|User space iSCSI Target (tgt)]]
* [[Setting up Logical Volumes with LVM|LVM Setup]]
** [[Setting up LVM on GPT-labeled disks|LVM on GPT-labeled disks]]
** [[Installing on GPT LVM|LVM on GPT-labeled disks (updated)]]
** [[LVM on LUKS]]
* RAID
** [[Raid Administration]]
** [[Setting up a software RAID array]]
* ZFS
** [[Root on ZFS with native encryption]]
** [[Setting up ZFS on LUKS]]
** [[Setting up ZFS with native encryption]]
** [[ZFS scrub and trim]]

== Virtualization ==

* [[Docker]]
* [[Installing Alpine in a virtual machine]]
** [[Install Alpine on VMware ESXi]]
* [[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]]
** [[Create Alpine Linux PV DomU|Xen DomU (paravirtualized)]]
** [[Xen LiveCD]]
** [[Xen PCI Passthrough]]

= Tutorials =

== Miscellaneous ==

* [[TTY_Autologin|TTY Autologin]]
* [[Kexec|Faster rebooting with kexec]]
* [[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)''
* [[Linux iSCSI Target (TCM)]]
* [[ISP Mail Server 3.x HowTo]]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-service ISP mail server)''
* [[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 ==

* [[How to get regular stuff working]] ''some notes on need-to-know topics''

== Servers ==

* [[Alpine production deploy]]
** [[Production Web server: Lighttpd|Production web server: Lighttpd‎‎]]
** [[MySQL|Production database: MySQL]]
** [[Production LAMP system: Lighttpd + PHP + MySQL‎‎]]
* Alpine production monitoring
** [[Cacti: traffic analysis and monitoring network]]
** [[Zabbix|Zabbix - the professional complete manager]]
* Kubernetes
** [[K8s]] Building a K8s Cluster on Alpine Linux

TTY Autologin

2023-09-10T19:30:18Z

MarcoDG: Creating the "TTY autologin" page

What follows is one from many different ways to get autologin.

== How ==
# Writing a wrapper, called autologin, around /bin/login and moving it in /usr/sbin/
# Editing /etc/inittab specifying the use of /usr/sbin/autologin instead of /bin/login

== Prerequisites ==
* A C compiler
* The '''''musl-dev''''' package which contains the C standard library

==== Example on how to assolve the prerequisites: ====
{{Cmd|# apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing tcc
# apk add musl-dev }}

== Writing the autologin.c program ==

Create a file; in this example called autologin.c
{{Cmd|# vi autologin.c }}

Write into it the following C program.

{{ cmd|#include <unistd.h>

int main()
{
execlp( "login", "login", "-f", "root", 0);
}
}}

The only thing it does is a system call to execute the ''login'' binary (part of busybox) which will be searched in PATH.

As parameters are passed:
* '''-f''' flag which stands for "Do not authenticate (user already authenticated)"
* ''username'' in this example is ''root'' but if you created a new user, the user username can be used instead.

== Compiling the autologin.c program ==
If using tcc:
{{Cmd|# tcc -o autologin autologin.c }}

Move the binary autologin to /usr/sbin
{{Cmd|# mv autologin /usr/sbin/ }}

== Editing /etc/inittab ==

{{Cmd|# sed -i 's@:respawn:/sbin/getty@:respawn:/sbin/getty -n -l /usr/sbin/autologin@g' /etc/inittab }}

The above command:
* replaces "'':respawn:/sbin/getty''" with "'':respawn:/sbin/getty -n -l /usr/sbin/autologin''"
* "'''@'''" is used as a delimiter
* The '''-i''' flag edits the file in-place
* The getty's '''-n''' flag do not prompt the user for a login name
* The getty's '''-l''' flag invokes a custom login instead of /bin/login; in our case it is set to invoke /usr/sbin/autologin

== Cleaning up ==
It is possible to remove the autologin.c file, the C compiler and the '''musl-dev''' package
{{Cmd|# rm autologin.c
# apk del tcc
# apk del musl-dev}}

River

2023-08-30T15:47:44Z

MarcoDG: minor corrections: missing "river-doc" when it says "Install River and the documentation", without it it is impossible to perform the later "install -Dm0755 /usr/share/doc/river/examples/init -t ~/.config/river" and "adduser $USER input" was repeated twice.

[https://github.com/riverwm/river River] is a dynamic tiling [[Wayland]] compositor. An introduction to River can be found in [https://isaacfreund.com/blog/river-intro/ this blog post] by the developer for the 0.1.0 release.

This wiki was written starting from a fresh install using the Alpine 3.14.2 x86_64 extended .iso. The steps begin from the first reboot after running setup-alpine and performing a sys install to disk.

Many steps below were taken from the [[Sway|wiki entry for installing Sway]].

== Installation ==

Login as root.

Edit the repositories file and uncomment the community and testing repos. For 3.14.2, we need edge/community to get the correct software versions to support River:
{{Cat|/etc/apk/repositories|
#http://dl-cdn.alpinelinux.org/alpine/v3.17/main
#http://dl-cdn.alpinelinux.org/alpine/v3.17/community
http://dl-cdn.alpinelinux.org/alpine/edge/main
http://dl-cdn.alpinelinux.org/alpine/edge/community
http://dl-cdn.alpinelinux.org/alpine/edge/testing
}}

Install & configure {{Pkg|eudev}}:

{{Cmd|# apk update
# setup-devd udev}}

Then install the mesa gallium drivers:

{{Cmd|# apk add {{Pkg|mesa-dri-gallium}}}}

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Install River and the documentation:

{{Cmd|# apk add {{Pkg|river}} {{Pkg|river-doc}}}}

Install your choice of additional packages:

This list includes icons, fonts, and a terminal emulator named foot which is the default in River's sample init file that we will use later.

{{Cmd|# apk add {{Pkg|adwaita-icon-theme}} {{Pkg|foot}} {{Pkg|ttf-dejavu}}}}

Set seatd to start automatically at next boot and also manually start it for this session:

{{Cmd|# rc-update add {{Pkg|seatd}}
<nowiki>#</nowiki> rc-service {{Pkg|seatd}} start}}

Create a new user and update group membership:
{{Cmd|<nowiki># adduser $USER seat
# adduser $USER input
# adduser $USER video
</nowiki>}}

Logout and log back in as the new user.

== Running River ==

Before running River for the first time, copy the sample init file to ~/.config:

{{Cmd|install -Dm0755 /usr/share/doc/river/examples/init -t ~/.config/river}}

Set [[Wayland#XDG_RUNTIME_DIR|XDG_RUNTIME_DIR]] and then start River:

{{Cmd|1=river}}

[[Category:Desktop]]

== Notes ==

Following are a few notes that are most certainly not related to River whatsoever but rather discovered while running River so I'm tacking them onto the end of this wiki.

Firefox 89.0.1 complains on launch "glxtest: libpci missing", resolved by:

{{Cmd|apk add {{Pkg|pciutils-libs}}}}

Firefox 89.0.1 complains continuously "Unable to load hand2 from the cursor theme", resolved by:

{{Cmd|mkdir -p ~/.icons/default
ln -s /usr/share/icons/Adwaita/cursors .icons/default/cursors}}