Skip to content
This repository was archived by the owner on Oct 12, 2026. It is now read-only.

Commit b9736e1

Browse files
authored
Revise "configuration locations documentation for clarity (#130)
Minor edits to language explaining the stateless layout of AerynOS and the purpose of configuration locations. Updated sections on system defaults, overrides, and user-level configurations for better understanding.
1 parent de6b0a5 commit b9736e1

1 file changed

Lines changed: 7 additions & 8 deletions

File tree

‎src/content/docs/Users/System Management/configuration-locations.mdx‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@ license: "CC-BY-SA-4.0"
66
copyright: "Copyright © 2025 aerynOS Developers"
77
---
88

9-
AerynOS ships configuration in a stateless layout. Packages deliver defaults in `/usr/share/defaults`, while administrator and user changes live elsewhere so updates can proceed without overwriting your work.
9+
AerynOS ships in a stateless layout, meaning the OS is completely separated from user data and configuration.
1010

1111
## System defaults
1212

13-
Default files mirror the traditional `/etc` hierarchy under `/usr/share/defaults`.
13+
The OS packages no longer reside under `/etc`. They now go to `/usr/share/defaults`. The traditional `/etc` directory hierarchy is preserved under `/usr`. `/etc` is now strictly reserved for User/Admin data and configuration. As a result all system updates now occur without touching user data.
1414

1515
| Purpose | Default location | Example contents |
1616
| --- | --- | --- |
@@ -21,23 +21,22 @@ Default files mirror the traditional `/etc` hierarchy under `/usr/share/defaults
2121
| Sudo configuration | `/usr/share/defaults/sudo` | `sudoers`, drop-in files |
2222
| SSH defaults | `/usr/share/defaults/ssh` | `ssh_config`, `sshd_config` |
2323

24-
25-
Packages may add more directories under `/usr/share/defaults` as required. The layout always mirrors where the file would appear under `/etc` on a traditional filesystem.
24+
Packages may add more directories under `/usr/share/defaults` as required, but the layout will always mirror where the file would have appeared under `/etc` on a traditional filesystem.
2625

2726
## System overrides
2827

29-
Place administrator overrides in `/etc`. Files in `/etc` shadow anything under `/usr/share/defaults` and survive package updates. Use drop-in directories such as `/etc/pam.d` or `/etc/sudoers.d` to keep customisations scoped and easy to audit.
30-
28+
Overrides are global (administrator-level) modifications that "override" the default environment of AerynOS, including system setup, configuration, hardware and current state. Because these overrides live in the /etc folder, they survive package updates. Create "drop-in" directories such as `/etc/pam.d` or `/etc/sudoers.d` to keep customisations scoped and easy to audit.
3129
When you need to revert to the shipped defaults, remove the override from `/etc` and Moss will fall back to the matching file in `/usr/share/defaults`.
3230

3331
## User-level configuration
3432

35-
Desktop and application settings follow the XDG Base Directory specification. Store per-user changes in:
33+
User-level configurations include desktop and app settings. These follow the XDG Base Directory specification. Store per-user changes in:
3634

3735
- `~/.config` for configuration files
3836
- `~/.local/share` for data files
3937

40-
These paths override both `/etc` and `/usr/share/defaults` for the owning user.
38+
System configuration lookups follow a strict path: The user’s personal configurations are prioritized. If any fail, the system falls back to the settings under `/etc`. If any of these in turn fail, it resolves to the system defaults at `/usr/share/defaults`.
39+
4140

4241
## Where to look next
4342

0 commit comments

Comments
 (0)