itamae 0,0,1,0,0 rspec ruby Rubygems

Configuration management tool inspired by Chef, but simpler and lightweight. Formerly known as Lightchef.

Gem Version Code Climate wercker status Slack

Simple and lightweight configuration management tool inspired by Chef.


  • Chef-like DSL (but not compatible with Chef)
  • Simpler and lighter weight than Chef
  • Only recipes
  • Idempotent


$ gem install itamae

Getting Started

Create a recipe file as recipe.rb:

package 'nginx' do
  action :install

service 'nginx' do
  action [:enable, :start]

And then excute itamae command to apply a recipe to a local machine.

$ itamae local recipe.rb
 INFO : Starting Itamae...
 INFO : Recipe: /home/user/recipe.rb
 INFO :    package[nginx]
 INFO :       action: install
 INFO :          installed will change from 'false' to 'true'
 INFO :    service[nginx]
 INFO :       action: enable
 INFO :       action: start

Or you can apply a recipe to a remote machine by itamae ssh.

$ itamae ssh --host recipe.rb

You can also apply a recipe to Vagrant VM by itamae ssh --vagrant.

$ itamae ssh --vagrant --host vm_name recipe.rb

You can find further information to use Itamae on Itamae Wiki.



Run tests

Requirements: Vagrant

$ bundle exec rake spec

Get Involved

Presentations / Articles

in Japanese


If you have a problem, please create an issue or a pull request.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Related Repositories



RSpec tests for your servers configured by CFEngine, Puppet, Chef, Ansible, Itamae or anything else even by hand ...



Configuration management tool inspired by Chef, but simpler and lightweight. Formerly known as Lightchef. ...



Encrypted Data Bag for Itamae ...



Itamae plugin to install ruby with rbenv ...



Full-stack and platform-specific packages for Itamae ...

Top Contributors

ryotarai mizzy eagletmt k0kubun nishidayuya hico-horiuchi sorah toritori0318 sue445 hfm KitaitiMakoto rrreeeyyy yuichiro-naito mmasaki takus ganmacs koshigoe muratayusuke terut hmadison glensc daichirata mirakui Joe-noh marcy-terui a2ikm mspaulding06 mozamimy Rudolph-Miller gitter-badger


-   v1.9.9 zip tar
-   v1.9.8 zip tar
-   v1.9.7.pre zip tar
-   v1.9.6 zip tar
-   v1.9.6.pre zip tar
-   v1.9.5 zip tar
-   v1.9.4 zip tar
-   v1.9.3 zip tar
-   v1.9.2 zip tar
-   v1.9.1 zip tar
-   v1.9.0 zip tar
-   v1.8.0 zip tar
-   v1.7.0 zip tar
-   v1.7.0.pre zip tar
-   v1.6.3 zip tar
-   v1.6.2 zip tar
-   v1.6.1 zip tar
-   v1.6.0 zip tar
-   v1.5.2 zip tar
-   v1.5.1 zip tar
-   v1.5.0 zip tar
-   v1.4.5 zip tar
-   v1.4.4 zip tar
-   v1.4.3 zip tar
-   v1.4.2 zip tar
-   v1.4.1 zip tar
-   v1.4.0 zip tar
-   v1.3.6 zip tar
-   v1.3.5 zip tar
-   v1.3.4 zip tar