Merge pull request #14 from gbcreation/archlinux-doc
Added Arch Linux ARM page
This commit is contained in:
Gauthier Provost
GitHub
commit
68797a221d
3 changed files with 103 additions and 0 deletions
100
docs/arch.md
Normal file
100
docs/arch.md
Normal file
|
|
@ -0,0 +1,100 @@
|
|||
This document is a guide for installing Arch Linux ARM on the Helios4.
|
||||
|
||||
**Arch Linux ARM** is a port of Arch Linux for ARM processors. Its design philosophy is simplicity and full control to the end user, and like its parent operating system Arch Linux, aims to be very Unix-like. More info [here](https://archlinuxarm.org/).
|
||||
|
||||
## Prerequisite
|
||||
|
||||
Refer to the following [section](/install/#what-you-need-before-you-start) of the Helios4 install guide.
|
||||
|
||||
## Arch Linux ARM image for Helios4
|
||||
|
||||
Arch Linux ARM can be installed on Helios4 using an image file containing both the **Arch Linux ARM system** and the **U-Boot** boot loader.
|
||||
|
||||
This image can be created using the `build-archlinux-img-for-helios4.sh` script provided by the [alarm-helios4-image-builder](https://github.com/gbcreation/alarm-helios4-image-builder) project, or you can use pre-built images provided by the same project. Each method is described below.
|
||||
|
||||
Once you get an image file, follow the instructions from the [Installing Arch Linux ARM on Helios4](#installing-arch-linux-arm-on-helios4) section below.
|
||||
|
||||
### Arch Linux ARM image builder
|
||||
|
||||
The `build-archlinux-img-for-helios4.sh` script provides an easy way to automatically create a bootable Arch Linux ARM image file for Helios4.
|
||||
|
||||
#### Requirements
|
||||
|
||||
The `build-archlinux-img-for-helios4.sh` script expects to be run on a **x86 system running [Arch Linux](https://archlinux.org)**. It needs `qemu-arm-static` to work. You can install it using the [qemu-user-static](https://aur.archlinux.org/packages/qemu-user-static/) or [qemu-user-static-bin](https://aur.archlinux.org/packages/qemu-user-static-bin/) packages from the AUR.
|
||||
|
||||
#### Usage
|
||||
|
||||
!!! note
|
||||
This script needs to execute commands as superuser. If not run as root, it will re-run itself using sudo.
|
||||
|
||||
```shell
|
||||
$ git clone https://github.com/gbcreation/alarm-helios4-image-builder.git
|
||||
$ cd alarm-helios4-image-builder
|
||||
$ sh ./build-archlinux-img-for-helios4.sh
|
||||
```
|
||||
|
||||
Once the Arch Linux ARM image is created, go to [Installing Arch Linux ARM on Helios4](#installing-arch-linux-arm-on-helios4) section.
|
||||
|
||||
### Pre-built images
|
||||
|
||||
You can download [here](https://github.com/gbcreation/alarm-helios4-image-builder/releases) pre-built Arch Linux ARM images for Helios4.
|
||||
|
||||
```shell
|
||||
$ wget https://github.com/gbcreation/alarm-helios4-image-builder/releases/download/2019-02-27/ArchLinuxARM-helios4-2019-02-27.img.gz{,.md5}
|
||||
$ md5sum -c ArchLinuxARM-helios4-2019-02-27.img.gz.md5
|
||||
$ gunzip ArchLinuxARM-helios4-2019-02-27.img.gz
|
||||
```
|
||||
|
||||
## Installing Arch Linux ARM on Helios4
|
||||
|
||||
Once you get an Arch Linux ARM image, follows these instructions to use it on Helios4:
|
||||
|
||||
### Writing image / power-up Helios4 / connecting to serial console
|
||||
|
||||
Follows these steps from the Helios4 [install guide](/install):
|
||||
|
||||
- [step 2](/install/#step-2-writing-an-image-to-a-microsd-card) to write the Arch Linux ARM image to a microSD card
|
||||
- [step 3](/install/#step-3-power-up-helios4) to power-up Helios4
|
||||
- [step 4](/install/#step-4-connect-to-helios4-serial-console) to connect to the Helios4 serial console.
|
||||
|
||||
!!! note
|
||||
Arch Linux ARM is configured by default to get its IP address from a DHCP server. As an alternative to **step 4**, you can connect to your router to find the IP address given to Helios4, then connect to this latter using SSH.
|
||||
|
||||
### Log in
|
||||
|
||||
Use the serial console or SSH to the IP address given to Helios4 by your router.
|
||||
|
||||
You can login as:
|
||||
|
||||
- the default user *alarm* with the password *alarm*
|
||||
- the user *root* with password *root*
|
||||
|
||||
!!! important
|
||||
For security reasons, it is highly recommended to change the default password of the **alarm** and **root** users.
|
||||
|
||||
### Network settings
|
||||
|
||||
Arch Linux ARM is configured by default to get its IP address from a DHCP server. To change the network settings, look at the [Network Configuration](https://wiki.archlinux.org/index.php/Network_configuration) page from the Arch Linux wiki.
|
||||
|
||||
### Pacman
|
||||
|
||||
The Pacman keyring is already initialized in the images created by the `build-archlinux-img-for-helios4.sh` script and the pre-built images. It is also already populated with the Arch Linux ARM package signing keys.
|
||||
|
||||
## What to do next?
|
||||
|
||||
You can now configure Arch Linux ARM according to your needs and use **pacman** to install 3rd party applications.
|
||||
|
||||
Here are some useful links from the [Arch Linux wiki](https://wiki.archlinux.org) to get started:
|
||||
|
||||
- [RAID](https://wiki.archlinux.org/index.php/RAID)
|
||||
- [dm-crypt/Device encryption](https://wiki.archlinux.org/index.php/Dm-crypt/Device_encryption).
|
||||
|
||||
!!! note
|
||||
Read the [Accelerate Disk Encryption](/cesa/#accelerate-disk-encryption) section of the Helios4 wiki before proceeding to learn how to offload disk encryption on the CESA unit.
|
||||
|
||||
- [Nextcloud](https://wiki.archlinux.org/index.php/Nextcloud)
|
||||
- [NFS](https://wiki.archlinux.org/index.php/NFS)
|
||||
- [Samba](https://wiki.archlinux.org/index.php/Samba)
|
||||
|
||||
|
||||
*Page contributed by [gbcreation](https://github.com/gbcreation)*
|
||||
|
|
@ -72,3 +72,5 @@ This time, just sit back and watch as FreeBSD comes up.
|
|||
|
||||
### Default User
|
||||
The FreeBSD image by crochet comes with an unlocked root account. This means you do not need to enter a password to log in as root.
|
||||
|
||||
*Page contributed by [Artox](https://github.com/Artox)*
|
||||
|
|
|
|||
|
|
@ -62,6 +62,7 @@ pages:
|
|||
- Download: 'download.md'
|
||||
- Install: 'install.md'
|
||||
- O/S:
|
||||
- Arch Linux : 'arch.md'
|
||||
- Armbian : 'armbian.md'
|
||||
- FreeBSD : 'freebsd.md'
|
||||
- U-Boot (bootloader) : 'uboot.md'
|
||||
|
|
|
|||
Loading…
Reference in a new issue