System wide and admin settings¶
Alternative kernels, headers, rolling updates, overlays¶
Install alternative kernels¶
Kernel Switching Warning¶
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.
⚠️ Important Warning: Kernel changes carry inherent risks!¶
- A mismatched or incompatible kernel may result in boot failures, rendering the system unresponsive.
- Certain peripherals or hardware components (e.g., Wi-Fi, GPU acceleration, or power management) may no longer function correctly.
- Custom configurations or third-party modules might need to be recompiled or adjusted to work with the new kernel.
✅ Precautions Before Switching Kernels¶
Before switching kernels, it is strongly recommended to:
1. Back up your system to prevent data loss.
2. Verify compatibility of your hardware and essential drivers with the target kernel version.
3. Keep a rescue method available, such as a bootable SD card / USB drive or serial console access, to recover the system if necessary.
🛠️ Recovery Steps if Boot Fails¶
If your device fails to boot after a kernel change, you may need to:
- Revert to a previous working kernel using recovery options.
- Use a serial console or debug mode to diagnose the issue.
- Reinstall the system if no recovery options are available.
⚡ Exercise caution when switching kernels, especially on production systems or devices with limited recovery options.
Switching between kernels might change functionality of your device.
It might fail to boot!
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Install Linux headers¶
Linux headers are essential for compiling kernel modules and ensuring compatibility with software that interacts with the kernel.
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Remove Linux headers¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Manage device tree overlays¶
Command:
Text Only | |
---|---|
Author: @viraniac @igorpecovnik
Status: Stable
Select Odroid board configuration¶
Command:
Text Only | |
---|---|
Author:
Status: Preview
Edit the boot environment¶
This will open /boot/armbianEnv.txt file to edit CTRL+S to save CTLR+X to exit would you like to continue?
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Install to internal media, ZFS, NFS, read-only rootfs¶
Install to internal storage¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Preview
ZFS filesystem - enable support¶
📌 ZFS (Zettabyte File System)¶
🔍 Overview¶
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.
🛠️ Key Features¶
✅ Data Integrity¶
- Copy-on-Write (CoW): Prevents data corruption by never overwriting live data.
- Checksumming: Detects and corrects silent data corruption (bit rot).
📦 Storage Management¶
- Pooled Storage: Eliminates the need for traditional partitions; all storage is managed dynamically.
- Snapshots & Clones: Creates instant backups without using extra storage.
🚀 Performance & Scalability¶
- Efficient Compression & Deduplication: Reduces storage usage without performance loss.
- Dynamic Striping & Caching: Distributes data across multiple disks for optimized read/write speeds.
🔐 Advanced Security¶
- Native Encryption: Supports dataset-level encryption for secure data storage.
- RAID-Z: A superior RAID alternative that prevents write-hole issues.
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable
ZFS filesystem - remove support¶
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable
Enable read only filesystem¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable read only filesystem¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable Network filesystem (NFS) support¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable Network filesystem (NFS) support¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Manage NFS Server¶
Enable network filesystem (NFS) daemon¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Configure network filesystem (NFS) daemon¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Remove network filesystem (NFS) daemon¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Show network filesystem (NFS) daemon clients¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Manage NFS Client¶
Find NFS servers in subnet and mount shares¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Show and manage NFS mounts¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Manage SSH daemon options, enable 2FA¶
Disable root login¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable root login¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable password login¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable password login¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable Public key authentication login¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable Public key authentication login¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable OTP authentication¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable OTP authentication¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Generate new OTP authentication QR code¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Show OTP authentication QR code¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable last login banner¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable last login banner¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Sandboxed & containerised SSH server¶
Sandboxed & containerised SSH server allows ssh access without giving keys to the entire server. Giving ssh access via private key often means giving full access to the server. This container creates a limited and sandboxed environment that others can ssh into. The users only have access to the folders mapped and the processes running inside this container.
This operation will install SSH server.
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
ssh username@<your.IP> -p 2222
- Install directory:
/armbian/openssh-server
- Configuration directory:
/armbian/openssh-server/config
- Shared storage directory:
USER_DEFINED
Bash | |
---|---|
Remove sandboxed SSH server¶
This operation will remove SSH server.
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Purge sandboxed SSH server with data folder¶
This operation will purge SSH server with data folder.
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Change shell, adjust MOTD¶
Change shell system wide to BASH¶
This will switch system wide shell to BASH
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Change shell system wide to ZSH¶
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.
🚀 Key Features¶
- Auto-suggestions & Syntax Highlighting ✨
- Powerful Tab Completion & Globbing 🔍
- Customizable Prompt (e.g., with Oh My Zsh) 🎨
- Shared Command History Across Sessions 📜
- Built-in Spelling Correction 🛠️
This will switch system wide shell to ZSH
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Adjust welcome screen (motd)¶
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
OS updates and distribution upgrades¶
Status: Active
Enable Armbian firmware upgrades¶
This will enable Armbian kernel upgrades that are currently put on hold.
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Disable Armbian kernel upgrades¶
Disable Armbian kernel/firmware upgrades
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Switch system to rolling packages repository¶
This will switch OS to rolling releases.
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Switch system to stable packages repository¶
This will switch OS to stable releases
Command:
Text Only | |
---|---|
Author: @igorpecovnik
Status: Stable
Enable automating Docker container base images updating¶
Watchtower is an application that will monitor your running Docker containers and watch for changes to the images that those containers were originally started from. If watchtower detects that an image has changed, it will automatically restart the container using the new image.
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable
Every day watchtower will pull the latest images and compare it to the one that was used to run the certain container. If it sees that the image has changed it will stop/remove containers and then restart it using the new image and the same docker run options that were used to start the container initially.
Disable automating Docker container base images updating¶
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable
Enable automatic package updates.¶
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable
Configure automatic package updates¶
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable
Disable automatic package updates¶
Command:
Text Only | |
---|---|
Author: @armbian
Status: Stable