Installation: Difference between revisions

From Alpine Linux
mNo edit summary
mNo edit summary
Line 14: Line 14:


# [http://alpinelinux.org/downloads Downloading] one of the latest stable-release ISOs, and comparing the downloaded image's <code>sha265sum</code> checksum to the one in the corresponding <code>*.sha256</code> checksum file, and to verify its GPG signature.
# [http://alpinelinux.org/downloads Downloading] one of the latest stable-release ISOs, and comparing the downloaded image's <code>sha265sum</code> checksum to the one in the corresponding <code>*.sha256</code> checksum file, and to verify its GPG signature.
# Either burning the ISO onto a blank CD with your favorite CD burning software, or creating a bootable USB drive.
# Either burning the ISO onto a blank CD with your favorite CD burning software, or flashing a USB storage device with it.
# Booting from the CD or USB drive, and logging in to the command line as user <code>root</code> with its initally empty password.
# Booting from the CD or USB drive, and logging in to the command line as user <code>root</code> with its initally empty password.
(For installing on ARM systems, see [[Alpine_on_ARM|Alpine on ARM]].)
(For installing on ARM systems, see [[Alpine_on_ARM|Alpine on ARM]].)


However, contrary to most other distributions, this initially booted Alpinelinux system (command line environment) is first copied entirely into RAM, and runs completely independent from the (slow) initial boot media.
However, contrary to most other distributions, this initially booted Alpinelinux system (command line environment) is first copied entirely into RAM, and then it runs completely in RAM, independent from the (slow) initial boot media.


And then, the <code>[[Alpine_setup_scripts|setup-alpine]]</code> script, and other tools, are used to configure the initial Alpinelinux system, install further packages, and prepare the system for the next boot.
A script called <code>[[Alpine_setup_scripts|setup-alpine]]</code>, and other tools, are available to configure the initial Alpinelinux system, to install further packages, and prepare the system for the next boot.


The system can boot into three general '''Alpinelinux runtime modes''':
The system is able boot into three general '''Alpinelinux runtime modes''':


