apptainer(1) apptainer(1) (NAME) apptainer-instance-run - (SYNOPSIS) apptainer instance run [ start...] [ runscript...] (DESCRIPTION) instance run (instance) . runscript (metadata) instance run . runscript . : Apptainer . . apptainer instance run : *.sif (SIF). Singularity (3.0+) Apptainer (v1.0.0+) *.sqsh SquashFS. Singularity 2.4 *.img ext3. Singularity 2.4. directory/ (). 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="" --allow-setuid[=false] setuid ( ) --app="" --apply-cgroups="" cgroups ( ) --authfile="" / OCI -B, --bind=[] (user-bind). src[:dest[:opts]] src dest . dest src . ('opts') 'ro' ( ) 'rw' (/ ) . . --blkio-weight=0 Block IO --blkio-weight-device=[] / (Block IO) --boot[=false] sbin/init/ ( ) -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="" --cpuset-cpus="" --cpuset-mems="" --disable-cache[=false] () --dmtcp-launch="" (checkpoint) dmtcp () --dmtcp-restart="" dmtcp () --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="" (hostname) --intel-hpu[=false] Intel(R) Gaudi dev/ -i, --ipc[=false] (namespace) IPC --keep-privs[=false] ( ) --memory="" --memory-reservation="" --memory-swap="" Swap - Swap --mount=[] 'type=bind,source=/opt,destination=/hostopt'. 'nonested' APPTAINER_BIND . -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 ://docker ://oras .../:///library --no-init[=false] shim pid-- --no-mount=[] 'mount xxx' apptainer.conf / 'bind-paths' . --no-privs[=false] --no-umask[=false] umask umask 0022 --nv[=false] Nvidia --nvccli[=false] nvidia-container-cli GPU () --oom-kill-disable[=false] (OOM killer) -o, --overlay=[] overlayFS --passphrase[=false] (passphrase) --pem-path="" RSA PEM --pid-file="" PID --pids-limit=0 PID - --rocm[=false] Rocm --runscript-timeout="" (timeout) runscript ( 1m) -S, --scratch=[] (scratch) ( W- ) --security=[] (SELinux Apparmor Seccomp) --unsquash[=false] SIF -u, --userns[=false] (user namespace) --uts[=false] UTS -W, --workdir="" tmp/ var/tmp/ HOME$ ( c/--contain- ) -w, --writable[=false] Apptainer . / . --writable-tmpfs[=false] / ( overlay) (EXAMPLE) $ apptainer instance run /tmp/my-sql.sif mysql $ apptainer shell instance://mysql Apptainer my-sql.sif> pwd /home/mibauer/mysql Apptainer my-sql.sif> ps PID TTY TIME CMD 1 pts/0 00:00:00 appinit 2 pts/0 00:00:00 bash 3 pts/0 00:00:00 ps Apptainer my-sql.sif> $ apptainer instance stop /tmp/my-sql.sif mysql Stopping /tmp/my-sql.sif mysql (SEE ALSO) apptainer-instance(1) (HISTORY) 30-Jul-2026 spf13/cobra Auto generated by spf13/cobra Jul 2026 apptainer(1)