Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

chef-zero

> 编程语言
Open source

Simple, easy-run, fast-start in-memory Chef server for testing and solo purposes

531 stars0 likes1 views
WebsiteGitHub

About

Simple, easy-run, fast-start in-memory Chef server for testing and solo purposes

Chef Zero

Description

Chef Zero is a simple, easy-install, in-memory Chef server that can be useful for Chef Client testing and chef-solo-like tasks that require a full Chef Server. It IS intended to be simple, Chef 11+ compliant, easy to run and fast to start. It is NOT intended to be secure, scalable, performant or persistent. It does NO input validation, authentication or authorization (it will not throw a 400, 401 or 403). It does not save data, and will start up empty each time you start it.

Because Chef Zero runs in memory, it's super fast and lightweight. This makes it perfect for testing against a "real" Chef Server without mocking the entire Internet.

Installation

This server can be installed as a Ruby Gem.

bash
$ gem install chef-zero

If you're using bundler, add chef-zero as a development dependency:

ruby
group :development do
  gem 'chef-zero'
end

Or in a .gemspec

ruby
s.add_development_dependency 'chef-zero'

You can also clone the source repository and install it using rake install.

Usage

One of chef-zero's primary uses is as a small test server for people writing and testing clients. Here's a simple example of starting it up:

ruby
require 'chef_zero/server'
server = ChefZero::Server.new(port: 4000)
server.start

This will create a server instance in the foreground. To stop the server:

ruby
server.stop

This is great for debugging and logging requests, but you'll probably want to run this in the background so you have full control of your thread.

To run Chef Zero in the background, simply issue the start_background command:

ruby
require 'chef_zero/server'
server = ChefZero::Server.new(port: 4000)
server.start_background

You can stop the server the same way:

ruby
server.stop

Valid Options

You may currently pass the following options to the initializer:

  • host - the host to run on (Default: '127.0.0.1')
  • port - the port to run on (Default: 8889)
  • debug - run in debug mode to see all requests and responses (Default: false)

CLI (Command Line)

If you don't want to use Chef Zero as a library, you can simply start an instance with the included chef-zero executable:

bash
$ chef-zero

Note, this will run in the foreground.

You now have a fully functional (empty) Chef Server running.

To try it out, go into the chef-zero/playground directory and run knife. It will behave the same as a normal Chef Server, and all normal knife commands will work (show, list, delete, from file, upload, download, diff ...). For example, with +knife-essentials+ (or Chef 11) you can upload everything in the repo:

…

To use it in your own repository, create a knife.rb like so:

ruby
chef_server_url   'http://127.0.0.1:8889'
node_name         'stickywicket'
client_key        'path_to_any_pem_file.pem'

And use knife like you normally would.

Since Chef Zero does no authentication, any .pem file will do. The client just needs something to sign requests with (which will be ignored on the server). Even though it's ignored, the .pem must still be a valid format.

Now, stop the Chef Zero server and all the data is gone!

Run chef-zero --help to see a list of the supported flags and options:

…

Contributing

For information on contributing to this project see

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Copyright

See COPYRIGHT.md.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Ruby

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言