Skip to content

Armbian Config

Armbian Config (armbian-config) is a lightweight, interactive and scriptable configuration utility that automates the common tasks of setting up and maintaining an Armbian system. It ships preinstalled on every Armbian image and is especially handy on single-board computers (SBCs) — it gets you to a ready-to-use system without editing config files by hand.

What it can do

  • Initial setup & personalization — hostname, timezone, locales, keyboard, users, MOTD
  • Networking — Wi-Fi, VPN, static IP, and advanced/bridged configurations
  • Kernel & firmware — select, switch and manage kernels, headers, device-tree overlays and firmware
  • Hardware features — enable and manage board-specific options
  • Storage — install to internal media, ZFS, NFS, read-only root, and more
  • Software — sandboxed installation of third-party applications and services, plus system and distribution updates
  • Desktop environments — install and tier-manage XFCE, GNOME, KDE Plasma, MATE, Cinnamon and others

Quick start

Open a terminal (locally or over SSH) and run:

Bash
1
armbian-config

Every menu action can also be driven non-interactively for scripting and automation:

Bash
1
2
armbian-config --cmd <ID>        # run a menu command
armbian-config --api <helper>    # call a module helper directly

Compatibility

Armbian Config is optimized for Armbian Linux, but in theory it works on any systemd-based, APT-compatible distribution — Linux Mint, Elementary OS, Kali Linux, MX Linux, Parrot OS, Proxmox, Raspberry Pi OS, and others. It is continuously and automatically tested on current versions of Debian and Ubuntu.

Install on a non-Armbian distribution
Bash
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
wget -qO - https://apt.armbian.com/armbian.key | gpg --dearmor | \
sudo tee /usr/share/keyrings/armbian.gpg > /dev/null
cat << EOF | sudo tee /etc/apt/sources.list.d/armbian-config.sources > /dev/null
Types: deb
URIs: https://github.armbian.com/configng
Suites: stable
Components: main
Signed-By: /usr/share/keyrings/armbian.gpg
EOF
sudo apt update
sudo apt -y install armbian-config

Contribute

Want to expand Armbian Config with a new feature, software title, or configuration module? Contributions are welcome — see the contribution guide. Keep changes modular and easy to maintain, so they are quick to review and merge.

Sources

armbian/configng