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

Commit 504b47e

Browse files
committed
Updating documentation
1 parent 8596337 commit 504b47e

File tree

7 files changed

+31
-22
lines changed

7 files changed

+31
-22
lines changed

README.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# erichough/nfs-server
1+
# obeone/nfs-server (forked from erichough/nfs-server)
22

33
A lightweight, robust, flexible, and containerized NFS server.
44

@@ -17,6 +17,11 @@ This is the only containerized NFS server that offers **all** of the following f
1717
- [NFSv4 user ID mapping](https://github.com/ehough/docker-nfs-server/blob/develop/doc/feature/nfs4-user-id-mapping.md) via [`idmapd`](http://man7.org/linux/man-pages/man8/idmapd.8.html)
1818
- [AppArmor](https://github.com/ehough/docker-nfs-server/blob/develop/doc/feature/apparmor.md) compatibility
1919

20+
This forked version add the following features :
21+
22+
- Support for arch : linux/amd64, linux/arm64, linux/i386, linux/armhf, linux/armel
23+
- Build everyday to stay up-to-date with upstream distribution (alpine)
24+
2025
## Table of Contents
2126

2227
* [Requirements](#requirements)
@@ -56,14 +61,14 @@ This is the only containerized NFS server that offers **all** of the following f
5661

5762
### Starting the server
5863

59-
Starting the `erichough/nfs-server` image will launch an NFS server. You'll need to supply some information upon container startup, which we'll cover below, but briefly speaking your `docker run` command might look something like this:
64+
Starting the `ghcr.io/obeone/nfs-server` image will launch an NFS server. You'll need to supply some information upon container startup, which we'll cover below, but briefly speaking your `docker run` command might look something like this:
6065

6166
docker run \
6267
-v /host/path/to/shared/files:/some/container/path \
6368
-v /host/path/to/exports.txt:/etc/exports:ro \
6469
--cap-add SYS_ADMIN \
6570
-p 2049:2049 \
66-
erichough/nfs-server
71+
ghcr.io/obeone/nfs-server
6772

6873
Let's break that command down into its individual pieces to see what's required for a successful server startup.
6974

@@ -86,7 +91,7 @@ Let's break that command down into its individual pieces to see what's required
8691
docker run \
8792
-v /host/path/to/exports.txt:/etc/exports:ro \
8893
... \
89-
erichough/nfs-server
94+
ghcr.io/obeone/nfs-server
9095

9196
1. provide each line of `/etc/exports` as an environment variable
9297

@@ -96,26 +101,26 @@ Let's break that command down into its individual pieces to see what's required
96101
-e NFS_EXPORT_0='/container/path/foo *(ro,no_subtree_check)' \
97102
-e NFS_EXPORT_1='/container/path/bar 123.123.123.123/32(rw,no_subtree_check)' \
98103
... \
99-
erichough/nfs-server
104+
ghcr.io/obeone/nfs-server
100105

101106
1. bake `/etc/exports` into a custom image
102107

103108
e.g. in a `Dockerfile`:
104109

105110
```Dockerfile
106-
FROM erichough/nfs-server
111+
FROM ghcr.io/obeone/nfs-server
107112
ADD /host/path/to/exports.txt /etc/exports
108113
```
109114

110115
1. **Use `--cap-add SYS_ADMIN` or `--privileged`**
111116

112117
As noted in the [requirements](#requirements), the container will need additional privileges. So your `run` command will need *either*:
113118

114-
docker run --cap-add SYS_ADMIN ... erichough/nfs-server
119+
docker run --cap-add SYS_ADMIN ... ghcr.io/obeone/nfs-server
115120

116121
or
117122

118-
docker run --privileged ... erichough/nfs-server
123+
docker run --privileged ... ghcr.io/obeone/nfs-server
119124

120125
Not sure which to use? Go for `--cap-add SYS_ADMIN` as it's the lesser of two evils.
121126
@@ -125,7 +130,7 @@ Let's break that command down into its individual pieces to see what's required
125130

126131
* If your clients connect via **NFSv4 only**, you can get by with just TCP port `2049`:
127132

128-
docker run -p 2049:2049 ... erichough/nfs-server
133+
docker run -p 2049:2049 ... ghcr.io/obeone/nfs-server
129134

130135
* If you'd like to support **NFSv3**, you'll need to expose a lot more ports:
131136

@@ -135,7 +140,7 @@ Let's break that command down into its individual pieces to see what's required
135140
-p 32765:32765 -p 32765:32765/udp \
136141
-p 32767:32767 -p 32767:32767/udp \
137142
... \
138-
erichough/nfs-server
143+
ghcr.io/obeone/nfs-server
139144

140145
If you pay close attention to each of the items in this section, the server should start quickly and be ready to accept your NFS clients.
141146

doc/feature/apparmor.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,15 +27,15 @@ If your Docker host has [AppArmor](https://wiki.ubuntu.com/AppArmor) activated,
2727
--cap-add SYS_ADMIN \
2828
-p 2049:2049 \
2929
--security-opt apparmor=erichough-nfs \
30-
erichough/nfs-server
30+
ghcr.io/obeone/nfs-server
3131
3232
or in `docker-compose.yml`:
3333

3434
```YAML
3535
version: 3
3636
services:
3737
nfs:
38-
image: erichough/nfs-server
38+
image: ghcr.io/obeone/nfs-server
3939
volumes:
4040
- /path/to/share:/nfs
4141
- /path/to/exports.txt:/etc/exports:ro
@@ -45,4 +45,4 @@ If your Docker host has [AppArmor](https://wiki.ubuntu.com/AppArmor) activated,
4545
- 2049:2049
4646
security_opt:
4747
- apparmor=erichough-nfs
48-
```
48+
```

doc/feature/auto-load-kernel-modules.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Here's an example `docker-compose.yml`:
1313
version: 3
1414
services:
1515
nfs:
16-
image: erichough/nfs-server
16+
image: ghcr.io/obeone/nfs-server
1717
volumes:
1818
- /path/to/share:/nfs
1919
- /path/to/exports.txt:/etc/exports:ro
@@ -23,4 +23,4 @@ Here's an example `docker-compose.yml`:
2323
- SYS_MODULE
2424
ports:
2525
- 2049:2049
26-
```
26+
```

doc/feature/kerberos.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,4 +18,4 @@ Here's an example:
1818
-v /host/path/to/server.krb5conf:/etc/krb5.conf:ro \
1919
--cap-add SYS_ADMIN \
2020
-p 2049:2049 \
21-
erichough/nfs-server
21+
ghcr.io/obeone/nfs-server

doc/feature/logging.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ You can adjust the logging level via the `NFS_LOG_LEVEL` environment variable. C
66

77
In your `docker-run` command:
88
```
9-
docker run -e NFS_LOG_LEVEL=DEBUG ... erichough/nfs-server
9+
docker run -e NFS_LOG_LEVEL=DEBUG ... ghcr.io/obeone/nfs-server
1010
```
1111
or in `docker-compose.yml`:
1212
```YAML
1313
version: 3
1414
services:
1515
nfs:
16-
image: erichough/nfs-server
16+
image: ghcr.io/obeone/nfs-server
1717
...
1818
environment:
1919
- NFS_LOG_LEVEL: DEBUG
@@ -159,4 +159,4 @@ writing message: \x \x6082024606092a864886f71201020201006e82023530820231a0030201
159159
finished handling null request
160160
entering poll
161161
...
162-
```
162+
```

doc/feature/nfs4-user-id-mapping.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,5 @@ If you'd like to run [`idmapd`](http://man7.org/linux/man-pages/man8/idmapd.8.ht
88
-v /host/path/to/idmapd.conf:/etc/idmapd.conf:ro \
99
--cap-add SYS_ADMIN \
1010
-p 2049:2049 \
11-
erichough/nfs-server
12-
11+
ghcr.io/obeone/nfs-server
12+

entrypoint.sh

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,11 @@
22
#
33
# ehough/docker-nfs-server: A lightweight, robust, flexible, and containerized NFS server.
44
#
5-
# https://hub.docker.com/r/erichough/nfs-server
5+
# https://github.com/obeone/docker-nfs-server
6+
# https://github.com/obeone/docker-nfs-server/pkgs/container/docker-nfs-server
7+
#
8+
# Almost all the work is from @ehough, I just created workflow to keep the
9+
# docker image up-to-date and build for multiple architectures
610
# https://github.com/ehough/docker-nfs-server
711
#
812
# Copyright (C) 2017-2020 Eric D. Hough

0 commit comments

Comments
 (0)