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
- softy
- TV headend (IPTV server)
- Syncthing (personal cloud)
- SoftEther VPN server (VPN server)
- Plex (Plex media server)
- Emby (Emby media server)
- Radarr (Movie downloading server)
- Sonarr (TV shows downloading server)
- Transmission (torrent server)
- ISPConfig (WEB & MAIL server)
- NCP (Nextcloud personal cloud)
- Openmediavault NAS (NAS server)
- OpenHab2 (Smarthome suite)
- Home Assistant (Smarthome suite within Docker)
- PI hole (ad blocker)
- UrBackup (client/server backup system)
- Docker (Docker CE engine)
- Mayan EDMS (Document management system within Docker)
- MiniDLNA (media sharing)
- monitoring tools
- create diagnostics report
- toggle kernel headers, RDP service, Thunderbird and LibreOffice (desktop builds)
- softy
- 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