CRUX-ARM Documentation
- Introduction
- Why use CRUX-ARM
- Getting started
- Obtaining and installing additional software
- Supported devices
- Documentation
- Development information and documentation
Introduction
If you have in mind to use CRUX-ARM we assume that you are familiarized with CRUX. This is not a requisite but could answer many of the questions you have and maybe are not relevant to ARM devices in particular.
You can check About page for a detailed description about what's CRUX-ARM.
Why use CRUX-ARM?
CRUX's simplicity and lightweightness is especially valuable when you only have little disk space like you often do on ARM-powered devices. CRUX-ARM provides you a basic framework which you could extend and tweak without wasting too much time learning distribution-specific tools and configuration files, as CRUX one are very basic and simple.
Getting started
ARM devices are very different in their nature, so there cannot be one general guide for all of them, unlike x86 arch, so this section explains only basic steps you would need to perform.
First, make sure you can run a linux kernel on your device. Way to run Linux is very device-specific. Many devices are shipped with pre-installed Linux based operating systems, like Android or ChromeOS, others will require installing some bootloader and finding a suitable kernel sources or binaries.
Assuming you already can run Linux and can get to root shell, second step would be unpacking corresponding CRUX-ARM rootfs, which is shipped in tar archive. There are two options of running CRUX-ARM. First you could use other distribution's shell to chroot into CRUX-ARM and second is installing CRUX-ARM on place of other OS or into separate partition.
Obtaining and installing additional software.
CRUX-ARM uses same ports system as CRUX, but it also uses specific ports collections called overlays, like core-arm, core-arm64, opt-arm, opt-arm64, xorg-arm and xorg-arm64. Overlays are just regular port collections containing ports which require specific build options or have different footprints. They are listed first in prt-get.conf in order to have higher priority over same packages located in general port collections.
You can check our supported devices to get the right rootfs for any of them. If your device isn't officially supported, you can get the generic rootfs and run it itself, or start with an optimized release for your device, rebuilding the entire core collection ports for it.
If you need additional ports you can use port collections from general CRUX. You can also try ports from other CRUX versions, it will probably work, but they aren't officially supported.
You can also obtain some pre-built core ARM packages here Packages
Supported devices
If you have an ARM device not listed here, please contact to CRUX-ARM System Team or check HowToContribute.
Theoretically if there is kernel support for the ARM device, then it should run CRUX-ARM without problems. In addition, knowledge of the device's bootloader (usually U-Boot) is required.
Donations to CRUX-ARM System Team are welcome, so that the team can test as well as support the project itself.
ARM 64b (aarch64)
| CPU | Device | Instruction set | Kernel Version | OS Version | Ports Overlay | |
 | Allwinner A64 | Pine64 | armv8 | 3.10.105 | CRUX-ARM 3.8 | pine64-arm64 |
 | BCM2837 | Raspberrypi 3b | armv8 | 6.6.74-v8+ | CRUX-ARM 3.8 | raspberrypi3-arm64 |
 | BCM2711 | Raspberrypi 4 | armv8 | 6.1.61-v8 | CRUX-ARM 3.8 | raspberrypi4-arm64 |
 | BCM2712 | Raspberrypi 5 | armv8 | 6.6.74-v8-16k | CRUX-ARM 3.8 | raspberrypi5-arm64 |
ARM 32b (armhf)
| CPU | Device | Instruction set | Kernel Version | OS Version | Ports Overlay | |
 | Allwinner A10 | Cubieboard | armv7 | 3.4 | CRUX-ARM 3.8 | cubieboard-arm |
 | Allwinner A20 | Cubieboard2 | armv7 | 3.4.104 | CRUX-ARM 3.8 | cubieboard2-arm |
 | Samsung Exynos5422 | Odroid-xu4 | armv7 | 6.1.90+ | CRUX-ARM 3.8 | odroidxu4-arm |
Contributed Supported Devices
| Device | CPU | Instruction set | Kernel Version | OS Version | Ports Overlay | |
 | Marvell Armada 375 | OVHSysARM | armv7 | 4.9.124 | CRUX-ARM 3.4 | |
 | Freescale i.MX6q | Gk802 | armv7 | 3.0.35 | CRUX-ARM 3.1 | |
 | Allwinner A20 | BananaPi | armv7 | 3.0.35 | CRUX-ARM 3.1 | |
 | Allwinner A10 | Hackberry | armv7 | 3.4.43 | CRUX-ARM 3.0 |
Old ARM 32b (discontinuous)
| CPU | Device | Instruction set | Kernel Version | OS Version | Ports Overlay | |
 | Freescale i.MX515 | Genesi EfikaMX-SmartTop | armv7 | 2.6.31 | CRUX-ARM 3.2 | efikamx-arm |
 | BCM2835 | Raspberrypi | armv6 | 3.6.1 | CRUX-ARM 3.2 | raspberrypi-arm |
 | BCM2836 | Raspberrypi 2 | armv7 | 4.5.4 | CRUX-ARM 3.2 | raspberrypi2-arm |
 | Exynos 5420 | Samsung Chromebook XE303C12 | armv7 | 3.8 | CRUX-ARM 3.2 | samsungchromebook-arm |
 | Allwinner H3 | OrangePi PC | armv7 | 3.4.39-01-lobo | CRUX-ARM 3.3 | cubieboard2-arm |
 | WonderMedia WM8505 | WM8505 | arm9 | 2.6.29 | CRUX-ARM 2.6 noeabi | |
| Versatile Express 64b | Versatile Express 64b | armv8a | 4.1.1 | CRUX-ARM 3.3 | |
| Versatile Express | Versatile Express | armv7 | 4.9.6 | CRUX-ARM 3.2 | |
| Versatile | Versatile | arm9 | 3.5.4 | CRUX-ARM 2.8 noeabi | |
 | SA1110 | HP Jornada 720 | armv4 | 2.6.32 | CRUX-ARM 2.6 noeabi | |
 | OMAP 850 | HTC Prophet | arm9 | 2.6.25 | CRUX-ARM 2.6 noeabi | |
 | OMAP 850 | HTC Elf | arm9 | 2.6.25 | CRUX-ARM 2.6 noeabi | |
 | Intel PXA255 | HP Ipaq 1910 | armv5te | 2.6.16 | CRUX-ARM 2.6 noeabi |