configng/README.md

Armbian Config: The Next Generation

armbian-config provides configuration and installation routines for customizing and automating tasks within Armbian Linux environment. These utilties help streamline setup processes for various use cases.

Key Advantages

• Lightweight: Minimal dependencies for optimal performance.
• Flexible: Supports JSON, TUI, CLI, and API interfaces.
• Modern: A fresh approach to configuration.
• Low entropy: Byte clean uninstall for most targets

Features

• System Configuration:
  • kernel manamenent, headers, hardware tweaks.
  • NFS and ZFS storage management.
  • SSH user access tweaks.
  • system updates, rolling / stable, containers update.
• Network Management:
  • fixed / dynamic IP configuration.
  • connecting to wireless network.
  • access point management.
• Localization Settings:
  • Configure time zone.
  • Set language and locales.
  • Change hostname.
• Software Management:
  • Software installation and removal.
  • Native and containerized environment.
  • Standardised, updatable, maintained.

Compatibility

This tool is tailored to works best with Armbian Linux but it has also been automatically tested on:

• Debian Bookworm
• Ubuntu Jammy
• Ubuntu Noble

In theory it should work on all systemd APT based Linux distributions: Linux Mint, Elementary OS, Kali Linux, MX Linux, Parrot OS, Proxmox, Raspberry Pi OS, ...

Getting Started

Armbian config is preinstalled on Armbian. Open or login into your terminal and run:

armbian-config

Compatible distributions

Add Armbian key + repository and install the tool:

wget -qO - https://apt.armbian.com/armbian.key | gpg --dearmor | \
sudo tee /usr/share/keyrings/armbian.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/armbian.gpg] \
https://github.armbian.com/configng stable main" | \
sudo tee /etc/apt/sources.list.d/armbian-config.list > /dev/null
sudo apt update
sudo apt -y install armbian-config

armbian-config

Contributing

Please refer to general CONTRIBUTING.md and specific guidelines for adding a new feature.

Donations

Sustainability of Armbian development relies on donations and sponsorships.

License

(c) Contributors

All code is licensed under the GPL, v3 or later. See LICENSE file for details.