Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

NOTICE: We are refactoring this tool. Your input & help is more then welcome!

Armbian configuration utility

Utility for configuring your board, adjusting services and installing applications. It comes with Armbian by default.

Login as root and type:


  • system
    • install to SATA, eMMC, NAND or USB
    • freeze and unfreeze kernel and BSP upgrades
    • switching between available kernels and nightly builds
    • edit boot environment
    • reconfigure board settings with DT overlays or FEX (Allwinner legacy)
    • select dedicated DTB (Solidrun i.MX6 and Odroid XU4/HC1/HC2 boards)
    • adjust SSH daemon features
    • 3G/4G LTE modem management
    • run apt update and upgrade
    • toggle BASH/ZSH with Oh My ZSH and tmux
    • toggle desktop and login manager (desktop builds)
    • adjusting the display resolution (some boards)
    • enabling read only root filesystem (Ubuntu)
  • network
    • select dynamic or static IP address
    • hotspot management. Automatic detection of: nl80211, realtek, 802.11n, 802.11a and 802.11ac
    • iperf3. Toggle bandwidth measuring server
    • connect to wireless
    • install IR support
    • install support, pair and connect Bluetooth devices
    • edit IFUPDOWN interfaces
  • personal
    • change timezone, languages and hostname
    • select welcome screen items
  • software
  • help
    • Links to documentation, support and sources

Run this utility on 3rd party Debian based distributions

    sudo wget -O key
    sudo gpg --dearmor < key | sudo tee /usr/share/keyrings/armbian.gpg > /dev/null
    sudo chmod go+r /usr/share/keyrings/armbian.gpg
    sudo echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/armbian.gpg] $(lsb_release -cs) main  $(lsb_release -cs)-utils  $(lsb_release -cs)-desktop" | sudo tee /etc/apt/sources.list.d/armbian.list
    apt update
    apt install armbian-config

Development version:

# Install dependencies
apt install git iperf3 psmisc curl bc expect dialog network-manager sunxi-tools \
debconf-utils unzip dirmngr software-properties-common psmisc jq

git clone
cd config
bash debian-config

Software testings

Application name Buster Stretch* Bionic* Focal Test install
TV headend (IPTV server) ✔️ ✔️ ✔️ 15.11.2020
Syncthing (personal cloud) ✔️ ✔️ ✔️ 15.11.2020
SoftEther VPN server (VPN server) ✔️ ✔️ 09.03.2019
Plex (Plex media server) ✔️ ✔️ ✔️ 15.07.2019
Emby (Emby server) ✔️ ✔️ 24.07.2019
Radarr (Movie downloading server) ✔️ ✔️ ✔️ 10.06.2019
Sonarr (TV shows downloading server) ✔️ ✔️ ✔️ 10.06.2019
Transmission (torrent server) ✔️ ✔️ ✔️ 10.06.2019
ISPConfig (WEB, SMTP, POP, IMAP, FTPD, MYSQL server) ✔️ ✔️ 29.09.2018
NCP (Nextcloud personal cloud) ✔️ n/a 19.05.2019
OpenMediaVault NAS (NAS server) ✔️ ✔️ n/a 24.07.2019
OpenHAB (Smarthome suite) ✔️ ✔️ ✔️ ✔️ 19.9.2021
Home Assistant (Smarthome suite within Docker) ✔️ ✔️ ✔️ 09.03.2019
PI hole (ad blocker) ✔️ ✔️ 09.03.2019
UrBackup (client/server backup system) ✔️ ✔️ ✔️ 10.06.2019
Docker (Docker CE engine) ✔️ ✔️ ✔️ 10.06.2019
Mayan EDMS (Document management system within Docker) ✔️ ✔️ 29.09.2018
MiniDLNA (Media sharing) ✔️ ✔️ ✔️ 10.06.2019

* no longer supported