Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Feat] Explain docker image usage #470

Open
neteler opened this issue Sep 3, 2024 · 3 comments
Open

[Feat] Explain docker image usage #470

neteler opened this issue Sep 3, 2024 · 3 comments
Labels
enhancement New feature or request

Comments

@neteler
Copy link
Member

neteler commented Sep 3, 2024

We provide a set of Docker images at https://grass.osgeo.org/download/docker/

Especially for the image with GUI support, it can be difficult to get started (see related messages on the grass-user mailing list).

So let's add some usage instructions to lower the barrier:

# GRASS GIS docker image with GUI support
docker pull osgeo/grass-gis:releasebranch_8_4-ubuntu_wxgui

docker run -it --rm --volume="$(pwd)/:/data" \
       --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
       --env DISPLAY=$DISPLAY \
       --device="/dev/dri/card0:/dev/dri/card0" \
       osgeo/grass-gis:releasebranch_8_4-ubuntu_wxgui \
       grass --gui

Possibly this could be an expandable info button or something like that to not clutter the page.

@neteler neteler added the enhancement New feature or request label Sep 3, 2024
@wenzeslaus
Copy link
Member

What about a link to a readme file in a directory with Dockerfiles which at least somewhat serves as a doc for our Docker images?

@neteler
Copy link
Member Author

neteler commented Sep 30, 2024

So I will expand
https://github.com/OSGeo/grass/blob/main/docker/README.md

Once merged it may be added to the docker download page.

@cwhite911
Copy link
Contributor

@neteler I included the existing text from the GRASS README in PR #427, but will switch it once it is merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

3 participants