Skip to main content

knife edit

Use the knife edit subcommand to edit objects on the Chef Infra Server. This subcommand works similar to knife cookbook edit, knife data bag edit, knife environment edit, knife node edit, and knife role edit, but with a single verb (and a single action).


This subcommand has the following syntax:

knife edit (options)



Review the list of common options available to this (and all) knife subcommands and plugins.

This subcommand has the following options:

--chef-repo-path PATH

The path to the chef-repo. This setting will override the default path to the chef-repo. Default: same value as specified by chef_repo_path in client.rb.


The number of allowed concurrent connections. Default: 10.


Show files in the local chef-repo instead of a remote location. Default: false.

--repo-mode MODE

The layout of the local chef-repo. Possible values: static, everything, or hosted_everything. Use static for just roles, environments, cookbooks, and data bags. By default, everything and hosted_everything are dynamically selected depending on the server type. Default: everything / hosted_everything.


See config.rb for more information about how to add certain knife options as settings in the config.rb file.


The following examples show how to use this knife subcommand:

Remove a user from /groups/admins.json

A user who belongs to the admins group must be removed from the group before they may be removed from an organization. To remove a user from the admins group, run the following:

EDITOR=vi knife edit /groups/admins.json

make the required changes, and then save the file.

Edit this page on GitHub

Thank you for your feedback!


Search Results