Installation: Difference between revisions

From Alpine Linux
m (→‎Basics: Clarify 'what the later two' mean)
m (→‎Advanced: remove double comma after Qemu)
(21 intermediate revisions by 11 users not shown)
Line 16: Line 16:
</div>
</div>
<div style="margin-left:65px; background-color:#E0E9E9; border-style:solid; border-color:#606A82; border-width:0px; border-left-width:5px; min-height:55px; padding:5px;">
<div style="margin-left:65px; background-color:#E0E9E9; border-style:solid; border-color:#606A82; border-width:0px; border-left-width:5px; min-height:55px; padding:5px;">
[[Burning ISOs|Burn the ISO onto a blank CD]] using your favorite CD burning software.
If you have a CD drive from which you can boot, then [[Burning ISOs|burn the ISO onto a blank CD]] using your favorite CD burning software. Else [[Create a Bootable USB|create a bootable USB drive]].
</div>
</div>


Line 24: Line 24:
</div>
</div>
<div style="margin-left:65px; background-color:#9faecc; border-style:solid; border-color:#324065; border-width:0px; border-left-width:5px; min-height:55px; padding:5px;">
<div style="margin-left:65px; background-color:#9faecc; border-style:solid; border-color:#324065; border-width:0px; border-left-width:5px; min-height:55px; padding:5px;">
Boot from the CD, login as root with no password, and voilà! Enjoy Alpine Linux!
Boot from the CD or USB drive, login as root with no password, and voilà! Enjoy Alpine Linux!
</div>
</div>


