Awesome Open Source
Awesome Open Source

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:

armbian-config

  • 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 https://apt.armbian.com/armbian.key -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] http://apt.armbian.com $(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 https://github.com/armbian/config
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

Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (182,694
Docker (99,698
Server (65,687
Mysql (32,503
Nginx (16,850
Apache (16,287
Vpn (4,013
Lamp (1,910
Plex (1,905
Openvpn (1,833
Smarthome (1,717
Postfix (1,504
Nas (1,145
Nextcloud (1,058
Openhab (650
Sonarr (521
Pi Hole (519
Radarr (411
Emby (267
Hassio (232
Tvheadend (41
Ispconfig (19
Openmediavault (16