singularity(1) singularity(1) (NAME) singularity-run - (SYNOPSIS) singularity run [run options...] [args...] (DESCRIPTION) Singularity/Apptainer runscript . (runscript) . ( ) . runscript . singularity run : *.sif (SIF). Singularity ( . ) Apptainer ( .. ) *.sqsh SquashFS. Singularity . *.img ext3. Singularity .. directory/ (sandbox). Singularity/Apptainer. instance://* . ( instance.) library://* SIF Library ( ) docker://* Docker/OCI Docker Hub OCI. shub://* Singularity Hub. oras://* SIF OCI OCI Registry As Storage (ORAS). ipfs://* SIF IPFS HTTP. (OPTIONS) --add-caps="" (capabilities) --allow-setuid[=false] setuid ( ) --app="" --apply-cgroups="" cgroups ( ) --authfile="" / OCI -B, --bind=[] bind . src[:dest[:opts]] src dest . dest src . ('opts') 'ro' () 'rw' (/ ) . bind . --blkio-weight=0 Block IO --blkio-weight-device=[] Block IO --cdi-dirs=[] CDI JSON . /etc/cdi,/var/run/cdi . -e, --cleanenv[=false] --compat[=false] OCI/Docker. --containall, --no-init, --no-umask, --no-eval, --writable-tmpfs . -c, --contain[=false] dev/ ( tmp/ HOME$) -C, --containall[=false] PID IPC --cpu-shares=-1 (CPU shares) --cpus="" CPU --cpuset-cpus="" CPU --cpuset-mems="" --cwd="" (payload) ( --pwd) --device=[] () CDI. CDI VENDOR CLASS NAME vendor.com/device=mydevice . . --disable-cache[=false] () --dns="" DNS resolv.conf --docker-host="" --docker-login[=false] --drop-caps="" --env=[] --env-file=[] -f, --fakeroot[=false] ( ) --fusemount=[] FUSE ': ' - 'container' 'host' ('container-daemon' 'host- daemon' FUSE ). FUSE . FUSE . : 'container:sshfs 10.0.0.1:/ /sshfs'. --pid . -h, --help[=false] run -H, --home="/build" . src src:dest . src dest . --hostname="" --intel-hpu[=false] Intel(R) Gaudi dev/ -i, --ipc[=false] IPC --keep-privs[=false] ( ) --memory="" --memory-reservation="" (soft limit) --memory-swap="" Swap -1 --mount=[] 'type=bind,source=/opt,destination=/hostopt'. 'nonested' . -n, --net[=false] ( bridge ) --netns-path="" ( apptainer.conf) --network="" --network-args=[] CNI --no-env=[] --no-eval[=false] CMD/ENTRYPOINT/ARGS OCI --no-home[=false] home/ --no-https[=false] http https URI docker:// oras:// ...///:library --no-init[=false] shim --pid --no-mount=[] 'mount xxx' apptainer.conf bind 'bind-paths' bind. --no-pid[=false] PID --no-privs[=false] --no-umask[=false] umask umask 0022 --nv[=false] Nvidia --nvccli[=false] nvidia-container-cli () --oom-kill-disable[=false] OOM ( ) -o, --overlay=[] overlayFS --passphrase[=false] --pem-path="" RSA PEM -p, --pid[=false] PID --pids-limit=0 (PID) -1 --rocm[=false] Rocm --runscript-timeout="" (timeout) runscript ( 1m) -S, --scratch=[] scratch ( -W ) --security=[] (SELinux, Apparmor, Seccomp) --sharens[=false] --unsquash[=false] SIF (sandbox) -u, --userns[=false] --uts[=false] UTS -W, --workdir="" tmp/ var/tmp/ HOME$ ( c/--contain-) -w, --writable[=false] Singularity/Apptainer . / . --writable-tmpfs[=false] - ( overlay) (EXAMPLES) # runscript "Hello world: " $ singularity exec /tmp/debian.sif cat /singularity #!/bin/sh echo "Hello world: " # $ singularity run /tmp/debian.sif one two three Hello world: one two three # $ ./tmp/debian.sif one two three (SEE ALSO) singularity(1) (HISTORY) 30-Jul-2026 spf13/cobra Auto generated by spf13/cobra Jul 2026 singularity(1)