1---
2layout: "docs"
3page_title: "Commands: deployment pause"
4sidebar_current: "docs-commands-deployment-pause"
5description: >
6  The deployment pause command is used to pause a deployment and disallow new
7  placements.
8---
9
10# Command: deployment pause
11
12The `deployment pause` command is used to pause a deployment. Pausing a
13deployment will pause the placement of new allocations as part of rolling
14deployment.
15
16## Usage
17
18```plaintext
19nomad deployment pause [options] <deployment id>
20```
21
22The `deployment pause` command requires a single argument, a deployment ID or
23prefix.
24
25## General Options
26
27<%= partial "docs/commands/_general_options" %>
28
29## Pause Options
30
31- `-verbose`: Show full information.
32
33## Examples
34
35Manually pause a deployment:
36
37```shell
38$ nomad deployment pause 2f14ba55
39Deployment "2f14ba55-acfb-cb31-821c-facf1b9b0830" paused
40```
41