Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms


mineos (11) Versions 2.0.1

Installs/Configures mineos

cookbook 'mineos', '= 2.0.1'
cookbook 'mineos', '= 2.0.1', :supermarket
knife supermarket install mineos
knife supermarket download mineos
Quality -%

mineos Cookbook

This cookbook installs mineos on a fresh ubuntu system. Refer to for further information.

CAUTION: If you’re upgrading from 1.0.x (mineos 0.5) to 2.x.x (mineos 0.6), please - backup your servers (e.g. create an archive via the web ui) - remove mineos 0.5 or just setup a new host machine - run mineos::default - restore your servers (e.g. use the web ui to re-create them from archives)

Known Issues

Right now (2013-10-27) MineOS 0.6 has some issues with Minecraft 1.7:

  • The web UI will always show -1 connected players.
  • The web UI does not display server logs.
  • The web UI will load very slowly.
  • The web UI will display wrong and/or missing information about the server as long as it is running.

These are general problems with MineOS and not specific to this cookbook.



  • potentially any debian-based
  • written for and tested on Ubuntu


  • chef :)


<table> <tr> <th>Key</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> <tr> <td><tt>['mineos']['group']</tt></td> <td>String</td> <td>the group to put all ['mineos']['users'] in</td> <td><tt>mineos</tt></td> </tr> <tr> <td><tt>['mineos']['basedir']</tt></td> <td>String</td> <td>base directory to checkout the mineos repo to</td> <td><tt>/srv/mineos</tt></td> </tr> <tr> <td><tt>['mineos']['version']</tt></td> <td>String</td> <td>version to checkout from the git repo; can be any commit identifier (id, branch, tag, …)</td> <td><tt>master</tt></td> </tr> <tr> <td><tt>['mineos']['profile_fix']['enable']</tt></td> <td>Boolean</td> <td>whether to overwrite the standard <tt>profile.config</tt> with a patched one to include base profiles for newly released minecraft versions</td> <td><tt>true</tt></td> </tr> <tr> <td><tt>['mineos']['profile_fix']['versions']</tt></td> <td>String[]</td> <td>versions to include in the profile fix</td> <td><tt>["1.7.2"]</tt></td> </tr> <tr> <td><tt>['mineos']['service']['enable']</tt></td> <td>Boolean</td> <td>whether to enable the webui and “start servers on boot” services</td> <td><tt>true</tt></td> </tr> <tr> <td><tt>['mineos']['config']['basedir']</tt></td> <td>String</td> <td>where to put minecraft server data</td> <td><tt>/var/games/minecraft</tt></td> </tr> <tr> <td><tt>['mineos']['config']['local']</tt></td> <td>String</td> <td>webui locale (currently, only <tt>en</tt> and <tt>nl</tt> seem to be suported)</td> <td><tt>en</tt></td> </tr> <tr> <td><tt>['mineos']['config']['logfile']</tt></td> <td>String</td> <td>where to put the mineos log</td> <td><tt>/var/log/mineos.log</tt></td> </tr> <tr> <td><tt>['mineos']['config']['host']['address']</tt></td> <td>String</td> <td>IP address for the webui to listen on</td> <td><tt></tt> (all)</td> </tr> <tr> <td><tt>['mineos']['config']['host']['port']</tt></td> <td>int</td> <td>port for the webui to listen on</td> <td><tt>8080</tt></td> </tr> <tr> <td><tt>['mineos']['config']['ssl']['enable']</tt></td> <td>Boolean</td> <td>whether to enable SSL encryption for the webui</td> <td><tt>true</tt></td> </tr> <tr> <td><tt>['mineos']['config']['ssl']['generate']</tt></td> <td>Boolean</td> <td>whether to generate a self signed SSL cert for the webui</td> <td><tt>true</tt></td> </tr> <tr> <td><tt>['mineos']['config']['ssl']['cert']</tt></td> <td>String</td> <td>where the webui SSL cert is stored; do not change if self signed cert generation is enabled</td> <td><tt>/etc/ssl/certs/mineos.crt</tt></td> </tr> <tr> <td><tt>['mineos']['config']['ssl']['key']</tt></td> <td>String</td> <td>where the webui SSL private key is stored; do not change if self signed cert generation is enabled</td> <td><tt>/etc/ssl/certs/mineos.key</tt></td> </tr> <tr> <td><tt>['mineos']['config']['ssl']['ca']</tt></td> <td>String</td> <td>where the webui SSL cert ca is stored; do not change if self signed cert generation is enabled</td> <td><tt><empty></tt></td> </tr> <tr> <td><tt>['mineos']['config']['ssl']['chain']</tt></td> <td>String</td> <td>where the webui SSL cert chain is stored; do not change if self signed cert generation is enabled</td> <td><tt><empty></tt></td> </tr> </table>


Just include mineos in your node's run_list:

  "run_list": [

Then, put all the users that should be granted full access to the webinterface into the ['mineos']['group'] group.


I am using nvie’s git branching model. To contribute you should follow these steps:

  1. Check if your proposed change is already implemented in the develop branch
  2. Fork the repository on Github
  3. Create a named feature branch (like add_component_x)
  4. Write your change
  5. Write tests for your change (if applicable)
  6. Run the tests, ensuring they all pass
  7. Submit a Pull Request against the develop branch using Github

License and Authors

Authors: ka’imi

Dependent cookbooks

logrotate >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found