How to Start, Stop or Restart your Instance?

Article ID:216118748
3 minute readKnowledge base


  • How do I start Jenkins?

  • How do I stop Jenkins?

  • How do I restart Jenkins?


Administration from Jenkins

The easiest way to stop/restart a Jenkins instance is through the instance itself. In addition to the basic stop and restart commands, Jenkins provides a set of commands to safely stop/restart Jenkins by putting it in a quiet mode.

  • quietDown: Put Jenkins in a Quiet mode, in preparation for a restart. In this mode, Jenkins stops executing new builds

  • cancelQuietDown: Cancel the Quiet mode

  • safeRestart: Jenkins will try to pause jobs and restart once all running jobs are either finished or paused.

  • safeExit: Jenkins will try to pause jobs and stop once all running jobs are either finished or paused.

Pipeline builds may prevent Jenkins from stopping/restarting for a short period of time in some cases, but if so, they will be paused at the next available opportunity and then resumed after Jenkins restarts.

These commands obey the security rules defined by the Authorization Strategy set up in Jenkins. Only user(s) with the required permission can use the following commands:



Remote API

URL can be invoked by a Remote API.

Using wget:

$ wget --user=<user> --password=<password> https://<jenkins.server>/restart
$ wget --user=<user> --password=<password> https://<jenkins.server>/safeRestart
$ wget --user=<user> --password=<password> https://<jenkins.server>/exit
$ wget --user=<user> --password=<password> https://<jenkins.server>/safeExit
$ wget --user=<user> --password=<password> https://<jenkins.server>/quietDown
$ wget --user=<user> --password=<password> https://<jenkins.server>/cancelQuietDown

Using cURL:

$ curl -X POST -u <user>:<password> https://<jenkins.server>/restart
$ curl -X POST -u <user>:<password> https://<jenkins.server>/safeRestart
$ curl -X POST -u <user>:<password> https://<jenkins.server>/exit
$ curl -X POST -u <user>:<password> https://<jenkins.server>/safeExit
$ curl -X POST -u <user>:<password> https://<jenkins.server>/quietDown
$ curl -X POST -u <user>:<password> https://<jenkins.server>/cancelQuietDown

Jenkins CLI:

$ java -jar jenkins-cli.jar -s https://<jenkins-server>/ restart
$ java -jar jenkins-cli.jar -s https://<jenkins-server>/ safe-restart
$ java -jar jenkins-cli.jar -s https://<jenkins-server>/ shutdown
$ java -jar jenkins-cli.jar -s https://<jenkins-server>/ safe-shutdown
$ java -jar jenkins-cli.jar -s https://<jenkins-server>/ quiet-down
$ java -jar jenkins-cli.jar -s https://<jenkins-server>/ cancel-quiet-down

System Administration

It is obviously possible to administrate the Jenkins process itself. This is the case, for example, when a machine needs to be restarted or upgraded. It is worth mentioning that quiet-down is not available in that case. Only users with the required system permissions should be able to run the following commands.


You installed Jenkins on a Debian-based or a Fedora-based distribution, you can use the following commands:

$ sudo service jenkins restart
$ sudo service jenkins stop
$ sudo service jenkins start

Or in the latest distribution of Linux:

$ sudo systemctl start jenkins.service
$ sudo systemctl stop jenkins.service
$ sudo systemctl restart jenkins.service
Do not launch methods start/stop/restart manually as $sudo /etc/init.d/jenkins start\|stop\|restart because it makes your service unreliable as it picks up the environment from the root user as opposed to a clean reliable blank environment that is set by the init launchers (service / systemctl).


You installed Jenkins as a service on Windows, you can either use the UI component Services manager (by running services.msc) or you can use the following command:

$ C:\Program Files (x86)\Jenkins>jenkins.exe start
$ C:\Program Files (x86)\Jenkins>jenkins.exe stop
$ C:\Program Files (x86)\Jenkins>jenkins.exe restart


You deployed Jenkins on a Tomcat application server, you can start/stop the application server itself.

Tomcat as a Unix service:

$ service tomcat7 start
$ service tomcat7 stop
$ service tomcat7 restart

Tomcat as a Windows service:

$ <tomcat.home>/bin/Tomcat.exe start
$ <tomcat.home>/bin/Tomcat.exe stop

Tomcat running Mac/Linux/Unix binaries:


Tomcat running Windows binaries:

$ %CATALINA_HOME%\bin\startup.bat
$ %CATALINA_HOME%\bin\shutdown.bat

However, if several applications are deployed on your application server, it is preferable to manage the Jenkins application independently rather than restarting all applications. The following URLs shows how to start/stop/restart an application like jenkins deployed on a Tomcat server.

Tomcat 7+: