How do I shut down an ssh connected linux agent?

Article ID:204576404
1 minute readKnowledge base


How do I shutdown/restart agent process gracefully on a linux box?


  • CloudBees Jenkins Enterprise

  • Linux Agents


Sometimes you want to terminate the agent process on a linux ssh-connected node.

Whilst you can log on to the node, identify the java process and terminate it with kill, there is a much easier way via the Jenkins UI on the controller.

  1. Navigate to "{JENKINS_URL}/computer"

  2. Select the node you wish to shutdown.

  3. Select "Disconnect" from the menu on the left. This will terminate the process.


If you wish to gracefully shutdown, then select "Mark this node temporarily offline", wait for the running builds to finish and then select "Disconnect".