docker-cli/docs/reference/commandline/node_promote.md

# node promote

<!---MARKER_GEN_START-->
Promote one or more nodes to manager in the swarm


<!---MARKER_GEN_END-->

## Description

Promotes a node to manager. This command can only be executed on a manager node.

> [!NOTE]
> This is a cluster management command, and must be executed on a swarm
> manager node. To learn about managers and workers, refer to the
> [Swarm mode section](https://docs.docker.com/engine/swarm/) in the
> documentation.

## Examples

```console
$ docker node promote <node name>
```

## Related commands

* [node demote](node_demote.md)
* [node inspect](node_inspect.md)
* [node ls](node_ls.md)
* [node ps](node_ps.md)
* [node rm](node_rm.md)
* [node update](node_update.md)
CLI docs Signed-off-by: Amit Shukla <amit.shukla@docker.com> Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> 2016-06-13 19:57:19 -07:00			`# node promote`

docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 19:04:05 +01:00			`<!---MARKER_GEN_START-->`
update command description in CLI Signed-off-by: allencloud <allen.sun@daocloud.io> 2016-07-30 01:41:52 +08:00			`Promote one or more nodes to manager in the swarm`
Updates on cli reference documentation - Update ps with `--last` flag - Update commands with current output - Make sure hugo does not detect the wrong language - Update usage for `tag` command to be more coherent with the other ones Signed-off-by: Vincent Demeester <vincent@sbr.pm> 2016-07-07 20:43:18 +02:00
docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 19:04:05 +01:00
			`<!---MARKER_GEN_END-->`
CLI docs Signed-off-by: Amit Shukla <amit.shukla@docker.com> Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> 2016-06-13 19:57:19 -07:00
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00			`## Description`
CLI docs Signed-off-by: Amit Shukla <amit.shukla@docker.com> Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> 2016-06-13 19:57:19 -07:00
docs: clarify that node promote/demote must be executed from a manager Fixed wording per https://github.com/docker/docker.github.io/issues/7281 Signed-off-by: Anne Henmi <anne.henmi@docker.com> Update node_promote.md 2018-12-16 20:57:44 -07:00			`Promotes a node to manager. This command can only be executed on a manager node.`
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00
docs: use gh alert syntax for callouts Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> 2024-08-16 11:02:10 +02:00			`> [!NOTE]`
reference docs: reformat notes Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2020-04-19 17:08:37 +02:00			`> This is a cluster management command, and must be executed on a swarm`
			`> manager node. To learn about managers and workers, refer to the`
			`> [Swarm mode section](https://docs.docker.com/engine/swarm/) in the`
			`> documentation.`
Docs: add note about management commands targeting a manager Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2018-12-23 12:27:52 +01:00
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00			`## Examples`
CLI docs Signed-off-by: Amit Shukla <amit.shukla@docker.com> Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> 2016-06-13 19:57:19 -07:00
docs: use "console" code-hint for shell examples This replaces the use of bash where suitable, to allow easier copy/pasting of shell examples without copying the prompt or process output. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2021-08-21 14:54:14 +02:00			```console
CLI docs Signed-off-by: Amit Shukla <amit.shukla@docker.com> Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> 2016-06-13 19:57:19 -07:00			`$ docker node promote <node name>`
			```

Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00			`## Related commands`
CLI docs Signed-off-by: Amit Shukla <amit.shukla@docker.com> Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> 2016-06-13 19:57:19 -07:00
			`* [node demote](node_demote.md)`
Add the whole related information for node Signed-off-by: yuexiao-wang <wang.yuexiao@zte.com.cn> 2016-12-13 22:15:08 +08:00			`* [node inspect](node_inspect.md)`
			`* [node ls](node_ls.md)`
			`* [node ps](node_ps.md)`
			`* [node rm](node_rm.md)`
			`* [node update](node_update.md)`