.nh
.TH "singularity" "1" "Feb 2022" "Auto generated by spf13/cobra" ""

.SH NAME
.PP
singularity-instance-stop - Stop a named instance of a given container image


.SH SYNOPSIS
.PP
\fBsingularity instance stop [stop options...] [instance]\fP


.SH DESCRIPTION
.PP
The command singularity instance stop allows you to stop and clean up a named,
  running instance of a given container image.


.SH OPTIONS
.PP
\fB-a\fP, \fB--all\fP[=false]
	stop all user's instances

.PP
\fB-F\fP, \fB--force\fP[=false]
	force kill instance

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

.PP
\fB-s\fP, \fB--signal\fP=""
	signal sent to the instance

.PP
\fB-t\fP, \fB--timeout\fP=10
	force kill non stopped instances after X seconds

.PP
\fB-u\fP, \fB--user\fP=""
	if running as root, stop instances belonging to user


.SH EXAMPLE
.PP
.RS

.nf

  $ singularity instance start my-sql.sif mysql1
  $ singularity instance start my-sql.sif mysql2
  $ singularity instance stop mysql*
  Stopping mysql1 instance of my-sql.sif (PID=23845)
  Stopping mysql2 instance of my-sql.sif (PID=23858)

  $ singularity instance start my-sql.sif mysql1

  Force instance to shutdown
  $ singularity instance stop -f mysql1 (may corrupt data)

  Send SIGTERM to the instance
  $ singularity instance stop -s SIGTERM mysql1
  $ singularity instance stop -s TERM mysql1
  $ singularity instance stop -s 15 mysql1

.fi
.RE


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


.SH HISTORY
.PP
20-Feb-2022 Auto generated by spf13/cobra