github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/node/config.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: node config'
     4  description: |
     5    The node config command is used to view or modify client configuration.
     6  ---
     7  
     8  # Command: node config
     9  
    10  The `node config` command is used to view or modify client configuration
    11  details. This command only works on client nodes, and can be used to update
    12  the running client configurations it supports.
    13  
    14  ## Usage
    15  
    16  ```plaintext
    17  nomad node config [options]
    18  ```
    19  
    20  The arguments behave differently depending on the flags given. See each flag's
    21  description below for specific usage information and requirements.
    22  
    23  ## General Options
    24  
    25  @include 'general_options_no_namespace.mdx'
    26  
    27  ## Node Config Options
    28  
    29  - `-servers`: List the client's known servers. Client nodes do not participate
    30    in the gossip pool, and instead register with these servers periodically over
    31    the network. The initial value of this list may come from configuration files
    32    using the [`servers`] configuration option in the client block.
    33  
    34    If ACLs are enabled, this option requires a token with the 'agent:read'
    35    capability.
    36  
    37  - `-update-servers`: Updates the client's server list using the provided
    38    arguments. Multiple server addresses may be passed using multiple arguments.
    39    When updating the servers list, you must specify ALL of the server nodes you
    40    wish to configure. The set is updated atomically. It is an error to specify
    41    this flag without any server addresses. If you do _not_ specify a port for each
    42    server address, the default port `4647` will be used.
    43  
    44    If ACLs are enabled, this option requires a token with the 'agent:write'
    45    capability.
    46  
    47  ## Examples
    48  
    49  Query the currently known servers:
    50  
    51  ```shell-session
    52  $ nomad node config -servers
    53  server1:4647
    54  server2:4647
    55  ```
    56  
    57  Update the list of servers:
    58  
    59  ```shell-session
    60  $ nomad node config -update-servers server1:4647 server2:4647 server3:4647 server4
    61  
    62  ```
    63  
    64  [`servers`]: /docs/configuration/client#servers