Instructions for podman

[MarDiehl]

The instructions on https://joss.readthedocs.io/en/latest/paper.html#docker are specific to Docker. Podman is an alternative on many linux platforms that does not require root. The adjusted command is

 podman run --rm \
    --volume $PWD/paper:/data \
    --userns=keep-id \
    --env JOURNAL=joss \
    docker.io/openjournals/inara

It would be helpful to have it in the official documentation.

[casper06]

Opened a PR (#1566) that adds a Podman subsection right after the existing
Docker instructions in docs/paper.md, using the command from the issue
description. Happy to adjust based on feedback!

[warrickball]

I have very little experience with either Docker or Podman but how does your command compare with what I was given in a similar issue in the inara repo?

podman run --rm -it \
    -v $PWD:/data \
    openjournals/inara \
    -o pdf,crossref \
    ./paper.md

That doesn't actually work for me anyway. If I change to a directory with a paper.md, I get

$ podman run --rm -it -v $PWD:/data openjournals/inara -o pdf,crossref ./paper.md
pandoc: paper.md: withBinaryFile: permission denied (Permission denied)

But your command doesn't seem to work for me either:

$ podman run --rm --volume $PWD:/data --userns=keep-id --env JOURNAL=joss docker.io/openjournals/inara
mkdir: can't create directory 'jats': Permission denied

This is all with Podman from the system packages on Fedora 43. This is also after a fresh download of the container image, in that it seemed to download all the blobs again when I first ran either of these commands.

[MarDiehl]

I've tested it again and it works for the conditions given for the docker command: "In the example below, the paper.md file is in the paper directory.".