646b892680
Some checks failed
Periodic Merges (6h) / master → staging-nixos (push) Failing after 12m50s
Periodic Merges (6h) / master → staging-next (push) Failing after 12m54s
Periodic Merges (24h) / merge-base(master,staging) → haskell-updates (push) Failing after 11m54s
Periodic Merges (6h) / staging-next → staging (push) Failing after 12m13s
Periodic Merges (24h) / staging-next-25.05 → staging-25.05 (push) Failing after 13m24s
Periodic Merges (24h) / release-25.05 → staging-next-25.05 (push) Failing after 14m28s
30 lines
734 B
Markdown
30 lines
734 B
Markdown
# Overlayfs {#sec-overlayfs}
|
|
|
|
NixOS offers a convenient abstraction to create both read-only as well writable
|
|
overlays.
|
|
|
|
```nix
|
|
{
|
|
fileSystems = {
|
|
"/writable-overlay" = {
|
|
overlay = {
|
|
lowerdir = [ writableOverlayLowerdir ];
|
|
upperdir = "/.rw-writable-overlay/upper";
|
|
workdir = "/.rw-writable-overlay/work";
|
|
};
|
|
# Mount the writable overlay in the initrd.
|
|
neededForBoot = true;
|
|
};
|
|
"/readonly-overlay".overlay.lowerdir = [
|
|
writableOverlayLowerdir
|
|
writableOverlayLowerdir2
|
|
];
|
|
};
|
|
}
|
|
```
|
|
|
|
If `upperdir` and `workdir` are not null, they will be created before the
|
|
overlay is mounted.
|
|
|
|
To mount an overlay as read-only, you need to provide at least two `lowerdir`s.
|