Files
cheatsheet-tldr/tldr/linux/apptainer-run
2026-01-25 00:25:05 +00:00

44 lines
1.2 KiB
Plaintext

---
syntax: markdown
tags: [tldr, linux]
source: https://github.com/tldr-pages/tldr.git
---
# apptainer run
> Run the default runscript of an Apptainer container.
> The runscript is defined in the `%runscript` section of the container's definition file.
> See also: `apptainer exec`, `apptainer shell`.
> More information: <https://apptainer.org/docs/user/main/cli/apptainer_run.html>.
- Run the default runscript of a container:
`apptainer run {{path/to/image.sif}}`
- Run with arguments passed to the runscript:
`apptainer run {{path/to/image.sif}} {{arg1 arg2 ...}}`
- Run with a bind mount from host to container:
`apptainer run {{[-B|--bind]}} {{path/to/source}}:{{path/to/destination}} {{path/to/image.sif}}`
- Run with environment variables:
`apptainer run --env {{variable}}={{value}} {{path/to/image.sif}}`
- Run in fully isolated mode (contained filesystem, PID, IPC, and clean environment):
`apptainer run {{[-C|--containall]}} {{path/to/image.sif}}`
- Run with a writable temporary filesystem overlay:
`apptainer run --writable-tmpfs {{path/to/image.sif}}`
- Run with NVIDIA GPU support:
`apptainer run --nv {{path/to/image.sif}}`
- Display help:
`apptainer run {{[-h|--help]}}`