Filesystems: Difference between revisions

(15 intermediate revisions by 10 users not shown)

Line 1:

{{ic|fileSystems}} is a [https://nixos.org/manual/nixos/stable/options.html#opt-fileSystems ~~NixOS~~] ~~option that allows the~~ user to mount ~~filesystems at specific~~ mount ~~points~~. The ~~mounted filesystems~~ may ~~also~~ be ~~encrypted~~.

[[category:filesystem]]

{{ic|fileSystems}} is a NixOS[[Category:NixOS]] option that allows the user to mount filesystems at specific mount points. The mounted filesystems may also be encrypted. Also see [https://nixos.org/manual/nixos/stable/options.html#opt-fileSystems the fileSystem option documentation].

For boot mount options, [https://manpages.ubuntu.com/manpages/noble/en/man8/mount.8.html#filesystem-independent%20mount%20options check here].

Common example filesystem mount. You can put this in configuration.nix:

fileSystems."/mnt/exampleDrive" = {

device = "/dev/disk/by-uuid/4f999afe-6114-4531-ba37-4bf4a00efd9e";

fsType = "exfat";

options = [ # If you don't have this options attribute, it'll default to "defaults"

# boot options for fstab. Search up fstab mount options you can use

"users" # Allows any user to mount and unmount

"nofail" # Prevent system from failing if this drive doesn't mount

"exec" # Permit execution of binaries and other executable files

];

};

</syntaxhighlight>

== Making disk visible in your file explorer ==

You might not see the disk in your file explorer (ie GNOME Nautilus). Add to the options: <code>x-gvfs-show</code> and it'll show up.

== Porting /etc/fstab ==

The options specified in /etc/fstab may not be fully compatible with NixOS fileSystems options. For example, here are some options NixOS doesn't recognize that are available on some Linux distributions:

* iocharset

* rw (but it seems to not be needed)

* uid with username rather than actual uid

== Mount order ==

Line 10:

Line 37:

Bind mounting allows a filesystem hierarchy or a file to be mounted at a different mount point. Unlike a symbolic link, a bind mount does not exist on the filesystem itself.~~[3] In the following example, the path {{ic|/olddir}} will be mounted in {{ic|/newdir}}~~

Bind mounting allows a filesystem hierarchy or a file to be mounted at a different mount point. Unlike a symbolic link, a bind mount does not exist on the filesystem itself.<ref>[https://en.wikipedia.org/wiki/Mount_(Unix)#Bind_mounting Wikipedia - Bind mount]</ref>

<ref>[https://en.wikipedia.org/wiki/Mount_(Unix)#Bind_mounting Wikipedia - Bind mount]</ref>

</blockquote>

Line 38:

Line 64:

};

</syntaxhighlight>

== Tips and tricks ==

=== SSD TRIM support ===

On NixOS, [https://en.wikipedia.org/wiki/Trim_(computing) TRIM] support is enabled by default by the {{nixos:option|services.fstrim.enable}} option. This periodically discards unused blocks on supported storage devices, helping to maintain SSD performance over time.

The trimming schedule is controlled by the {{nixos:option|services.fstrim.interval}} option. Continuous trimming (as set by the <code>discard</code>, see <code>man mount(8)</code>) mount option is not recommended as it can negatively impact SSD performance.

Additionally, setting <code>noatime</code> can reduce the number of disk writes and can improve system performance.

{{file|/etc/nixos/configuration.nix|nix|

fileSystems."/".options = [ "noatime" ];

</nowiki>

}}

= References =

@@ Line 1: / Line 1: @@
-{{ic|fileSystems}} is a [https://nixos.org/manual/nixos/stable/options.html#opt-fileSystems NixOS] option that allows the user to mount filesystems at specific mount points. The mounted filesystems may also be encrypted.
+[[category:filesystem]]
+{{ic|fileSystems}} is a NixOS[[Category:NixOS]] option that allows the user to mount filesystems at specific mount points. The mounted filesystems may also be encrypted. Also see [https://nixos.org/manual/nixos/stable/options.html#opt-fileSystems the fileSystem option documentation].
+For boot mount options, [https://manpages.ubuntu.com/manpages/noble/en/man8/mount.8.html#filesystem-independent%20mount%20options check here].
+Common example filesystem mount. You can put this in configuration.nix:
+<syntaxhighlight lang="nix">
+ fileSystems."/mnt/exampleDrive" = {
+   device = "/dev/disk/by-uuid/4f999afe-6114-4531-ba37-4bf4a00efd9e";
+   fsType = "exfat";
+   options = [ # If you don't have this options attribute, it'll default to "defaults"
+     # boot options for fstab. Search up fstab mount options you can use
+     "users" # Allows any user to mount and unmount
+     "nofail" # Prevent system from failing if this drive doesn't mount
+     "exec" # Permit execution of binaries and other executable files
+   ];
+ };
+</syntaxhighlight>
+== Making disk visible in your file explorer ==
+You might not see the disk in your file explorer (ie GNOME Nautilus). Add to the options: <code>x-gvfs-show</code> and it'll show up.
+== Porting /etc/fstab ==
+The options specified in /etc/fstab may not be fully compatible with NixOS fileSystems options. For example, here are some options NixOS doesn't recognize that are available on some Linux distributions:
+* iocharset
+* rw (but it seems to not be needed)
+* uid with username rather than actual uid
 == Mount order ==
@@ Line 10: / Line 37: @@
 <blockquote>
-Bind mounting allows a filesystem hierarchy or a file to be mounted at a different mount point. Unlike a symbolic link, a bind mount does not exist on the filesystem itself.[3] In the following example, the path {{ic|/olddir}} will be mounted in {{ic|/newdir}}
+Bind mounting allows a filesystem hierarchy or a file to be mounted at a different mount point. Unlike a symbolic link, a bind mount does not exist on the filesystem itself.<ref>[https://en.wikipedia.org/wiki/Mount_(Unix)#Bind_mounting Wikipedia - Bind mount]</ref>
-<ref>[https://en.wikipedia.org/wiki/Mount_(Unix)#Bind_mounting Wikipedia - Bind mount]</ref>
 </blockquote>
@@ Line 38: / Line 64: @@
 };
 </syntaxhighlight>
+== Tips and tricks ==
+=== SSD TRIM support ===
+On NixOS, [https://en.wikipedia.org/wiki/Trim_(computing) TRIM] support is enabled by default by the {{nixos:option|services.fstrim.enable}} option. This periodically discards unused blocks on supported storage devices, helping to maintain SSD performance over time.
+The trimming schedule is controlled by the {{nixos:option|services.fstrim.interval}} option. Continuous trimming (as set by the <code>discard</code>, see <code>man mount(8)</code>) mount option is not recommended as it can negatively impact SSD performance.
+Additionally, setting <code>noatime</code> can reduce the number of disk writes and can improve system performance.
+{{file|/etc/nixos/configuration.nix|nix|
+<nowiki>
+fileSystems."/".options = [ "noatime" ];
+</nowiki>
+}}
 = References =
+<references />
-<references/>