About the suffix ":shared" of volume option of docker container

[junwha]

Hi, first I'm really appreciate for opening this amazing project as open source.

I'm trying to follow the instruction for building MOONRAY using docker container, but found weird section.

docker run -v /source/openmoonray/building/ubuntu22.04:/building:shared  -v /optix:/optix:shared --network=host --rm -it openmoonray_base

The documentation gets me to add the suffix :shared at the end of the volume directory, but it shows an error that "[My directory] is mounted on /home but it is not a shared mount".

As I know, it is sufficient to use -v /source/openmoonray/building:/building

Is there any special purpose for the :shared keyword?
I couldn't find any matching section from docker document.

Thank you.

[rgwilson68]

There's no special purpose to :shared -- everything should work without this option

[junwha]

Then isn't it better to remove that keyword from the document? it makes the error

[vvzen]

I stumbled into this error too when trying #37 (comment), if it's not really needed, I'd vote for removing it too!

[junwha]

https://github.com/docker/docs/blob/main/storage/bind-mounts.md#configure-bind-propagation

This issue seems related to our problem
docker/for-mac#3431