'''diskless mode''' This is the default boot mode of the .iso images. With the <code>[[setup-alpine]]</code> selection "disk=none" the whole system runs from RAM. Customized configuration and package selections may still be preserved on permanent storage media by using <code>[[Alpine_local_backup|lbu]]</code>, the "local backup utility", and a [[Alpine_Linux_package_management#Local_Cache|local package cache]].  The boot device may, for example, be some read-only CD, a USB drive, a Compact Flash or SD card.
'''diskless mode''' This is the default boot mode of the .iso images. It is used with the <code>[[setup-alpine]]</code> selection "disk=none" and means the whole system runs from RAM. Customized configuration and package selections may still be preserved on permanent storage media by using <code>[[Alpine_local_backup|lbu]]</code>, the "local backup utility", and a [[Alpine_Linux_package_management#Local_Cache|local package cache]].  The boot device usually remains to be the initially used CD, USB drive, Compact Flash or SD card, possibly even set to read-only.


'''data mode''' This mode also runs mostly from RAM, with the exception of a selected writable data partition that gets mounted as {{Path|/var}}. This mode is better-suited when some larger amount of data needs to be preserved between reboots, e.g. mailspools, databases, or log files.
'''data mode''' This mode does still run mostly from RAM, with the exception of a selected writable data partition that gets mounted as {{Path|/var}}. This mode is preferable when larger amounts of variable user-data needs to be reliably preserved between reboots, e.g. servers with mailspools, databases, or important log files.


'''sys mode''' This is a traditional hard-disk install. The <code>[[setup-alpine]]</code> script defaults to creating three partitions on the selected disk, for {{Path|/boot}}, {{Path|swap}} and {{Path|/}} (filesystem root). This mode may, for example, be used for generic [[Desktops|desktop]], and development machines.
'''sys mode''' This is the traditional hard-disk install. If this mode is selected, the <code>[[setup-alpine]]</code> script defaults to create three partitions on the selected storage device, {{Path|/boot}}, {{Path|swap}} and {{Path|/}} (the filesystem root). This mode may be used for generic [[Desktops|desktop]] and development machines, for example.


== Additional Hints ==
== Additional Hints ==
Line 34: Line 34:
=== Booting from external devices ===
=== Booting from external devices ===


Insert the boot media to a proper drive or port of the computer and turn the machine on.
Insert the boot media to a proper drive or port of the computer, while it is turned off, and turn the machine on.
But depending on the computer it may be necessary, e.g. to press the `F12` key to get a selection to choose the media to boot from.
Depending on the computer it may be necessary to press e.g. the `F12` key to get a boot menu selection to choose the media to boot from.


=== Questions asked by <code>setup-alpine</code> ===
=== Questions asked by <code>setup-alpine</code> ===
Line 44: Line 44:
* Hostname (The name for the computer.)
* Hostname (The name for the computer.)
* Network options
* Network options
* DNS options: For privacy reasons, it is NOT recommended to use 8.8.8.8 (google servers).
* DNS options: For privacy reasons, it is NOT recommended to use central servers like 8.8.8.8 (google).
* Timezone
* Timezone
* Proxy ("None" to connect directly to the internet.)
* Proxy ("None" to connect directly to the internet.)

Revision as of 22:49, 8 May 2020

Please do help with sorting out the current wiki documentation, as soon as exploring around gives you a grasp good enough to sort out further things.



Typical Hardware Requirements

  • At least 100 MB of RAM (A graphical desktop system may require up to 1 GB minimum.)
  • A writable storage device. (Required for the "sys" or "data" runtime modes (see below). Optional for making backups in "diskless" mode.)

Install Procedure

Similar to many other distributions, the first installation steps usually consist of

  1. Downloading one of the latest stable-release ISOs, and comparing the downloaded image's sha265sum checksum to the one in the corresponding *.sha256 checksum file, and to verify its GPG signature.
  2. Either burning the ISO onto a blank CD with your favorite CD burning software, or flashing a USB storage device with it.
  3. Booting from the CD or USB drive, and logging in to the command line as user root with its initally empty password.

(For installing on ARM systems, see Alpine on ARM.)

However, contrary to most other distributions, this initially booted Alpinelinux system (command line environment) is first copied entirely into RAM, and then it runs completely in RAM, independent from the (slow) initial boot media.

A script called setup-alpine, and other tools, are available to configure the initial Alpinelinux system, to install further packages, and prepare the system for the next boot.

The system is able boot into three general Alpinelinux runtime modes:

diskless mode This is the default boot mode of the .iso images. It is used with the setup-alpine selection "disk=none" and means the whole system runs from RAM. Customized configuration and package selections may still be preserved on permanent storage media by using lbu, the "local backup utility", and a local package cache. The boot device usually remains to be the initially used CD, USB drive, Compact Flash or SD card, possibly even set to read-only.

data mode This mode does still run mostly from RAM, with the exception of a selected writable data partition that gets mounted as /var. This mode is preferable when larger amounts of variable user-data needs to be reliably preserved between reboots, e.g. servers with mailspools, databases, or important log files.

sys mode This is the traditional hard-disk install. If this mode is selected, the setup-alpine script defaults to create three partitions on the selected storage device, /boot, swap and / (the filesystem root). This mode may be used for generic desktop and development machines, for example.

Additional Hints

Booting from external devices

Insert the boot media to a proper drive or port of the computer, while it is turned off, and turn the machine on. Depending on the computer it may be necessary to press e.g. the `F12` key to get a boot menu selection to choose the media to boot from.

Questions asked by setup-alpine

The setup-alpine script will ask to configure several things, including:

  • Keyboard map (e.g. us and variant of us-nodeadkeys)
  • Hostname (The name for the computer.)
  • Network options
  • DNS options: For privacy reasons, it is NOT recommended to use central servers like 8.8.8.8 (google).
  • Timezone
  • Proxy ("None" to connect directly to the internet.)
  • SSH (Openssh is part of the default images.)
  • NTP (Chrony is part of the default images.)
  • Mode (Select between "diskless", "data" or "sys" as described above.)


Booting and using the new system

After the installation is completed, depending on the run mode, the initial installation media may be removed and the system may be rebooted from the newly installed device, to confirm that everything works.

The commands needed are poweroff or reboot.



Further Documentation

A way, and an example, to make the stock ISO images load a local backup (apkovl and packages) when booting, can be found in How_to_make_a_custom_ISO_image. (Debian's grub-imageboot package is another way to boot .iso files directly.)

Post-Install

Further Help and Information

See Also

  1. Newbie_Alpine_Ecosystem
  2. Alpine newbie install manual
  3. https://mckayemu.github.io/alpineinstalls/ All informatin for Spanish users