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
Copy file name to clipboardExpand all lines: docs/User-Guide_Armbian-Config/Network.md
+40-16Lines changed: 40 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -35,22 +35,31 @@ armbian-config --cmd BNS001
35
35
36
36
37
37
<!--- footer START from tools/include/markdown/BNS001-footer.md --->
38
-
Network configuration is simple and easy to follow:
39
-
40
-
1. Choose the interface. If it's a wireless interface, you'll be prompted to select an access point (AP) and enter its password. Leave empty for open network.
41
-
42
-
2. Choose between DHCP (Dynamic Host Configuration Protocol) or static IP configuration.
43
-
44
-
- If you select DHCP, the setup is complete. Optionally, you can change the MAC address.
45
-
46
-
3. If you choose a static configuration, you'll need to provide:
47
-
48
-
- An optional MAC address change
49
-
- A fixed IP address (e.g., x.x.x.x/y)
50
-
- A route (default: 0.0.0.0/0)
51
-
- A gateway (usually x.x.x.1/24)
52
-
- DNS (default: 9.9.9.9)
53
-
38
+
1.**Select Interface:**
39
+
- Launch the `armbian-config` utility:
40
+
```bash
41
+
sudo armbian-config
42
+
```
43
+
- Navigate to `Network` and choose the desired network interface (e.g., `eth0`for wired or `wlan0`for wireless).
44
+
45
+
2. **Wireless Interface Configuration:**
46
+
- If configuring a wireless interface:
47
+
- A list of available Access Points (APs) will be displayed.
48
+
- Select your preferred AP and enter the password when prompted. Leave the password field empty for open networks.
49
+
50
+
3. **IP Address Configuration:**
51
+
- Choose between:
52
+
- **DHCP (Dynamic Host Configuration Protocol):** Automatically assigns an IP address.
53
+
- **Static IP:** Manually enter details:
54
+
- **MAC Address (optional):** Specify if you want spoofing MAC address.
55
+
- **IP Address:** Use CIDR notation (e.g., `192.168.1.10/24`).
56
+
- **Route:** Default is `0.0.0.0/0`.
57
+
- **Gateway:** Typically the router's IP, e.g., `192.168.1.1`.
58
+
- **DNS:** Default is `9.9.9.9`, but can be changed.
59
+
60
+
4. **Finalize Configuration:**
61
+
- Review and confirm your settings.
62
+
- The system applies the configurations, and your network should be set up.
54
63
<!--- footer STOP from tools/include/markdown/BNS001-footer.md --->
55
64
56
65
@@ -254,6 +263,11 @@ More informations:
254
263
***
255
264
256
265
## WireGuard remove
266
+
267
+
<!--- section image START from tools/include/images/WG002.png --->
268
+
[](#)
269
+
<!--- section image STOP from tools/include/images/WG002.png --->
270
+
257
271
This operation will remove WireGuard
258
272
259
273
**Command:**
@@ -270,6 +284,11 @@ armbian-config --cmd WG002
270
284
***
271
285
272
286
## WireGuard clients QR codes
287
+
288
+
<!--- section image START from tools/include/images/WG003.png --->
289
+
[](#)
290
+
<!--- section image STOP from tools/include/images/WG003.png --->
291
+
273
292
**Command:**
274
293
~~~
275
294
armbian-config --cmd WG003
@@ -284,6 +303,11 @@ armbian-config --cmd WG003
284
303
***
285
304
286
305
## WireGuard purge with data folder
306
+
307
+
<!--- section image START from tools/include/images/WG004.png --->
308
+
[](#)
309
+
<!--- section image STOP from tools/include/images/WG004.png --->
310
+
287
311
This operation will purge WireGuard with data folder
Copy file name to clipboardExpand all lines: docs/User-Guide_Armbian-Config/System.md
+83Lines changed: 83 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -14,6 +14,33 @@
14
14
[](#)
15
15
<!--- section image STOP from tools/include/images/SY201.png --->
16
16
17
+
18
+
<!--- header START from tools/include/markdown/SY201-header.md --->
19
+
## Kernel Switching Warning
20
+
21
+
Switching between different kernel versions can significantly impact the functionality of your device. A newer or older kernel may introduce changes to hardware compatibility, drivers, and system stability. Some features may stop working, while others may improve or be reintroduced.
22
+
23
+
### ⚠️ Important Warning: Kernel changes carry inherent risks!
24
+
- A mismatched or incompatible kernel may result in **boot failures**, rendering the system unresponsive.
25
+
- Certain peripherals or hardware components (e.g., Wi-Fi, GPU acceleration, or power management) may no longer function correctly.
26
+
- Custom configurations or third-party modules might need to be recompiled or adjusted to work with the new kernel.
27
+
28
+
### ✅ Precautions Before Switching Kernels
29
+
Before switching kernels, it is **strongly recommended** to:
30
+
1.**Back up your system** to prevent data loss.
31
+
2.**Verify compatibility** of your hardware and essential drivers with the target kernel version.
32
+
3.**Keep a rescue method available**, such as a bootable SD card / USB drive or serial console access, to recover the system if necessary.
33
+
34
+
### 🛠️ Recovery Steps if Boot Fails
35
+
If your device fails to boot after a kernel change, you may need to:
36
+
-**Revert to a previous working kernel** using recovery options.
37
+
-**Use a serial console or debug mode** to diagnose the issue.
38
+
-**Reinstall the system** if no recovery options are available.
39
+
40
+
**⚡ Exercise caution when switching kernels, especially on production systems or devices with limited recovery options.**
41
+
42
+
<!--- header STOP from tools/include/markdown/SY201-header.md --->
43
+
17
44
Switching between kernels might change functionality of your device.
18
45
19
46
It might fail to boot!
@@ -37,6 +64,12 @@ armbian-config --cmd SY201
37
64
[](#)
38
65
<!--- section image STOP from tools/include/images/SY204.png --->
39
66
67
+
68
+
<!--- header START from tools/include/markdown/SY204-header.md --->
69
+
Linux headers are essential for compiling kernel modules and ensuring compatibility with software that interacts with the kernel.
70
+
71
+
<!--- header STOP from tools/include/markdown/SY204-header.md --->
72
+
40
73
**Command:**
41
74
~~~
42
75
armbian-config --cmd SY204
@@ -65,6 +98,11 @@ armbian-config --cmd SY205
65
98
***
66
99
67
100
### Manage device tree overlays
101
+
102
+
<!--- section image START from tools/include/images/SY210.png --->
103
+
[](#)
104
+
<!--- section image STOP from tools/include/images/SY210.png --->
105
+
68
106
**Command:**
69
107
~~~
70
108
armbian-config --cmd SY210
@@ -93,6 +131,11 @@ armbian-config --cmd SY300
93
131
***
94
132
95
133
### Edit the boot environment
134
+
135
+
<!--- section image START from tools/include/images/SY010.png --->
136
+
[](#)
137
+
<!--- section image STOP from tools/include/images/SY010.png --->
138
+
96
139
This will open /boot/armbianEnv.txt file to edit
97
140
CTRL+S to save
98
141
CTLR+X to exit
@@ -136,6 +179,33 @@ armbian-config --cmd SY001
136
179
***
137
180
138
181
### ZFS filesystem - enable support
182
+
183
+
<!--- header START from tools/include/markdown/SY220-header.md --->
184
+
# 📌 ZFS (Zettabyte File System)
185
+
186
+
## 🔍 Overview
187
+
188
+
**ZFS (Zettabyte File System)** is a high-performance, scalable, and robust file system designed to provide advanced data protection, integrity, and storage management. Developed by Sun Microsystems, ZFS is widely used in enterprise environments, NAS systems, and personal storage solutions due to its unique features.
189
+
190
+
## 🛠️ Key Features
191
+
192
+
### ✅ Data Integrity
193
+
-**Copy-on-Write (CoW):** Prevents data corruption by never overwriting live data.
194
+
-**Checksumming:** Detects and corrects silent data corruption (bit rot).
195
+
196
+
### 📦 Storage Management
197
+
-**Pooled Storage:** Eliminates the need for traditional partitions; all storage is managed dynamically.
198
+
-**Snapshots & Clones:** Creates instant backups without using extra storage.
199
+
200
+
### 🚀 Performance & Scalability
201
+
-**Efficient Compression & Deduplication:** Reduces storage usage without performance loss.
202
+
-**Dynamic Striping & Caching:** Distributes data across multiple disks for optimized read/write speeds.
203
+
204
+
### 🔐 Advanced Security
205
+
-**Native Encryption:** Supports dataset-level encryption for secure data storage.
206
+
-**RAID-Z:** A superior RAID alternative that prevents write-hole issues.
207
+
<!--- header STOP from tools/include/markdown/SY220-header.md --->
208
+
139
209
**Command:**
140
210
~~~
141
211
armbian-config --cmd SY220
@@ -596,6 +666,19 @@ armbian-config --cmd SY005
596
666
***
597
667
598
668
### Change shell system wide to ZSH
669
+
670
+
<!--- header START from tools/include/markdown/SY006-header.md --->
671
+
**ZSH (Z Shell)** is an extended and highly customizable Unix shell that offers powerful features beyond traditional shells like **Bash**. It is widely used for its user-friendly enhancements, scripting capabilities, and plugin support.
672
+
673
+
## 🚀 Key Features
674
+
675
+
-**Auto-suggestions & Syntax Highlighting** ✨
676
+
-**Powerful Tab Completion & Globbing** 🔍
677
+
-**Customizable Prompt (e.g., with Oh My Zsh)** 🎨
678
+
-**Shared Command History Across Sessions** 📜
679
+
-**Built-in Spelling Correction** 🛠️
680
+
<!--- header STOP from tools/include/markdown/SY006-header.md --->
0 commit comments