Skip to content

Latest commit

 

History

History
102 lines (72 loc) · 3.81 KB

README.md

File metadata and controls

102 lines (72 loc) · 3.81 KB
Raw

Description

NFS-Ganesha is a user-mode file server for NFS (v3, 4.0, 4.1, 4.1 pNFS, 4.2)

Supported tags

  • 3.x-BUILD, 3.X, 3, latest

Where X is the patch version number, and BUILD is the build number (look into project Tags page to discover the latest versions)

Dockerfile

Features

  • Small image footprint based on Debian 9 (stretch) Slim
  • NFS Ganesha binaries are taken from upstream official repository
  • Using tini as init process
  • Many customizable variables to use

What is nfs-ganesha?

Nfs-ganesha is a user-mode file server for NFS (v3, 4.0, 4.1, 4.1 pNFS, 4.2) and for 9P from the Plan9 operating system. It can support all these protocols concurrently. This is an Open Source project with an active community of both company sponsored and independent developers.

How to use this image.

This image only contains nfs-ganesha from official home page and from official download repository

Environment variables

You can change the default behaviour using the following variables (with default values):

: ${EXPORT_PATH:="/exports"}
: ${PSEUDO_PATH:="/exports"}
: ${EXPORT_ID:=1}
: ${PROTOCOLS:=4}
: ${TRANSPORTS:="UDP, TCP"}
: ${SEC_TYPE:="sys"}
: ${SQUASH_MODE:="No_Root_Squash"}
: ${GRACELESS:=false}
: ${GRACE_PERIOD:=90}
: ${ACCESS_TYPE:="RW"}
: ${CLIENT_LIST:="10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16"}
: ${DISABLE_ACL:=false}
: ${ANON_USER:="nobody"}
: ${ANON_GROUP:="nogroup"}
: ${GANESHA_CONFIG:="/etc/ganesha/ganesha.conf"}
: ${GANESHA_LOGFILE:="/dev/stdout"}
: ${LOG_LEVEL:="INFO"}
: ${LOG_COMPONENT:="ALL=INFO;"}

Create a Dockerfile in your project

FROM izdock/nfs-ganesha
# your commands here

Then, run the commands to build and run the Docker image:

$ docker build -t nfs-ganesha .
$ docker run -dit --name nfs-ganesha -p 2049:2049 -p 111:111 nfs-ganesha

Without a Dockerfile

If you don't want to include a Dockerfile in your project, it is sufficient to do the following:

$ docker run -dit --name my-nfs -p 2049:2049 -p 111:111 -v "/tmp/testvolme":/data izdock/nfs-ganesha

Configuration

To customize the configuration of nfs-ganesha, just change the default variables:

docker run -dit --name my-nfs -p 2049:2049 -p 111:111 -v "/tmp/testvolme":/data -e CLIENT_LIST="192.168.1.1, 192.168.1.23" -e LOG_LEVEL=DEBUG izdock/nfs-ganesha

Quick reference

License

View Apache license information and PHP license information and for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in the repo-info repository's httpd/ directory.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.