@@ -4,20 +4,21 @@ Void Linux provides packages and images for several ARM devices. Installing Void
44on such devices can be done in several ways:
55
66- [ Pre-built images] ( #pre-built-images ) : images that can be flashed directly
7- onto an SD card or other storage medium, but give you a limited partition
8- layout and require manual expansion if you wish to increase the partitions;
7+ onto an SD card or other storage medium, but which give you a limited
8+ partition layout, and require manual expansion if you wish to increase the
9+ size of the partitions;
910- [ Tarball installation] ( #tarball-installation ) : PLATFORMFS and ROOTFS tarballs
1011 that can be extracted to a previously prepared partition scheme;
1112- [ Chroot installation] ( #chroot-installation ) : follows most of the steps
1213 outlined in [ the chroot guide] ( ../chroot.md ) .
1314
14- Since most of the commands on this guide will be run on external storage, it is
15+ This guide also outlines [ configuration steps] ( #configuration ) that are mostly
16+ specific to such devices.
17+
18+ Since most of the commands in this guide will be run on external storage, it is
1519important to run [ sync(1)] ( https://man.voidlinux.org/sync.1 ) before removing the
1620device.
1721
18- Further [ configuration steps] ( #configuration ) that are mostly specific to such
19- devices are also outlined.
20-
2122## Installation
2223
2324If you are installing Void Linux on one of the ARM devices covered in the
@@ -27,46 +28,46 @@ thoroughly.
2728### Pre-built images
2829
2930After [ downloading and verifying] ( ../../index.md#downloading-installation-media )
30- an image, it can be flashed onto an SD card in ` /dev/mmcblk0 ` , for example, with
31- the [ cat(1)] ( https://man.voidlinux.org/cat.1 ) ,
32- [ pv(1)] ( https://man.voidlinux.org/pv.1 ) or
33- [ dd(1)] ( https://man.voidlinux.org/dd.1 ) command:
31+ an image, it can be written to the relevant media with
32+ [ cat(1)] ( https://man.voidlinux.org/cat.1 ) ,
33+ [ pv(1)] ( https://man.voidlinux.org/pv.1 ) , or
34+ [ dd(1)] ( https://man.voidlinux.org/dd.1 ) . For example, to flash it onto an SD
35+ card located at ` /dev/mmcblk0 ` :
3436
3537```
3638# dd if=<image>.img of=/dev/mmcblk0 bs=4M status=progress
3739```
3840
3941### Custom partition layout
4042
41- It is possible to customize an installation further, for example with a custom
42- partition layout, but it requires a more involved process. Two available options
43- are:
43+ Customizing an installation - for example, with a custom partition layout -
44+ requires a more involved process. Two available options are:
4445
4546- [ Tarball installation] ( #tarball-installation ) ; and
46- - [ Chroot installation] ( #chroot-installation )
47+ - [ Chroot installation] ( #chroot-installation ) .
4748
4849To prepare the storage for these installation methods, it is necessary to
49- partition the storage medium to then mount the partitions in the correct
50- mounting points.
50+ partition the storage medium and then mount the partitions at the correct mount
51+ points.
5152
52- The usual partitioning scheme for ARM devices requires at least two partitions
53- on a drive formatted with an MSDOS partition table:
53+ The usual partitioning scheme for ARM devices requires at least two partitions,
54+ on a drive formatted with an MS-DOS partition table:
5455
5556- one formatted as FAT32 with partition type ` 0c ` , which will be mounted on
5657 ` /boot ` ;
5758- one that can be formatted as any file system that Linux can boot from, such as
58- ext4, which will be mounted on ` / ` . If you are using an SD card, for example,
59- it might be interesting to create the ext4 file system with the
60- ` ^has_journal ` option , which disables journaling and might increase the
61- drive's life, at the cost of a higher chance of data loss.
59+ ext4, which will be mounted on ` / ` . If you're using an SD card, you can
60+ create the ext4 file system with the ` ^has_journal ` option - this disables
61+ journaling , which might increase the drive's life, at the cost of a higher
62+ chance of data loss.
6263
63- This can be done with the [ cfdisk(8) ] ( https://man.voidlinux.org/cfdisk.8 )
64- utility, for example .
64+ There are a variety of tools available for partitioning, e.g.
65+ [ cfdisk(8) ] ( https://man.voidlinux.org/cfdisk.8 ) .
6566
6667To access the newly created file systems, it is necessary to mount them. This
6768guide will assume that the second partition will be mounted on ` /mnt ` , but you
6869may mount it elsewhere. To mount these filesystems, you can use the commands
69- below, replacing the device names with the appropriate ones for your setup.
70+ below, replacing the device names with the appropriate ones for your setup:
7071
7172```
7273# mnt /dev/mmcblk0p2 /mnt
@@ -78,9 +79,8 @@ below, replacing the device names with the appropriate ones for your setup.
7879
7980First, [ download and verify] ( ../../index.md#downloading-installation-media ) a
8081PLATFORMFS or ROOTFS tarball for your desired platform and [ prepare your storage
81- medium] ( #preparing-your-storage ) . Then, it is necessary to unpack the tarball
82- onto the file system, which can be done using
83- [ tar(1)] ( https://man.voidlinux.org/tar.1 ) :
82+ medium] ( #preparing-your-storage ) . Then, unpack the tarball onto the file system
83+ using [ tar(1)] ( https://man.voidlinux.org/tar.1 ) :
8484
8585```
8686# tar xvfp <image>.tar.xz -C /mnt
@@ -98,12 +98,12 @@ PLATFORMFS or ROOTFS tarball for your desired platform and [prepare your storage
9898medium] ( #preparing-your-storage ) . Then, follow the [ XBPS chroot installation
9999steps] ( ../chroot.md#the-xbps-method ) using the appropriate architecture and base
100100packages, some of which are listed in the "[ Supported
101- platforms] ( ./platforms.md ) " page .
101+ platforms] ( ./platforms.md ) " section .
102102
103103Finally, follow the [ chroot configuration steps] ( ../chroot.md#configuration )
104104steps, but instead of using the [ chroot(1)] ( https://man.voidlinux.org/chroot.1 )
105- command to [ enter the chroot] ( ../chroot.md#entering-the-chroot ) , use the command
106- below :
105+ command to [ enter the chroot] ( ../chroot.md#entering-the-chroot ) , use the
106+ following command :
107107
108108```
109109# proot -q qemu-arm-static -r /mnt -w /
@@ -125,7 +125,7 @@ For the pre-built images and tarball installations, the `root` user password is
125125The ` /boot ` partition should be added to ` /etc/fstab ` , with an entry similar to
126126the one below. It is possible to boot without that entry, but updating the
127127kernel package in that situation can lead to breakage, such as being unable to
128- find kernel modules, which is essential for functionality such as wireless
128+ find kernel modules, which are essential for functionality such as wireless
129129connectivity. If you aren't using an SD card, replace ` /dev/mmcblk0p1 ` with the
130130appropriate device path.
131131
@@ -136,8 +136,8 @@ appropriate device path.
136136### System time
137137
138138Several of the ARM devices supported by Void Linux don't have battery powered
139- real time clocks (RTC ), which means they won't keep track of time once powered
140- off. This issue can present itself as HTTPS errors when browsing the web or
139+ real time clocks (RTCs ), which means they won't keep track of time once powered
140+ off. This issue can present itself as HTTPS errors when browsing the Web or
141141using the package manager. It is possible to set the time manually using the
142142[ date(1)] ( https://man.voidlinux.org/date.1 ) utility. In order to fix this issue
143143for subsequent boots, install and enable [ an NTP
@@ -148,11 +148,11 @@ the current time in a configuration file and restores it at boot, leading to a
148148better initial approximation of the current time, even without a network
149149connection.
150150
151- ** Warning** : Images from before 2019-11-09 might have an issue where the
152- installation of the ` chrony ` package, which comes as the default NTP daemon, is
153- incomplete, and the system will be missing the ` chrony ` user. This can be
154- checked in the output of the [ getent(1)] ( https://man.voidlinux.org/getent.1 )
155- command, which will be empty if it doesn't exist:
151+ ** Warning** : Images from before 2020-03-16 might have an issue where the
152+ installation of the ` chrony ` package, the default NTP daemon, is incomplete, and
153+ the system will be missing the ` chrony ` user. This can be checked in the output
154+ of the [ getent(1)] ( https://man.voidlinux.org/getent.1 ) command, which will be
155+ empty if it doesn't exist:
156156
157157```
158158$ getent group chrony
0 commit comments