Merge pull request #777 from uaf-arctic-eco-modeling/iss-776-podman-instructions

Add note to readme and documentation about using Podman.

Author: tobeycarman

README.md

@@ -29,6 +29,13 @@ command line.
 
 More details are available in the [User Guide - Basic Model Setup and Run](https://uaf-arctic-eco-modeling.github.io/dvm-dos-tem/examples_and_tutorials/basic_model_run.html#basic-model-setup-and-run).
 
+> [!TIP]
+> These instructions should work for users with [Podman](https://podman.io)
+> rather than Docker, but several additional steps may be necessary to ensure
+> that Podman can run with non-root access. See this
+> [issue](https://github.com/uaf-arctic-eco-modeling/dvm-dos-tem/issues/776)
+> for more information.
+
 The settings shown here will use the input data that is shipped with the code in the
 repository's ``demo-data/`` directory. The run will output a single variable (GPP), 
 and will run for 2 pixels.

docs_src/sphinx/source/examples_and_tutorials/basic_model_run.rst

@@ -20,6 +20,15 @@ and visualization, see the :ref:`Plotting Example
   For users who have Docker and Git installed and some familiarity with the 
   command line.
 
+  .. note::
+
+    These instructions should work for users with `Podman <https://podman.io>`_
+    rather than Docker, but several additional steps may be necessary to ensure
+    that Podman can run with non-root access. See this
+    `issue <https://github.com/uaf-arctic-eco-modeling/dvm-dos-tem/issues/776>`_
+    for more information.
+
+
   The settings shown here will use the input data that is shipped with the code
   in the repository's ``demo-data/`` directory. The run will output a single
   variable (GPP), and will run for 2 pixels.
@@ -148,6 +157,14 @@ The dependencies for a piece of software are isolated inside the container. This
 isolation allows software with conflicting dependencies to run on the host
 system.
 
+.. hint::
+
+  These instructions should work for users with `Podman <https://podman.io>`_
+  rather than Docker, but several additional steps may be necessary to ensure
+  that Podman can run with non-root access. See this
+  `issue <https://github.com/uaf-arctic-eco-modeling/dvm-dos-tem/issues/776>`_
+  for more information.
+
 There are other ways you can get the environment necessary for running,
 compiling and developing ``dvmdostem``, such as a native installation, or using
 a virtual machine (e.g. with Vagrant and Virtual Box or VMWare). Each path to a