{"id":13416297,"url":"https://github.com/adlogix/docker-machine-nfs","last_synced_at":"2025-03-14T23:31:37.708Z","repository":{"id":32229806,"uuid":"35803883","full_name":"adlogix/docker-machine-nfs","owner":"adlogix","description":"Activates NFS on docker-machine","archived":false,"fork":false,"pushed_at":"2021-02-15T12:10:17.000Z","size":197,"stargazers_count":796,"open_issues_count":10,"forks_count":104,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-04-22T21:08:43.637Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adlogix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-18T07:42:35.000Z","updated_at":"2024-04-22T17:30:53.000Z","dependencies_parsed_at":"2022-09-08T11:22:51.153Z","dependency_job_id":null,"html_url":"https://github.com/adlogix/docker-machine-nfs","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adlogix%2Fdocker-machine-nfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adlogix%2Fdocker-machine-nfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adlogix%2Fdocker-machine-nfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adlogix%2Fdocker-machine-nfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adlogix","download_url":"https://codeload.github.com/adlogix/docker-machine-nfs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243663514,"owners_count":20327300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T21:00:56.622Z","updated_at":"2025-03-14T23:31:33.792Z","avatar_url":"https://github.com/adlogix.png","language":"Shell","readme":"# Docker Machine NFS\n\n## Requirements\n\n* [Docker Machine](https://docs.docker.com/machine/) 0.5.0+\n\n## Mac OS X 10.9+\n\nActivates [NFS](https://en.wikipedia.org/wiki/Network_File_System) for an\nexisting boot2docker box created through\n[Docker Machine](https://docs.docker.com/machine/).\n\n:warning: There can be an issue with the NFS under Mac OS X High Sierra (see issue [#79](https://github.com/adlogix/docker-machine-nfs/issues/79) for more info) :warning:\n\n## Windows 10 with WSL\n\n* [Install WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10)\n* [Install VirtualBox](https://www.virtualbox.org/wiki/Downloads)\n* [Setup Docker-machine for WSL](https://www.paraesthesia.com/archive/2018/09/20/docker-on-wsl-with-virtualbox-and-docker-machine/)\n* [Install haneWIN NFS server](https://hanewin.net/nfs-e.htm)\n* [Install `docker-machine-nfs`](#standalone)\n* Mount drives under root (e.g. `/c`) - [Can be configured in `/etc/wsl.conf` - `automount`](https://devblogs.microsoft.com/commandline/automatically-configuring-wsl/)\n* Tested with these attributes: `docker-machine-nfs MACHINE-NAME --shared-folder=/c/Users/ --mount-opts=\"rw,vers=3,tcp,nolock,noacl,async\"`\n\n## Install\n\n### Standalone\n\n```sh\ncurl -s https://raw.githubusercontent.com/adlogix/docker-machine-nfs/master/docker-machine-nfs.sh |\n  sudo tee /usr/local/bin/docker-machine-nfs \u003e /dev/null \u0026\u0026 \\\n  sudo chmod +x /usr/local/bin/docker-machine-nfs\n```\n\n### [Homebrew](http://brew.sh/)\n\n```sh\nbrew install docker-machine-nfs\n```\n\n\n## Supports\n\n* Virtualbox\n* Parallels\n* VMware Fusion\n* VMware Vsphere\n* Xhyve\n* Hyperkit\n\n## Usage\n\n* Create `docker-machine` as usual\n* Run `docker-machine-nfs`\n\n```sh\n\n\n                       ##         .\n                 ## ## ##        ==               _   _ _____ ____\n              ## ## ## ## ##    ===              | \\ | |  ___/ ___|\n          /\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\\___/ ===            |  \\| | |_  \\___ \\\n     ~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ /  ===- ~~~     | |\\  |  _|  ___) |\n          \\______ o           __/                |_| \\_|_|   |____/\n            \\    \\         __/\n             \\____\\_______/\n\n\nUsage: $ docker-machine-nfs \u003cmachine-name\u003e [options]\n\nOptions:\n\n  -f, --force               Force reconfiguration of nfs\n  -n, --nfs-config          NFS configuration to use in /etc/exports. (default to '-alldirs -mapall=\\$(id -u):\\$(id -g)')\n  -s, --shared-folder,...   Folder to share (default to /Users)\n  -m, --mount-opts          NFS mount options (default to 'noacl,async')\n\nExamples:\n\n  $ docker-machine-nfs test\n\n    \u003e Configure the /Users folder with NFS\n\n  $ docker-machine-nfs test --shared-folder=/Users --shared-folder=/var/www\n\n    \u003e Configures the /Users and /var/www folder with NFS\n\n  $ docker-machine-nfs test --shared-folder=/var/www --nfs-config=\"-alldirs -maproot=0\"\n\n    \u003e Configure the /var/www folder with NFS and the options '-alldirs -maproot=0'\n\n  $ docker-machine-nfs test --mount-opts=\"noacl,async,nolock,nfsvers=3,udp,noatime,actimeo=1\"\n\n    \u003e Configure the /User folder with NFS and specific mount options.\n\n  $ docker-machine-nfs test --ip 192.168.1.12\n\n    \u003e docker-machine will connect to your host machine via this address\n\n```\n\n## Troubleshooting\n\n- **Failed to mount on WSL**\n```\nAllow following exe's in \"Windows Firewall\" or any other firewall software used\n   Directory -- c:/Program Files/nfsd\n   -  pmapd.exe\n   -  nfssrv.exe\n   -  nfsd.exe\n```\n\n## Credits\n\n* Heavily inspired by @[mattes](https://github.com/mattes) ruby version\n[boot2docker-nfs.rb](https://gist.github.com/mattes/4d7f435d759ca2581347).\n* @[DzeryCZ](https://github.com/DzeryCZ) added support for Windows with WSL\n","funding_links":[],"categories":["Container Operations","Docker","Shell","Volume management and plugins"],"sub_categories":["Volume Management / Data"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadlogix%2Fdocker-machine-nfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadlogix%2Fdocker-machine-nfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadlogix%2Fdocker-machine-nfs/lists"}