Files
nomad/website/content/docs/commands/operator/gossip/keyring-remove.mdx
Aimee Ukasick 23fd87d9c9 Docs: Commands section move "General options" to page bottom (#26001)
* sectionless files plus acl section

* alloc section

* config, deployment sections

* job section

* licence, namespace

* node, node-pool

* operator

* plugin, quota, recommendation

* scaling, sentinel, server, service, system, var, volume

* Add "ENT" label to left nav for enterprise commands

* job tag break into separate folder and files; update options header
2025-06-12 14:31:38 -05:00

41 lines
1.2 KiB
Plaintext

---
layout: docs
page_title: 'nomad operator gossip keyring remove command reference'
description: |
The `nomad operator gossip keyring remove` command removes the specified, non-primary gossip encryption key from the cluster.
---
# `nomad operator gossip keyring remove` command reference
The `operator gossip keyring remove` command removes the given key
from the cluster. This operation may only be performed on keys which
are not currently the primary key.
This command can only be run against server nodes. It returns 0 if all nodes
reply and there are no errors. If any node fails to reply or reports failure,
the exit code will be 1.
If ACLs are enabled, this command requires a token with the `agent:write`
capability.
## Usage
```plaintext
nomad operator gossip keyring remove [options] <key>
```
## Examples
```shell-session
$ nomad operator gossip keyring remove HD5Y61iE+neTxd1n6TnXhCPViPIUq5QpWq8WW8012XA=
Removing gossip encryption key...
error: Unexpected response code: 500 (3/3 nodes reported failure)
$ nomad operator gossip keyring remove AOUfjGff+MrTBzNU7NCOTmYajKRkGv8r2ToxheWd+jk=
Removing gossip encryption key...
```
## General options
@include 'general_options_no_namespace.mdx'