Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@
- [iwd](./config/network/iwd.md)
- [NetworkManager](./config/network/networkmanager.md)
- [ConnMan](./config/network/connman.md)
- [Network Filesystems](./config/network-filesystems.md)
- [Session and Seat Management](./config/session-management.md)
- [Graphical Session](./config/graphical-session/index.md)
- [Graphics Drivers](./config/graphical-session/graphics-drivers/index.md)
Expand Down
71 changes: 71 additions & 0 deletions src/config/network-filesystems.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
# Network Filesystems

## NFS

### Mounting an NFS Share

To mount an NFS share, start by installing the `nfs-utils` and `sv-netmount`
packages.

Before mounting an NFS share, [enable](./services/index.md#enabling-services)
the `statd`, `procbind`, and `sv-netmount` services. If the server supports
`nfs4`, the `statd` service isn't necessary.

To mount an NFS share:

```
# mount -t <mount_type> <host>:/path/to/sourcedir /path/to/destdir
```

`<mount_type>` should be `nfs4` if the server supports it, or `nfs` otherwise.
`<host>` can be either the hostname or IP address of the server.

Mounting options can be found in
[mount.nfs(8)](https://man.voidlinux.org/mount.nfs.8), while unmounting options
can be found in [umount.nfs(8)](https://man.voidlinux.org/umount.nfs.8).

For example, to connect `/volume` on a server at `192.168.1.99` to an existing
`/mnt/volume` directory on your local system:

```
# mount -t nfs 192.168.1.99:/volume /mnt/volume
```

To have the directory mounted when the system boots, add an entry to
[fstab(5)](https://man.voidlinux.org/fstab.5):

```
192.168.1.99:/volume /mnt/volume nfs rw,hard,intr 0 0
```

Refer to [nfs(5)](https://man.voidlinux.org/nfs.5) for information about the
available mounting options.

### Setting up a server (NFSv4, Kerberos disabled)

To run an NFS server, start by installing the `nfs-utils` package.

Edit `/etc/exports` to add a shared volume:

```
/storage/foo *.local(rw,no_subtree_check,no_root_squash)
```

This line exports the `/storage/foo` directory to any host in the local domain,
with read/write access. For information about the `no_subtree_check` and
`no_root_squash` options, and available options more generally, refer to
[exports(5)](https://man.voidlinux.org/exports.5).

Finally, [enable](./services/index.md#enabling-services) the `rpcbind`, `statd`,
and `nfs-server` services.

This will start your NFS server. To check if the shares are working, use the
[showmount(8)](https://man.voidlinux.org/showmount.8) utility to check the NFS
server status:

```
# showmount -e localhost
```

You can use [nfs.conf(5)](https://man.voidlinux.org/nfs.conf.5) to configure
your server.