You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<imgsrc="https://raw.githubusercontent.com/armbian/configng/main/share/icons/hicolor/scalable/configng-tux.svg"width="128"alt="Armbian Config NG Logo" />
4
-
</a><br>
5
-
<strong>Armbian Config: The Next Generation</strong><br>
This repository contains the source code for **Armbian Config**, a versatile and extremly **lightweight configuration utility** designed to simplify and automate common system tasks within the Armbian Linux environment.
9
+
10
+
Armbian Config provides interactive and scriptable routines for:
9
11
10
-
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.
12
+
- Initial system setup and personalization
13
+
- Networking configuration, including Wi-Fi, VPN, and static IP
14
+
- Sandboxed software installation and system updates
15
+
- Kernel selection, switching, and firmware management
16
+
- Enabling and managing hardware-specific features
11
17
12
-
## Getting Started
18
+
It is especially useful for single board computers (SBCs), helping users quickly prepare a ready-to-use system without manual intervention.
13
19
14
-
Armbian config comes preinstalled with Armbian. To get started, open a terminal or log in via SSH, then run:
20
+
### Quick Start
21
+
22
+
Armbian Config comes **preinstalled** with Armbian images.
23
+
24
+
To launch the utility:
25
+
26
+
1. Open a terminal (locally or via SSH)
27
+
2. Run the following command:
15
28
16
29
```bash
17
30
armbian-config
18
31
```
19
32
20
33
<ahref=#><img src=.github/images/common.png></a>
21
34
22
-
## Key Advantages
23
-
-**Lightweight**: Minimal dependencies for optimal performance.
24
-
-**Flexible**: Supports JSON, TUI, CLI, and API interfaces.
25
-
-**Modern**: A fresh approach to configuration.
26
-
-**Low entropy**: Byte clean uninstall for most targets.
27
-
28
-
## Features
29
-
30
-
-**System Configuration**:
31
-
- Kernel management, headers, hardware tweaks.
32
-
- NFS and ZFS storage management.
33
-
- SSH user access tweaks.
34
-
- System updates, rolling / stable, containers update.
35
-
-**Network Management**:
36
-
- Fixed / dynamic IP configuration.
37
-
- Connecting to wireless network.
38
-
- Access point management.
39
-
-**Localization Settings**:
40
-
- Configure time zone.
41
-
- Set language and locales.
42
-
- Change hostname.
43
-
-**Software Management**:
44
-
- Software installation and removal.
45
-
- Native and containerized environment.
46
-
- Standardised, updatable, maintained.
47
-
48
-
## Compatibility
35
+
### Compatibility
49
36
50
37
This tool is optimized for use with [**Armbian Linux**](https://www.armbian.com), but in theory, it should also work on any systemd-based, APT-compatible Linux distribution — including Linux Mint, Elementary OS, Kali Linux, MX Linux, Parrot OS, Proxmox, Raspberry Pi OS, and others.
51
38
<details><summary>Add Armbian key + repository and install the tool:</summary>
Want to expand **Armbian Config** with new features or tools? Whether you're adding a new software title, enhancing an existing configuration module, or introducing entirely new functionality, we welcome your ideas and code.
79
59
80
-
Thank you to everyone who has contributed to **Armbian-config** — your efforts are deeply appreciated!
Want to expand Armbian-config with new features or tools? Whether you're adding a new software title, enhancing an existing configuration module, or introducing entirely new functionality, we welcome your ideas and code.
62
+
> 📌 Tip: Keep your changes modular and easy to maintain — this helps us review and merge your contribution faster.
95
63
96
-
To get started:
64
+
### Support
97
65
98
-
- Review how similar features are implemented in the current codebase.
99
-
- Follow the structure and coding style used in existing modules.
100
-
- Ensure your additions are well-tested and don’t break existing functionality.
101
-
- Document any new options clearly so users understand how to use them.
66
+
Armbian offers multiple support channels, depending on your needs:
All code is licensed under the GPL, v3 or later. See [LICENSE](LICENSE) file for details.
92
+
Armbian's [partnership program](https://forum.armbian.com/subscriptions) helps to support Armbian and the Armbian community! Please take a moment to familiarize yourself with [our Partners](https://armbian.com/partners).
0 commit comments