Line 35: Line 35:
<dl>
<dl>
<dt>diskless mode
<dt>diskless mode
<dd>You'll boot from read-only medium such as the installation CD, a [[Create a Bootable USB|USB key]], or a [[Create a Bootable Compact Flash|Compact Flash card]]. {{Tip| To prepare either a USB or Compact Flash card, you can use the <code>[[setup-bootable]]</code> script; see the pages linked above for details.}} When you use Alpine in this mode, you need to use [[Alpine local backup|Alpine Local Backup (lbu)]] to save your modifications between reboots. That requires some writable medium, usually removable. {{Note| When the <code>[[setup-alpine]]</code> script asks for a disk, say "none". It will then prompt whether you'd like to preserve modifications on any writable medium.}}
<dd>You'll boot from read-only medium such as the installation CD, a [[Create a Bootable USB|USB drive]], or a [[Create a Bootable Compact Flash|Compact Flash card]]. {{Tip| To prepare either a USB or Compact Flash card, you can use the <code>[[setup-bootable]]</code> script; see the pages linked above for details.}} When you use Alpine in this mode, you need to use [[Alpine local backup|Alpine Local Backup (lbu)]] to save your modifications between reboots. That requires some writable medium, usually removable. (If your boot medium is, for example, a USB drive, you can save modifications there; you don't need a separate partition or drive.) See also [[Local APK cache]].
{{Note| When the <code>[[setup-alpine]]</code> script asks for a disk, say "none". It will then prompt whether you'd like to preserve modifications on any writable medium.}}
<dt>data mode
<dt>data mode
<dd>As in diskless mode, your OS is run from a read-only medium. However, here a writable partition (usually on a hard disk) is used to store the data in {{Path|/var}}. That partition is accessed directly, rather than copied into a tmpfs; so this is better-suited to uses where large amounts of data need to be preserved between reboots. {{Note| The <code>[[setup-alpine]]</code> script handles installing Alpine in this mode, too, when you supply a writable partition instead of "none", and request mode "data".}} This mode may be used for mailspools, database and log servers, and so on.
<dd>As in diskless mode, your OS is run from a read-only medium. However, here a writable partition (usually on a hard disk) is used to store the data in {{Path|/var}}. That partition is accessed directly, rather than copied into a tmpfs; so this is better-suited to uses where large amounts of data need to be preserved between reboots. {{Note| The <code>[[setup-alpine]]</code> script handles installing Alpine in this mode, too, when you supply a writable partition instead of "none", and request mode "data".}} This mode may be used for mailspools, database and log servers, and so on.
<dt>sys mode
<dt>sys mode
<dd>This is a [[Install to disk|traditional hard-disk install]] (see link for details). <!-- includes [[Installing Alpine on HDD overwriting everything]] --> Both the boot system and your modifications are written to the hard disk, in a standard Linux hierarchy. {{Note| The <code>[[setup-alpine]]</code> script handles installing Alpine in this mode, too, when you supply a writable partition instead of "none", and request mode "sys". By default, it will create three partions on your disk, for {{Path|/boot}}, {{Path|/}}, and {{Path|swap}}; however you can also <!--
<dd>This is a [[Install to disk|traditional hard-disk install]] (see link for details). <!-- includes [[Installing Alpine on HDD overwriting everything]] --> Both the boot system and your modifications are written to the hard disk, in a standard Linux hierarchy. {{Note| The <code>[[setup-alpine]]</code> script handles installing Alpine in this mode, too, when you supply a writable partition instead of "none", and request mode "sys". By default, it will create three partions on your disk, for {{Path|/boot}}, {{Path|/}}, and {{Path|swap}}; however you can also [[Setting up disks manually|partition your disk manually]].
  FIXME this styling is a hack until [[Template_talk:Note]] is resolved
--><span style{{=}}"text-decoration:underline">[[Setting up disks manually|partition your disk manually]]</span>.
}} This mode may be used for desktops, development boxes, and virtual servers.
}} This mode may be used for desktops, development boxes, and virtual servers.
     <!-- [[Native Harddisk Install 1.6]] Obsolete -->
     <!-- [[Native Harddisk Install 1.6]] Obsolete -->
Line 47: Line 46:


=== Advanced ===
=== Advanced ===
* [[Create UEFI boot USB]]
* [[Tutorials_and_Howtos#Storage|Setting up storage with RAID, LVM, LUKS encryption, iSCSI, or suchlike]]
* [[Tutorials_and_Howtos#Storage|Setting up storage with RAID, LVM, LUKS encryption, iSCSI, or suchlike]]
* [[Setting up disks manually]]
* [[Setting up disks manually]]
* [[Bootmanagers]]
* [[Partitioning and Bootmanagers]]
* [[Migrating data]]
* [[Migrating data]]
* Details about [[Alpine setup scripts]]
* Details about [[Alpine setup scripts]]


* [[Installing Alpine on HDD dualbooting|Install to HDD with dual-boot]]
* [[Installing Alpine on HDD dualbooting|Install to HDD with dual-boot]]
* [[Create A VirtualBox Guest with Grub and XFS]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
<!-- [[Installing Xubuntu using Alpine boot floppy]] Obsolete -->
<!-- [[Installing Xubuntu using Alpine boot floppy]] Obsolete -->
<!-- [[Installing Alpine Linux on USB Automated]] Obsolete -->
<!-- [[Installing Alpine Linux on USB Automated]] Obsolete -->
* [[Bootstrapping Alpine Linux]]


<!-- If you edit the following, please coordinate with Developer_Documentation#Configuring_your_system.  Note that these two sections are not exact duplicates. -->
<!-- If you edit the following, please coordinate with Developer_Documentation#Configuring_your_system.  Note that these two sections are not exact duplicates. -->
* [[Installing Alpine Linux in a chroot]]
* [[Installing Alpine Linux in a chroot]]
 
* [[Install Alpine on LXC]]
* Install Alpine on [[Install Alpine on VirtualBox|VirtualBox]], [[Install Alpine on VMware|VMware]], [[Install Alpine on coLinux|coLinux]], [[Qemu]], <!-- includes [[Install Alpine in Qemu]], [[Running Alpine in Qemu Live mode]], [[Running Alpine Linux As a QEMU networked Guest]] --> or [[Install Alpine on Amazon EC2|Amazon EC2]]
* [[Install Alpine on LXD|Install Alpine on Ubuntu with LXD]]
* Install Alpine on [[Install Alpine on VirtualBox|VirtualBox]], [[Install Alpine on VMware|VMware]], [[Install Alpine on coLinux|coLinux]], [[Qemu]], <!-- includes [[Install Alpine in Qemu]], [[Running Alpine in Qemu Live mode]], [[Running Alpine Linux As a QEMU networked Guest]], --> [[Install Alpine on Amazon EC2|Amazon EC2]], or [[Install Alpine on Rackspace|RackSpace]]


* [[Xen Dom0]] ''(Setting up Alpine as a dom0 for Xen hypervisor)''
* [[Xen Dom0]] ''(Setting up Alpine as a dom0 for Xen hypervisor)''
** [[Xen Dom0 on USB or SD]]
* [[Xen Dom0 on USB or SD]]
** [[Create Alpine Linux PV DomU]]
* [[Create Alpine Linux PV DomU]]
** [[Xen LiveCD]]
* [[Xen LiveCD]]


* [[Setting up a basic vserver]]
* [[Setting up a basic vserver]]
Line 81: Line 85:
   <!-- [[Alpine Linux package management#Local_Cache|How to enable APK caching]] -->
   <!-- [[Alpine Linux package management#Local_Cache|How to enable APK caching]] -->
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)''
* [[Alpine local backup|Alpine local backup (lbu)]] ''(Permanently store your modifications in case your box needs reboot)''
** [[Back Up a Flash Memory Installation]]
** [[Back Up a Flash Memory Installation|Back Up a Flash Memory ("diskless mode") Installation]]
** [[Manually editing a existing apkovl]]
** [[Manually editing a existing apkovl]]
* [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
* [[Alpine Linux Init System|Init System (OpenRC)]] ''(Configure a service to automatically boot at next reboot)''
** [[Multiple Instances of Services]]
** [[Multiple Instances of Services]]
   <!-- [[Writing Init Scripts]] -->
   <!-- [[Writing Init Scripts]] -->
* [[Alpine setup scripts#setup-xorg-base|Setting up Xorg]]


* [[Upgrading Alpine]]
* [[Upgrading Alpine]]
Line 97: Line 102:
* [[Setting up a ssh-server]] ''(Using ssh is a good way to administer your box remotely)''
* [[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)''
* [[setup-acf]] ''(Configures ACF (webconfiguration) so you can manage your box through https)''
* [[Hosting services on Alpine]]''(Links to several mail/web/ssh server setup pages)''
* [[Changing passwords for ACF|Changing passwords]]
* [[Changing passwords for ACF|Changing passwords]]


<!-- [[Running glibc programs]] Installation and Dev -->
<!-- [[Running glibc programs]] Installation and Dev -->
* [[Setting the timezone]] ''(Not needed for the default musl- or uClibc-based installs)''


=== Further Help and Information ===
=== Further Help and Information ===

Revision as of 17:23, 25 February 2018

The following information will assist you with the installation of Alpine Linux.


Installation Quick-Start in 3 Easy Steps

1st

Download the latest stable-release ISO.


2nd

If you have a CD drive from which you can boot, then burn the ISO onto a blank CD using your favorite CD burning software. Else create a bootable USB drive.


3rd

Boot from the CD or USB drive, login as root with no password, and voilà! Enjoy Alpine Linux!


One of the first commands you might want to use is setup-alpine.

Installation Handbook

Basics

Alpine can be used in any of three modes:

diskless mode
You'll boot from read-only medium such as the installation CD, a USB drive, or a Compact Flash card.
Tip: To prepare either a USB or Compact Flash card, you can use the setup-bootable script; see the pages linked above for details.
When you use Alpine in this mode, you need to use Alpine Local Backup (lbu) to save your modifications between reboots. That requires some writable medium, usually removable. (If your boot medium is, for example, a USB drive, you can save modifications there; you don't need a separate partition or drive.) See also Local APK cache.
Note: When the setup-alpine script asks for a disk, say "none". It will then prompt whether you'd like to preserve modifications on any writable medium.
data mode
As in diskless mode, your OS is run from a read-only medium. However, here a writable partition (usually on a hard disk) is used to store the data in /var. That partition is accessed directly, rather than copied into a tmpfs; so this is better-suited to uses where large amounts of data need to be preserved between reboots.
Note: The setup-alpine script handles installing Alpine in this mode, too, when you supply a writable partition instead of "none", and request mode "data".
This mode may be used for mailspools, database and log servers, and so on.
sys mode
This is a traditional hard-disk install (see link for details). Both the boot system and your modifications are written to the hard disk, in a standard Linux hierarchy.
Note: The setup-alpine script handles installing Alpine in this mode, too, when you supply a writable partition instead of "none", and request mode "sys". By default, it will create three partions on your disk, for /boot, /, and swap; however you can also partition your disk manually.
This mode may be used for desktops, development boxes, and virtual servers.

Advanced

Post-Install

Further Help and Information