README.md 2.55 KB
Newer Older
Dan Johansen's avatar
Dan Johansen committed
1 2
# manjaro-arm-installer

Dan Johansen's avatar
Dan Johansen committed
3
Scripts for installing Manjaro ARM directly to SD/eMMC cards without the need for images.
Dan Johansen's avatar
Dan Johansen committed
4

5
This script is "interactive". Meaning that it asks you questions when run to customize your install. Like username, password etc.
6 7


8
## Dependencies (Arch package names):
9
* bash
10 11 12
* wget
* git
* systemd
13
* dialog
14 15
* parted
* libarchive
16
* binfmt-qemu-static
Dan Johansen's avatar
Dan Johansen committed
17
* openssl
18
* gawk
19 20
* dosfstools
* polkit
21

22 23 24 25 26 27 28 29 30 31 32 33 34 35
## Installing and using from Manjaro x64 repositories:
To use this script, please make sure that the following is correct:

* an **empty** SD/eMMC card with at least 8 GB storage is plugged in, but not mounted.
* that your user account has `sudo` rights.

Then install the `manjaro-arm-installer` package with:
```
sudo pacman -Syu manjaro-arm-installer
```
Then reboot. You can now launch the installer with:
```
sudo bash manjaro-arm-installer
```
Dan Johansen's avatar
Dan Johansen committed
36
Or with encryption support:
37
*Warning! Encryption support is experimental and only Pinebook Pro is supported at this time!*
Dan Johansen's avatar
Dan Johansen committed
38
```
39
sudo export CRYPT="y" && sudo bash manjaro-arm-installer
Dan Johansen's avatar
Dan Johansen committed
40 41
```
It will ask the crypt password twice (first to create it, the second one to open the device)
42

Dan Johansen's avatar
Dan Johansen committed
43
## Installing and using from gitlab:
44 45
To use this script, please make sure that the following is correct:

46
* an **empty** SD/eMMC card with at least 8 GB storage is plugged in, but not mounted.
47
* that your user account has `sudo` rights.
48

Dan Johansen's avatar
Dan Johansen committed
49
Then use this to get it:
50
```
Dan Johansen's avatar
Dan Johansen committed
51 52
git clone https://gitlab.manjaro.org/manjaro-arm/applications/manjaro-arm-installer
cd manjaro-arm-installer
53
chmod +x manjaro-arm-installer
54
sudo bash ./manjaro-arm-installer
55 56
```

Dan Johansen's avatar
Dan Johansen committed
57 58 59
## Known Issues:
* Because `dialog` is weird, the script needs to be run in `bash`.

60
## Supported Devices:
61
* Raspberry Pi 4 (and 3)
62
* Pinebook Pro
63 64
* RockPro64
* Rock Pi 4
65
* Odroid N2
66
* Odroid C4
67 68
* Odroid C2
* Pinebook
69
* Pine64-LTS / Sopine
70
* Pine64+
71 72
* Pine H64 (new)
* Rock64
73
* LibreComputer Renegade (Roc-CC)
74
* NanoPC T4 (new)
75 76 77
* Khadas Vim 3
* Khadas Vim 2
* Khadas Vim 1
78 79 80 81

## Supported Editions / Desktops:
* Minimal (no xorg, no apps)
* KDE/Plasma (full plasma desktop with apps)
82
* XFCE (full XFCE desktop with apps)
83
* i3 (tiling window manager with gtk apps)
Dan Johansen's avatar
Dan Johansen committed
84
* Sway (tiling wayland window manager with gtk apps)
85
* LXQT (full LXQT desktop with some qt apps)
86
* Mate (full mate desktop with apps)
87 88
* CuboCore (base plasma desktop with CoreApps)

89
## Other notes:
Dan Johansen's avatar
Dan Johansen committed
90 91
This script is available in the **Manjaro** repository and can be installed with `sudo pacman -S manjaro-arm-installer`.

92
This script **should** be distro-agnostic, which means you can install *Manjaro ARM* from **any** distro, as long as the dependencies are met.