{"id":19747483,"url":"https://github.com/moosefs/docker-volume-moosefs","last_synced_at":"2025-04-30T08:32:28.085Z","repository":{"id":57607149,"uuid":"128723539","full_name":"moosefs/docker-volume-moosefs","owner":"moosefs","description":"Docker Volume Plugin for MooseFS to create persistent volumes in Docker containers","archived":false,"fork":false,"pushed_at":"2023-03-10T13:45:58.000Z","size":13,"stargazers_count":25,"open_issues_count":3,"forks_count":5,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-06T00:11:14.377Z","etag":null,"topics":["docker","docker-volume-plugin","moosefs","persistent-storage","storage"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moosefs.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-09T06:16:28.000Z","updated_at":"2025-03-09T06:24:40.000Z","dependencies_parsed_at":"2024-06-20T14:46:52.952Z","dependency_job_id":"e479d14a-9f9e-496b-92ae-5c7a67cc40f5","html_url":"https://github.com/moosefs/docker-volume-moosefs","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moosefs%2Fdocker-volume-moosefs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moosefs%2Fdocker-volume-moosefs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moosefs%2Fdocker-volume-moosefs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moosefs%2Fdocker-volume-moosefs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moosefs","download_url":"https://codeload.github.com/moosefs/docker-volume-moosefs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251668837,"owners_count":21624743,"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":["docker","docker-volume-plugin","moosefs","persistent-storage","storage"],"created_at":"2024-11-12T02:17:58.785Z","updated_at":"2025-04-30T08:32:27.831Z","avatar_url":"https://github.com/moosefs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Volume Plugin for MooseFS\n\nPlugin for MooseFS to create persistent volumes in Docker containers.\n\n\u003cimg align=\"right\" alt=\"MooseFS logo\" src=\"https://moosefs.com/Content/Images/moosefs.png\" /\u003e\n\n## Version history:\n\n- 0.2.0 Creates new subdirectory for each volume in root e.g. /mnt/moosefs\n- 0.1.0 Mountpoint /mnt/moosefs is used as the volume\n\n## Preconditions\n\n- **MooseFS** Storage Cluster has to be setup and running\n- **MooseFS** Client should be installed on host machine\n- **MooseFS** is mounted in one of host directories\n\n## Installation\n\nWe provide pre-built binary **rpm** and **deb** packages available from the [releases](https://github.com/moosefs/docker-volume-moosefs/releases) page. You can download them and go to **installation** for your OS.\n\n### RedHat/CentOS\n\nPre-built **rpm** package can be downloaded from [releases](https://github.com/moosefs/docker-volume-moosefs/releases) or can be built with following commands:\n\n```\nmake rpm-deps\nmake\nmake rpm\n```\n\n**Installation**\n\nInstall and start the service:\n\n```\nyum localinstall docker-volume-moosefs-$VERSION.rpm\nsystemctl start docker-volume-moosefs\n```\n\n**Deb** package can be also build using following command:\n\n```\nmake deb\n```\n\n### Debian\n\nPre-built **deb** package can be downloaded from [releases](https://github.com/moosefs/docker-volume-moosefs/releases) or can be built with following commands:\n\n```\nmake deb-deps\nmake\nmake deb\n```\n\n**Installation**\n\nInstall and start the service:\n\n```\ndpkg -i docker-volume-moosefs_$VERSION.deb\nsystemctl start docker-volume-moosefs\n```\n\n**Rpm** package can be also build using following command:\n\n```\nmake rpm\n```\n\n## Usage example\n\nAssuming we have **MooseFS** mounted in `/mnt/moosefs` we will create a volume labeled `mymoosefs`:\n\n```\ndocker volume create -d moosefs --name mymoosefs -o root=/mnt/moosefs\n```\n\nWithout specified mountpoint plugin will assume mounting in `/mnt/moosefs/$NAME`, so **mymoosefs** will be mounted in `/mnt/moosefs/mymoosefs`\n\nWe can use shorter command: `docker volume create -d moosefs --name mymoosefs`\n\nWe can inspect created volume with following command:\n\n```\ndocker volume inspect mymoosefs\n```\n\nNow we can use our `mymoosefs` **MooseFS Volume** in example container such as Nginx. Following command will mount our storage to `/usr/share/nginx/html` directory, where nginx stores html files. We are forwarding port 80 from container to [http://localhost:10080](http://localhost:10080). This command will start Nginx in container:\n\n```\ndocker run -ti -v mymoosefs:/usr/share/nginx/html -p 10080:80 nginx:latest bash -c \"service nginx start; bash\"\n```\n\nNow we can check that Nginx created two html files in `/mnt/moosefs`:\n\n```\nls /mnt/moosefs\n  50x.html  index.html\n```\n\nThese file will still exist in MooseFS, after shutting down the container or removing volume.\n\n\nTo remove the volume (note that this will ***NOT*** remove the actual data):\n\n```\ndocker volume rm mymoosefs\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoosefs%2Fdocker-volume-moosefs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoosefs%2Fdocker-volume-moosefs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoosefs%2Fdocker-volume-moosefs/lists"}