mirror of https://github.com/armbian/documentation.git synced 2026-01-06 10:13:36 -08:00

Files

Ian Goodacre bf92671c63 Add notes about logging

On the Armbian Build Framework > Getting Started page, add some notes
about logging, to let users know where to find the logs and how to
enable debug logs.

2025-02-24 07:13:07 +01:00

2.9 KiB

Raw Permalink Blame History

Armbian Build Framework Quick Start Guide

Requirements

x86_64 / aarch64 / riscv64 machine
at least 4GB of memory and ~50GB of disk space for VM, container or bare metal installation
Armbian / Ubuntu Jammy 22.04.x for native building or any Docker capable Linux for containerised
Windows 10/11 with WSL2 subsystem running Armbian / Ubuntu Jammy 22.04.x
Superuser rights (configured sudo or root access).
Make sure your system is up-to-date! Outdated Docker binaries, for example, can cause trouble

Clone repository

git clone https://github.com/armbian/build
cd build

!!! note - Make sure that full path to the build script does not contain spaces - For stable branch use last point release --branch=v24.11

``` mermaid
gitGraph
   commit
   commit
   checkout main
   commit id: "v24.08" tag: "v24.08"
   branch v24.08
   commit
   commit
   commit
   commit
   checkout main
   commit id: "v24.11" tag: "v24.11"
   branch v24.11
   commit
   commit
   commit
   commit
   checkout main
   commit
   commit
   commit
   commit
   commit
   commit
   commit id: "main" type: REVERSE tag: "Trunk"
```

Interactive

Run framework:

./compile.sh

??? info "Video"

CLI

Comprehensive list of build Commands and Switches

Example:

./compile.sh build \
BOARD=uefi-x86 \
BRANCH=current \
BUILD_DESKTOP=yes \
BUILD_MINIMAL=no \
DESKTOP_APPGROUPS_SELECTED='browsers chat desktop_tools' \
DESKTOP_ENVIRONMENT=gnome \
DESKTOP_ENVIRONMENT_CONFIG_NAME=config_base \
KERNEL_CONFIGURE=no \
RELEASE=noble

!!! question "Interpretation?"

This command will generate **Ubuntu 24.04 Noble** based **Gnome desktop** environment image for Intel based hardware (**uefi-x86**). Besides bare desktop, it will contain packages from **browsers** and **desktop_tool** sections and it will use unchanged kernel from **current kernel** branch.

Logging

Logs are written to output/logs. Old logs (all but the current build) are compressed and moved to output/logs/archive.

Log formats are:

ANSI - text with ANSI escapes for color coding - *.log.ans
ASCII (if ansi2txt is available) - text without color coding escapes - *.log
Markdown summary - *.md
Raw (if RAW_LOG=yes) - tar file containg all the raw logs - *.raw.tar

For much more verbose logs set switch 'DEBUG=yes'.

GitHub actions

If you do not own the proper equipment to build images on your own, you can use our GitHub action.

2.9 KiB Raw Permalink Blame History