1---
2layout: docs
3page_title: 'Commands: deployment unblock'
4description: |
5  The deployment unblock command is used to manually unblock a deployment.
6---
7
8# Command: deployment unblock
9
10The `deployment unblock` command is used to manually mark a blocked
11multiregion deployment as successful. A blocked deployment is a multiregion
12deployment within a region that has completed within a region but is waiting
13on the other [federated regions]. The `deployment unblock` command can be used
14in cases where a failed peer region is unable to communicate its failed
15deployment status to other regions to force a deployment to complete.
16
17## Usage
18
19```plaintext
20nomad deployment unblock [options] <deployment id>
21```
22
23The `deployment unblock` command requires a single argument, a deployment ID or
24prefix.
25
26When ACLs are enabled, this command requires a token with the `submit-job`
27and `read-job` capabilities for the deployment's namespace.
28
29## General Options
30
31@include 'general_options.mdx'
32
33## Unblock Options
34
35- `-detach`: Return immediately instead of monitoring. A new evaluation ID
36  will be output, which can be used to examine the evaluation using the
37  [eval status] command.
38
39- `-verbose`: Show full information.
40
41## Examples
42
43Manually mark an ongoing deployment as unblocked. The deployment status shows
44an error on the unreachable "east" region.
45
46```shell-session
47$ nomad deployment unblock 8990cfbc
48Deployment "8990cfbc-28c0-cb28-ca31-856cf691b987" unblocked
49
50==> Monitoring evaluation "a2d97ad5"
51    Evaluation triggered by job "example"
52    Evaluation within deployment: "8990cfbc"
53    Evaluation status changed: "pending" -> "complete"
54==> Evaluation "a2d97ad5" finished with status "complete"
55
56$ nomad deployment status 8990cfbc
57ID          = 8990cfbc
58Job ID      = example
59Job Version = 2
60Status      = successful
61Description = Deployment successful
62
63Multi-region Deployment
64Region        ID        Status
65west          8990cfbc  successful
66south         085787e3  blocked
67east (error)  <none>    <none>
68
69Deployed
70Task Group  Desired  Placed  Healthy  Unhealthy
71cache       3        2       1        0
72```
73
74[eval status]: /docs/commands/eval-status
75[federated regions]: https://learn.hashicorp.com/tutorials/nomad/federation
76