Warning

You're browsing the documentation for an old version of Apptainer. Consider upgrading to the latest version of Apptainer.

Documentation for the latest version can always be found at:
https://apptainer.org/docs/user/latest/

apptainer run-help

Show the user-defined help for an image

Synopsis

The help text is from the ‘%help’ section of the definition file. If you are using the ‘–apps’ option, the help text is instead from that app’s ‘%apphelp’ section.

apptainer run-help <image path>

Examples

$ cat my_container.def
Bootstrap: docker
From: busybox

%help
    Some help for this container

%apphelp foo
    Some help for application 'foo' in this container

$ sudo apptainer build my_container.sif my_container.def
Using container recipe deffile: my_container.def
[...snip...]
Cleaning up...

$ apptainer run-help my_container.sif

  Some help for this container

$ apptainer run-help --app foo my_container.sif

  Some help for application in this container

Options

    --app string   show the help for an app
-h, --help         help for run-help

SEE ALSO

apptainer -

Linux container platform optimized for High Performance Computing (HPC) and Enterprise Performance Computing (EPC)

Auto generated by spf13/cobra on 16-Feb-2023