Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pyavitz/debian-image-builder
Debian image builder for single board computers
https://github.com/pyavitz/debian-image-builder
allwinner amlogic bananapi broadcom debian freescale hardkernel linux odroid orangepi pine64 radxa raspberrypi rockchip ubuntu
Last synced: 5 days ago
JSON representation
Debian image builder for single board computers
- Host: GitHub
- URL: https://github.com/pyavitz/debian-image-builder
- Owner: pyavitz
- License: other
- Created: 2020-05-05T11:05:45.000Z (over 4 years ago)
- Default Branch: feature
- Last Pushed: 2024-10-24T16:24:39.000Z (3 months ago)
- Last Synced: 2024-10-25T18:24:47.834Z (3 months ago)
- Topics: allwinner, amlogic, bananapi, broadcom, debian, freescale, hardkernel, linux, odroid, orangepi, pine64, radxa, raspberrypi, rockchip, ubuntu
- Language: Shell
- Homepage:
- Size: 257 MB
- Stars: 142
- Watchers: 14
- Forks: 33
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
Boards
```py
(*) Work in progress
# ALLWINNER
BananaPi M2 Zero (*)
BananaPi M4 Zero
BananaPi P2 Zero (*)
Cubietruck (*)
NanoPi M1
NanoPi NEO
NanoPi NEO Plus2
NanoPi R1
OrangePi 3 LTS (*)
OrangePi One
OrangePi PC
OrangePi R1 (*)
PineA64+
Tritium
# AMLOGIC
BananaPi CM4
BananaPi M2 Pro
BananaPi M2S
BananaPi M5
H96-MAX X3
Le Potato
Odroid C4
Odroid HC4
Odroid N2
Odroid N2L
Odroid N2+
Radxa Zero
X96-AIR GBIT / QCOM
# FREESCALE
Cubox-I (*)
# ROCKCHIP
Indiedroid Nova (*)
Khadas Edge2 (*)
Odroid M1 (*)
OrangePi 5 (*)
OrangePi 5 Plus (*)
Rock 5B (*)
# SAMSUNG
Odroid XU4
# SPACEMIT
BananaPi BPI-F3
```
### Host dependencies for Debian Bookworm and Ubuntu Jammy Jellyfish / Noble Numbat
* **Debian Bookworm** (arm arm64)
* **Ubuntu Jammy Jellyfish** (arm arm64)
* **Ubuntu Noble Numbat** (recommended) (arm arm64 riscv)
**Install options:**
* Run the `./install.sh` script (recommended)
* Run builder [make commands](https://github.com/pyavitz/debian-image-builder#install-dependencies) (dependency: make)
---
## Instructions
#### Install dependencies
```sh
make ccompile # x86_64
make ncompile # aarch64
```
#### Menu interface
```sh
make config # Create user data file
make menu # Open menu interface
make dialogrc # Set builder theme (optional)
```
#### Miscellaneous
```sh
make clean # Clean up image errors
make purge # Remove sources directory
make purge-all # Remove sources and output directory
```
#### Config Menu
* [Profile options](https://github.com/pyavitz/debian-image-builder/commit/1c3e78652c4dfa06c1bb64d31e60f8dfb5145bec)
---
* Review the userdata.txt file for further options: locales, timezone and nameserver(s)
* 1 active | 0 inactive
```sh
Name: # Your name
Username: # Your username
Password: # Your password
Hostname: # Set custom system hostname
Distribution
Distro: # Supported: debian, devuan and ubuntu
Release: # Debian: bullseye, bookworm, trixie, testing, unstable and sid
# Devuan: chimaera, daedalus, excalibur, testing, unstable and ceres
# https://www.devuan.org/os/announce/excalibur-usrmerge-announce-2024-02-20.html
# Kali: kali-last-snapshot and kali-rolling
# Ubuntu: focal, jammy and noble
Network Manager # 1 networkmanager | 0 ifupdown
U-Boot and Linux
U-Boot: # Supported: v2024.01
Branch: # Supported: 6.6.y and "maybe" current stable / rc
Build: # Kernel build version number
Menuconfig: # Run uboot and kernel menuconfig
Compiler: # GNU Compiler Collection / Clang
Ccache: # Compiler cache
Customize
Defconfig: # User defconfig
Name: # Name of _defconfig (must be placed in defconfig dir.)
User options
Logging: # Logging > output/logs/$board-*.log (Menu interface only)
Verbosity: # Verbose
Devel Rootfs: # Developer rootfs tarball
Compress img: # Auto compress img > img.xz
User scripts: # Review the README in the files/userscripts directory
User service: # Create user during first boot (bypass the user information above)
```
#### Customize image
* custom.txt
```sh
# Boot Partition
ENABLE_VFAT="false"
# Root Filesystem Types: ext4 btrfs xfs
FSTYPE="ext4"
# UEFI Options (WIP)
ENABLE_EFI="false"
# Image Size: 4096MB
IMGSIZE="4096MB"
# Shrink Image
ENABLE_SHRINK="true"
# Petitboot (AML ODROID) (not recommended)
ENABLE_PETITBOOT="false"
# Compression Types: xz zst
IMG_COMPRESSION="xz"
```
#### User defconfig
```sh
# config placement: defconfig/$NAME_defconfig
The config menu will append _defconfig to the end of the name in the
userdata.txt file.
```
#### User patches
```sh
Patches "-p1" placed in patches/userpatches are applied during compilation.
```
## Usage
* Review the [Wiki](https://github.com/pyavitz/debian-image-builder/wiki)
#### /boot/useraccount.txt
* Headless: ENABLE="true" and fill in the variables (recommended)
* Headful: ENABLE="false" and get prompted to create a user account
```sh
ENABLE="false" # Enable service
NAME="" # Your name
USERNAME="" # Username
PASSWORD="" # Password
```
#### /boot/credentials.txt
```sh
Set to ENABLE="true" and input your wifi information.
ENABLE="false" # Enable service
SSID="" # Service set identifier
PASSKEY="" # Wifi password
COUNTRYCODE="" # Your country code
# set static ip (ifupdown)
MANUAL="false" # Set to true to enable a static ip
IPADDR="" # Static ip address
NETMASK="" # Your Netmask
GATEWAY="" # Your Gateway
NAMESERVERS="" # Your preferred dns
# set static ip (network-manager)
MANUAL="false" # Set to true to enable a static ip
IPADDR="" # Static ip address
GATEWAY="" # Your Gateway
DNS="" # Your preferred dns
# change hostname
HOSTNAME="$CURRENT" # Hostname
For headless use: ssh user@ipaddress
```
#### System settings (`menu-config`)
---
### Support
Should you come across any bugs, feel free to either open an issue on GitHub or talk with us directly by joining our channel on Libera; [`#arm-img-builder`](irc://irc.libera.chat/#arm-img-builder) or [Discord](https://discord.gg/mypJ7NW8BG)