From 2061092ec558c6fb7dd303bf1aa048c3789a78c6 Mon Sep 17 00:00:00 2001 From: "James R. Barlow" Date: Wed, 18 Oct 2017 12:37:27 -0700 Subject: [PATCH] Describe how to stream with Docker [ci skip] --- docs/installation.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/installation.rst b/docs/installation.rst index dfd0929c..cc69051a 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -105,6 +105,12 @@ In this worked example, the current working directory contains an input file cal Note that ``ocrmypdf`` has its own separate ``-v VERBOSITYLEVEL`` argument to control debug verbosity. All Docker arguments should before the ``ocrmypdf`` image name and all arguments to ``ocrmypdf`` should be listed after. +In some environments the permissions associated with Docker can be complex to configure. The process that executes Docker may end up not having the permissions to write the specified file system. In that case one can stream the file into and out of the Docker process and avoid all permission hassles, using ``-`` as the input and output filename: + +.. code-block:: bash + + docker run --rm -i ocrmypdf - - output.pdf + For convenience, a shell alias can hide the docker command: .. code-block:: bash