.nh
.TH "apptainer" "1" "Sep 2024" "Auto generated by spf13/cobra" ""

.SH NAME
.PP
apptainer-instance-list - List all running and named Apptainer instances


.SH SYNOPSIS
.PP
\fBapptainer instance list [list options...] []\fP


.SH DESCRIPTION
.PP
The instance list command allows you to view the Apptainer container
  instances that are currently running in the background.


.SH OPTIONS
.PP
\fB-a\fP, \fB--all\fP[=false]
	display all instances (include --sharens instances)

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for list

.PP
\fB-j\fP, \fB--json\fP[=false]
	print structured json instead of list

.PP
\fB-l\fP, \fB--logs\fP[=false]
	display location of stdout and sterr log files for instances

.PP
\fB-u\fP, \fB--user\fP=""
	if running as root, list instances from ""


.SH EXAMPLE
.EX

  $ apptainer instance list
  INSTANCE NAME      PID       IMAGE
  test               11963     /home/mibauer/apptainer/sinstance/test.sif
  test2              11964     /home/mibauer/apptainer/sinstance/test.sif
  lolcow             11965     /home/mibauer/apptainer/sinstance/lolcow.sif

  $ apptainer instance list 'test*'
  INSTANCE NAME      PID       IMAGE
  test               11963     /home/mibauer/apptainer/sinstance/test.sif
  test2              11964     /home/mibauer/apptainer/sinstance/test.sif

  $ sudo apptainer instance list -u mibauer
  INSTANCE NAME      PID       IMAGE
  test               11963     /home/mibauer/apptainer/sinstance/test.sif
  test2              16219     /home/mibauer/apptainer/sinstance/test.sif

.EE


.SH SEE ALSO
.PP
\fBapptainer-instance(1)\fP


.SH HISTORY
.PP
23-Sep-2024 Auto generated by spf13/cobra