alpine/tutorial - added alpine setup script documentation

* add to the footer of most alpine setup pages too

alpine/alpine-boot-uefi-bios.md

@@ -288,4 +288,4 @@ Original started at: https://wiki.alpinelinux.org/w/index.php?title=Alpine_and_U
 ## See also
 
 * [README.md](README.md)
-
+* [alpine-setup-install-script.md](alpine-setup-install-script.md)

alpine/alpine-setup-install-script.md

@@ -0,0 +1,330 @@
+## Script setup-alpine
+
+This script is the main install program for Alpine linux, only can run as root.
+
+**Log in** as **root** and press enter. No password will be asked for if
+you're running from the boot image.
+
+![](https://wiki.alpinelinux.org/images/4/4f/Installation-alpine-alpine-setup-3-root-login.png)
+
+#### Environemnt variables before run
+
+At the bash prompt you can export those environment variables that the scripts 
+will handle it automatically:
+
+> **Note** The followin variables are only handle by `setup-disk` and `setup-bootable`
+
+* `BOOTFS` The filesystem to use on `/boot`, defaults to `ext4`, also 
+allows `ext2`, `ext3`, (flat) `btrfs`, `xfs`.
+* `BOOTLOADER` The bootloader to use. Defaults to `syslinux` until 3.12 and 
+since 3.14 defaults to `grub`, unless [UEFI](alpine-boot-uefi-bios.md) is used wil be forced to.
+* `BOOTSIZE` The size of `/boot` partition when the scripts try to automatically 
+created, its handle in Megs only.
+* `DISKLABEL` The type of partition table to use. Defaults to `dos`, unles `grub` 
+and [UEFI](alpine-boot-uefi-bios.md) is used, in which case `gpt` is setup.
+* `ROOTFS` The filesystem to use on `/`, defaults to `ext4`, also allows `ext2`, 
+`ext3`, (flat) `btrfs` and `xfs`.
+* `USE_EFI` Enable this to force using UEFI](alpine-boot-uefi-bios.md), so then 
+automatically the bootloader will be `grub` and partition wil be `gpt` then.
+
+> **Note** The following variables one only supported by the `setup-alpine` and others
+
+* `KEYMAPOPTS` setup the keymap layout pair for `setup-keymap`, by example `="us us"`
+* `HOSTNAMEOPTS` setup and parse for `setup-hostname` script, by example `="-n venenux"`
+* `TIMEZONEOPTS` setup the timezone for `setup-timezone` script like `="-z UTC"`
+* `PROXYOPTS` setup and parse option to `setup-proxy` script like `="http://webproxy:8080"`
+* `DISKOPTS` setup and parse option to `setup-disk` script like `="-m data /dev/sda"`
+
+> **Warning** Check the complete support of scripts from [Setup scripts](#setup-scripts) section.
+
+#### Running setup alpine script
+
+Run the **setup-alpine** script as shown in the image:
+
+![](https://wiki.alpinelinux.org/images/7/75/Installation-alpine-alpine-setup-4-setup-scripts.png)
+
+The script interactively walks the user through executing several auxiliary setup-* scripts, in the order shown below.
+
+The bracketed options represent example configuration choices, formatted as they 
+may be supplied when manually calling the independing [setup scripts](#setup-scripts), 
+or using a `setup-alpine` "answerfile" using the variable environments prevously cited.
+
+* `-h` Shows the up-to-date usage help message.
+* `-c <answerfile>` Create new answerfile with default choices, you then edit and tune up.
+* `-f <answerfile>` Use the new created answerfile, which may override some or all of the prompts.
+* `-q` Run in "quick mode", will setup less question adn assumes defaults for rest.
+
+##### Select keyboard layout
+
+Choose your **keyboard layout**. If you don't know your keyboard layout,
+choose **us**. Typically, for a Latin American environment, *es* is
+enough. For Russian (and maybe Cyrilic) *ru* is sufficient.
+
+![](https://wiki.alpinelinux.org/images/0/04/Installation-alpine-alpine-setup-4-setup-scripts-1-languaje-2.png)
+
+> **Note** check `setup-keymap` script at [Setup scripts](#setup-scripts) section.
+
+##### Select keyboard variant
+
+Choose your **keyboard variant**. If you don't know your keyboard
+variant, choose the default from the list. For example, the typical
+Latin American keymap is *es-winkeys*.
+
+![](Installation-alpine-alpine-setup-4-setup-scripts-1-languaje-2.png "Installation-alpine-alpine-setup-4-setup-scripts-1-languaje-2.png")
+
+> **Note** check `setup-keymap` script at [Setup scripts](#setup-scripts) section.
+
+##### Enter system hostname
+
+Host name, which will be the name of your computer. using **localhost**
+is enough and recommended for testing purposes because permits apply
+mostly to how-tos and tutorials on the wiki pages.
+
+![](Installation-alpine-alpine-setup-5-setup-scripts-hostname.png "Installation-alpine-alpine-setup-5-setup-scripts-hostname.png")
+
+> **Note** check `setup-hotname` script at [Setup scripts](#setup-scripts) section.
+
+##### Initialize network cards
+
+Choose your network card. Typically, you can just go with the default
+(press enter), a second question will ask about any other configuration.
+Type "no" then press enter to bypass the step to property set up after
+installation finished property.
+
+![](Installation-alpine-alpine-setup-6-setup-scripts-networking.png "Installation-alpine-alpine-setup-6-setup-scripts-networking.png")
+
+**IMPORTANT NOTE**: mostly in x86 and x64 ISO images we can let
+configurations for later, cos at the most modern the network card, the
+lest supported or still not well tested. Just type `done` and press
+enter. If you configured the wired interface, another question will be
+asked, **use dhcp?** Most people will use DHCP, so press enter again. If
+you have Internet connection from ISP, most settings are just DHCP, so
+all will be configured automatically.
+
+> **Note** check `setup-networking` script at [Setup scripts](#setup-scripts) section.
+
+> **Warning** check [../tutorials/alpine-tutorial-wifi-routering.md](../tutorials/alpine-tutorial-wifi-routering.md)
+
+##### Initialize network DNS
+
+The DNS will be automatically detected, if not, you will be asked ask
+for the server addresses. Type "" (empty string) for domain, then press
+enter. Later you can change it to `8.8.8.8` (or the DNS server address
+of your choice) as shown in the picture. Press enter to go to the next
+question:
+
+![](Installation-alpine-alpine-setup-7-setup-scripts-dns.png "Installation-alpine-alpine-setup-7-setup-scripts-dns.png")
+
+> **Note** check `setup-dns` script at [Setup scripts](#setup-scripts) section.
+
+##### Changing the root password
+
+Next a root password must be defined. You'll need to type it twice for
+confirmation as the picture shows. If it's too short you will get a
+warning, but your password will still work. Just retype it and go.  
+Note: **when you type, NO chars will be shown**.
+
+![](Installation-alpine-alpine-setup-8-setup-scripts-root-password.png "Installation-alpine-alpine-setup-8-setup-scripts-root-password.png")
+
+##### Which timezone to choose?
+
+Select a timezone, just press enter to use `UTC` when perform a single
+installation.
+
+![](Installation-alpine-alpine-setup-9-setup-scripts-timezone.png "Installation-alpine-alpine-setup-9-setup-scripts-timezone.png")
+
+> **Note** check `setup-timezone` script at [Setup scripts](#setup-scripts) section.
+
+##### Proxy chooser
+
+Then setup script will ask for proxy chooser.. just type `none` and then
+press enter
+
+![](Installation-alpine-alpine-setup-9-setup-scripts-proxy.png "Installation-alpine-alpine-setup-9-setup-scripts-proxy.png")
+
+> **Note** check `setup-proxy` script at [Setup scripts](#setup-scripts) section.
+
+##### Enter mirror number
+
+Then setup script will ask for repository mirror chooser.. just type
+`done` and then press enter, this will be configure many times later
+during usage of the system. Almost any tutorial of newbie pages will
+explain detailed so lest bypass using "done".
+
+![](Installation-alpine-alpine-setup-9-setup-scripts-repository-mirror.png "Installation-alpine-alpine-setup-9-setup-scripts-repository-mirror.png")
+
+> **Note** check `setup-apkrepos` script at [Setup scripts](#setup-scripts) section.
+
+##### Which ssh server?
+
+Installing an SSH server enables you to manage your machine remotely.
+OpenSSH is what the big distros use. Dropbear is a tiny SSH replacement.
+Recommended to type **openssh** and then press enter, because you able
+to connect using command line from Unix-like systems also is the offline
+available in all alpine installer images.
+
+![](Installation-alpine-alpine-setup-9-setup-scripts-ssh.png "Installation-alpine-alpine-setup-9-setup-scripts-ssh.png")
+
+> **Note** check `setup-sshd` script at [Setup scripts](#setup-scripts) section.
+
+##### Which NTP client to run?
+
+This is for time sync. Press enter to use the image offline. It can be
+changed after installation.
+
+![](Installation-alpine-alpine-setup-9-setup-scripts-time-ntp.png "Installation-alpine-alpine-setup-9-setup-scripts-time-ntp.png")
+
+> **Note** check `setup-ntp` script at [Setup scripts](#setup-scripts) section.
+
+
+#### Script setup-disk choose the target device
+
+This script its called at last from `setup-alpine`, it will mount a target device, 
+wil try to partitioned and copy the data to the target device.
+Those are the questions that wil be prompt if you just invoke by default:
+
+* **disk to use** "setup-disk" first question is to choose the disk destination .. 
+commonly `sda` (`/dev/sda`) are the hard disk and `sdb` the USB boot or CD/DVD image.
+* **mode to use** to choose the mode to install, `sys` for desktop/server, `data` for 
+live mixed mode, for more information check [data modes](#data-modes) section.
+* **erase the disk** This question will be promtp only if the disk already have 
+partitions, if you choose `y` will erase hole device and make new partitions.
+* **formatin and coping** later the script will copy all the data to the target 
+device, and the if you invoke from `setup-alpine` will call `setup-bootable` too.
+
+![](https://wiki.alpinelinux.org/images/9/99/Installation-alpine-alpine-setup-9-setup-disk-1-choose-disk.png)
+![](https://wiki.alpinelinux.org/images/c/c0/Installation-alpine-alpine-setup-9-setup-disk-2-format-disk.png)
+![](https://wiki.alpinelinux.org/images/a/a6/Installation-alpine-alpine-setup-9-setup-disk-3-7end.png)
+
+Check the [setup disk](#setup-disk) next section for specific script options
+
+After a while the installation will finish and alpine can be booted
+
+## Setup scripts
+
+#### setup-hostname
+
+`setup-hostname [-h] [-n hostname]`
+
+#### setup-interfaces
+
+`setup-interfaces [-i < interfaces-file]`
+
+#### setup-dns
+
+`setup-dns [-h] [-d domain name] [-n name server]`
+
+#### setup-disk
+
+This script its invoked by `setup-alpine` and as the same it support the 
+following enviroment variables:
+
+* `DEFAULT_DISK` The device disk to use as target installation, default to `=none`
+* `BOOTFS` The filesystem to use on `/boot`, defaults to `ext4`, also 
+allows `ext2`, `ext3`, (flat) `btrfs`, `xfs`.
+* `BOOTLOADER` The bootloader to use. Defaults to `syslinux` until 3.12 and 
+since 3.14 defaults to `grub`, unless [UEFI](alpine-boot-uefi-bios.md) is used wil be forced to.
+* `BOOTSIZE` The size of `/boot` partition when the scripts try to automatically 
+created, its handle in Megs only.
+* `DISKLABEL` The type of partition table to use. Defaults to `dos`, unles `grub` 
+and [UEFI](alpine-boot-uefi-bios.md) is used, in which case `gpt` is setup.
+* `ROOTFS` The filesystem to use on `/`, defaults to `ext4`, also allows `ext2`, 
+`ext3`, (flat) `btrfs` and `xfs`.
+* `USE_EFI` Enable this to force using UEFI](alpine-boot-uefi-bios.md), so then 
+automatically the bootloader will be `grub` and partition wil be `gpt` then.
+
+Those are the most working options to parse to the script, only supported if you 
+runs directly, not if you parse it to `setup-alpine` script:
+
+* `-m data | sys` set the install mode target; check the [data modes](#data-modes) section
+* `-q` Exit quietly if no disks are found
+* `-v` Verbose mode
+
+#### Data modes
+
+In "sys" mode, it's an installer, it permanently installs Alpine on the hole target partition, 
+in "data" mode, it provides a larger and persistent `/var` volume on the hole target partition.
+
+##### data - Data Disk Mode
+
+This mode runs OS from system RAM install media, but using `swap` and `/var` persistent.
+
+If this mode is selected, script creates two partitions on the selected storage 
+device asked by `setup-disk` firts question, `/var` and `swap` respectivelly. 
+this setup is used for special server deploys or minimal devices deploys like ARM devices.
+
+##### sys - System Disk Mode
+
+This is a traditional hard-disk install.
+
+If this mode is selected, script creates three partitions on the selected storage 
+device asked by `setup-disk` firts question, `/boot`, `/` and `swap` respectivelly. 
+this setup is used for generic desktop and development machines, or server bare metal deploys.
+
+##### ram - Diskless Mode
+
+This means the entire operating system with all applications are first loaded into RAM and 
+then only run from there. This is the method already used to boot the .iso installation images, 
+however setup-alpine can also configure the installed system to continue to boot like this 
+if "disk=none" is specified.
+
+Custom configurations and package installations may optionally still be preserved or "persist" 
+across reboots by using the Alpine local backup tool lbu.
+
+#### setup-timezone
+
+`setup-timezone [-z UTC | -z America/New_York | -p EST+5]`
+
+#### setup-proxy
+
+`setup-proxy [-hq] [PROXYURL]`
+
+#### setup-apkrepos
+
+`setup-apkrepos [-fhr] [REPO...]`
+
+#### setup-sshd
+
+`setup-sshd [-h] [-c dropbear|openssh|none]`
+
+#### setup-ntp
+
+`setup-ntp [-h] [busybox|openntpd|chrony|none]`
+
+#### setup-bootable
+
+Setup boot loaders, it's not invoked directly by `setup-alpine` but 
+it triggers by `setup-disk` if you choose sys or data mode.
+
+`setup-bootable [-usfk] source [dest]`
+
+* The argument source can be a directory or an ISO (will be mounted to MNT or /mnt) 
+or a URL (will be downloaded with WGET or wget). 
+* The argument dest can be a directory mountpoint, or will default 
+to `/media/usb` if not supplied.
+
+Those are the options:
+
+* `-k` Keep alpine_dev in syslinux.cfg; otherwise, replace with UUID.
+* `-u` Upgrade mode: keep existing syslinux.cfg and don't run syslinux
+* `-f` Overwrite syslinux.cfg even if -u was specified.
+* `-s` Force the running of syslinux even if -u was specified.
+* `-v` Verbose mode
+
+## Licensing clarifications
+
+**CC BY-NC-SA**: the project allows reusers to distribute, remix, adapt, and build upon the material 
+in any medium or format for noncommercial purposes only, and only so long as attribution is given 
+to the creators involved. If you remix, adapt, or build upon the material, you must license the modified 
+material under identical terms,  includes the following elements:
+
+* **BY**  – Credit must be given to the creator of each content respectivelly, starting at the first contributor.
+* **NC**  – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here!
+* **SA**  – Adaptations must be shared under the same terms, you must obey this terms and do not change it.
+
+https://codeberg.org/alpine/alpine-wiki/src/branch/main#license
+
+## See also
+
+* [README.md](README.md)
+* [alpine-boot-uefi-bios.md](alpine-boot-uefi-bios.md)

tutorials/Alpine_and_UEFI.md

@@ -117,5 +117,5 @@ Original started at: https://wiki.alpinelinux.org/w/index.php?title=Alpine_and_U
 ## See also
 
 * [README.md](README.md)
-* [alpine-newbie-install.md](../../newbie/alpine-newbie-install.md)
+* [alpine-setup-install-script.md](../alpine/alpine-setup-install-script.md)
 * [alpine/alpine-boot-uefi-bios.md](../alpine/alpine-boot-uefi-bios.md)

tutorials/alpine-install-from-cd-to-disk-pc-single-boot-only.md

@@ -251,6 +251,6 @@ https://codeberg.org/alpine/alpine-wiki/src/branch/main#license
 ## See also
 
 * [README.md](README.md)
-* [alpine-newbie-install.md](../../newbie/alpine-newbie-install.md)
+* [alpine-setup-install-script.md](../alpine/alpine-setup-install-script.md)
 * [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)
 * [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)

tutorials/alpine-install-from-cd-to-pcengine-apu-single-boot.md

@@ -178,6 +178,6 @@ https://codeberg.org/alpine/alpine-wiki/src/branch/main#license
 ## See also
 
 * [README.md](README.md)
-* [alpine-newbie-install.md](../../newbie/alpine-newbie-install.md)
+* [alpine-setup-install-script.md](../alpine/alpine-setup-install-script.md)
 * [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)
 * [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)

tutorials/alpine-install-from-usb-to-disk-pc-single-boot-only.md

@@ -258,6 +258,6 @@ https://codeberg.org/alpine/alpine-wiki/src/branch/main#license
 ## See also
 
 * [README.md](README.md)
-* [alpine-newbie-install.md](../../newbie/alpine-newbie-install.md)
+* [alpine-setup-install-script.md](../alpine/alpine-setup-install-script.md)
 * [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)
 * [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)