singularity(1) singularity(1) (NAME) singularity-shell - (SYNOPSIS) singularity shell [shell options...] (DESCRIPTION) singularity shell : *.sif (SIF). (3.0+) Apptainer (v1.0.0+) *.sqsh SquashFS. 2.4+ *.img ext3. < 2.4. 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="" (CPUs) --cpuset-cpus="" --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] shell -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' 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 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 (GPU) () --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 -S, --scratch=[] scratch ( -W ) --security=[] (SELinux, Apparmor, Seccomp) --sharens[=false] -s, --shell="" --unsquash[=false] SIF -u, --userns[=false] --uts[=false] UTS -W, --workdir="" tmp/ var/tmp/ HOME$ ( c/--contain-) -w, --writable[=false] Singularity/Apptainer . / . --writable-tmpfs[=false] - ( overlay) (EXAMPLES) $ singularity shell /tmp/Debian.sif Singularity/Debian.sif> pwd /home/gmk/test Singularity/Debian.sif> exit $ singularity shell -C /tmp/Debian.sif Singularity/Debian.sif> pwd /home/gmk Singularity/Debian.sif> ls -l total 0 Singularity/Debian.sif> exit $ sudo singularity shell -w /tmp/Debian.sif $ sudo singularity shell --writable /tmp/Debian.sif $ singularity shell instance://my_instance $ singularity shell instance://my_instance Singularity: Invoking an interactive shell within container... Singularity container:~> ps -ef UID PID PPID C STIME TTY TIME CMD ubuntu 1 0 0 20:00 ? 00:00:00 /usr/local/bin/singularity/bin/appinit ubuntu 2 0 0 20:01 pts/8 00:00:00 /bin/bash --norc ubuntu 3 2 0 20:02 pts/8 00:00:00 ps -ef (SEE ALSO) singularity(1) (HISTORY) 30-Jul-2026 spf13/cobra Auto generated by spf13/cobra Jul 2026 singularity(1)