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
{{ message }}
This repository was archived by the owner on Oct 12, 2026. It is now read-only.
Repository navigation
Commit b9736e1
Browse filesBrowse the repository at this point in the historyBrowse files
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.
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.
10
10
11
11
## System defaults
12
12
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.
14
14
15
15
| Purpose | Default location | Example contents |
16
16
| --- | --- | --- |
@@ -21,23 +21,22 @@ Default files mirror the traditional `/etc` hierarchy under `/usr/share/defaults
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.
26
25
27
26
## System overrides
28
27
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.
31
29
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`.
32
30
33
31
## User-level configuration
34
32
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:
36
34
37
35
-`~/.config` for configuration files
38
36
-`~/.local/share` for data files
39
37
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`.
0 commit comments