Automatically clones a Git repository into the volume on mount and removes it on unmount.

docker plugin install nerjs/gitvol

Create a volume by specifying a repository URL and (optionally) a tag or branch:

docker volume create -d nerjs/gitvol \ -o url=https://github.com/username/repository.git \ -o tag=v1.0.0 \ my-repo

Run a container with the volume:

docker run --rm -it -v my-repo:/data alpine ls -la /data

Remove the volume:

docker volume rm my-repo

version: "3.8"services: app: image: alpinecommand: ["ls", "-la", "/data"]volumes: - my-repo:/datavolumes: my-repo: driver: nerjs/gitvoldriver_opts: url: https://github.com/nerjs/gitvol.git# Choose ONE of the two lines below (or omit both). Tags are recommended.# tag: v1.0.0# branch: main

• url (required) — Git-compatible repository URL. See Git URLs (now supported only http(s)).

• tag (optional) — checkout a specific tag (recommended).

• branch (optional) — checkout a branch. Not recommended since branch contents may change between mounts.

• refetch (optional, default "false") — when set to "true", the plugin runs git fetch on each mount attempt, so the repository is updated if there are changes upstream.

tag and branch are mutually exclusive.

• The repository is cloned once per volume (unique per volume name, but not per container).

• Multiple containers can share the same volume — they all see the same underlying clone.

version: '3'services: static1: volumes: - 'my-vol:/srv/http'ports: - '8080:8043'image: 'pierrezemb/gostatic'static2: volumes: - 'my-vol:/srv/http'ports: - '8081:8043'image: 'pierrezemb/gostatic'volumes: my-vol: driver: nerjs/gitvoldriver_opts: url: https://github.com/nerjs/gitvol-test.gitrefetch: "true"

Both static1 and static2 mount the same volume. With refetch: "true", restarting one container (e.g. docker compose restart static1) triggers a git fetch in the volume, so both containers see updated repository contents.

Currently supported via embedding credentials into the URL, e.g.:

docker volume create -d nerjs/gitvol \ -o url=https://<github_pat_token>@github.com/nerjs/gitvol.git \ my-private-repo