https://github.com/armbian/configng
armbian-config is a powerful, user-friendly tool that simplifies managing an Armbian system.
https://github.com/armbian/configng
cockpit deluge homeassistant kvm mariadb netconfig netdata netplan nextcloud openhab owncloud phpmyadmin pi-hole proxmox radarr sonarr swag transmission uptimekuma webmin
Last synced: about 1 month ago
JSON representation
armbian-config is a powerful, user-friendly tool that simplifies managing an Armbian system.
- Host: GitHub
- URL: https://github.com/armbian/configng
- Owner: armbian
- License: gpl-3.0
- Created: 2022-11-12T00:49:54.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T09:23:39.000Z (about 1 month ago)
- Last Synced: 2025-04-10T00:16:46.487Z (about 1 month ago)
- Topics: cockpit, deluge, homeassistant, kvm, mariadb, netconfig, netdata, netplan, nextcloud, openhab, owncloud, phpmyadmin, pi-hole, proxmox, radarr, sonarr, swag, transmission, uptimekuma, webmin
- Language: Shell
- Homepage: https://docs.armbian.com/User-Guide_Armbian-Config/
- Size: 19.9 MB
- Stars: 51
- Watchers: 9
- Forks: 26
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Armbian Config: The Next Generation
**armbian-config** provides configuration and installation routines for customizing and automating tasks within Armbian Linux environment. These utilities 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 management, 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 work best with [**Armbian Linux**](https://www.armbian.com) 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:
```bash
armbian-config
```
#### Compatible distributions
Add Armbian key + repository and install the tool:
```bash
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
```
```bash
armbian-config
```
## Contributing
Please refer to general [CONTRIBUTING.md](CONTRIBUTING.md) and specific guidelines for [adding a new feature](https://docs.armbian.com/Contribute/Armbian-config/).
## Donations
Sustainability of Armbian development relies on [donations](https://www.armbian.com/donate/) and [sponsorships](https://github.com/sponsors/armbian).
## License
(c) [Contributors](https://github.com/armbian/configng/graphs/contributors)
All code is licensed under the GPL, v3 or later. See [LICENSE](LICENSE) file for details.