1. chef-server(8)
2. Chef Manual
3. chef-server(8)

## NAME

`chef-server` - Start the Chef Server merb application slice.

## SYNOPSIS

chef-server (options)

`-u`, `--user USER`
  This flag is for having chef-server-webui run as a user other than the one currently logged in. Note: if you set this you must also provide a --group option for it to take effect.
`-G`, `--group GROUP`
  This flag is for having chef-server-webui run as a group other than the one currently logged in. Note: if you set this you must also provide a --user option for it to take effect.
`-d`, `--daemonize`
  This will run a single chef-server-webui in the background.
`-N`, `--no-daemonize`
  This will allow you to run a cluster in console mode.
`-c`, `--cluster-nodes NUM_MERBS`
  Number of merb daemons to run for chef-server-webui.
`-I`, `--init-file FILE`
  File to use for initialization on load, defaults to config/init.rb.
`-p`, `--port PORTNUM`
  Port to run chef-server-webui on, defaults to 4040. Additional nodes (-c) listen on incrementing port numbers.
`-o`, `--socket-file FILE`
  Socket file to run chef-server-webui on, defaults to [Merb.root]/log/merb.sock. This is for web servers, like thin, that use sockets. Specify this only if you must.
`-s`, `--socket SOCKNUM`
  Socket number to run chef-server-webui on, defaults to 0.
`-n`, `--name NAME`
  Set the name of the application. This is used in the process title and log file names.
`-P`, `--pid PIDFILE`
  PID file, defaults to [Merb.root]/log/merb.main.pid for the master process and[Merb.root]/log/merb.[port number].pid for worker processes. For clusters, use %s to specify where in the file chef-server-webui should place the port number. For instance: -P myapp.%s.pid.
`-h`, `--host HOSTNAME`
  Host to bind to (default is 0.0.0.0).
`-m`, `--merb-root PATH_TO_APP_ROOT`
  The path to the Merb.root for the app you want to run (default is current working directory).
`-a`, `--adapter ADAPTER`
  The rack adapter to use to run chef-server-webui (default is mongrel) [mongrel, emongrel, thin, ebb, fastcgi, webrick].
`-R`, `--rackup FILE`
  Load an alternate Rack config file (default is config/rack.rb).
`-i`, `--irb-console`
  This flag will start chef-server-webui in irb console mode. All your models and other classes will be available for you in an irb session.
`-S`, `--sandbox`
  This flag will enable a sandboxed irb console. If your ORM supports transactions, all edits will be rolled back on exit.
`-l`, `--log-level LEVEL`
  Log levels can be set to any of these options: debug < info < warn < error < fatal (default is info).
`-L`, `--log LOGFILE`
  A string representing the logfile to use. Defaults to [Merb.root]/log/merb.[main].log for the master process and [Merb.root]/log/merb[port number].logfor worker processes.
`-e`, `--environment STRING`
  Environment to run Merb under [development, production, testing] (default is development).
`-r`, `--script-runner ['RUBY CODE'| FULL_SCRIPT_PATH]`
  Command-line option to run scripts and/or code in the chef-server-webui app.
`-K`, `-graceful PORT or all`
  Gracefully kill chef-server-webui proceses by port number. Use chef-server -K all to gracefully kill all merbs.
`-k`, `--kill PORT`
  Force kill one merb worker by port number. This will cause the worker to be respawned.
`--fast-deploy`
  Reload the code, but not yourinit.rb or gems.
`-X`, `--mutex on/off`
  This flag is for turning the mutex lock on and off.
`-D`, `--debugger`
  Run chef-server-webui using rDebug.
`-V`, `--verbose`
  Print extra information.
`-C`, `--console-trap`
  Enter an irb console on ^C.
`-?`, `-H`, `--help`
  Show this help message.

## DESCRIPTION

The Chef Server provides a central point for the distribution of Cookbooks, management and authentication of Nodes, and the use of Search. It provides a REST API.

The API service is what clients use to interact with the server to manage node configuration in Chef. By default, the service is started on port 4000 as a Merb application slice running with the thin server adapter.

The two methods of interaction with the API for humans are the command-line tool Knife and the Management Console. The Chef Client library is used for interacting with the API for client nodes.

## SEE ALSO

chef-client(8) chef-server-webui(8) knife(1)

Full documentation for Chef and chef-server is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.

## AUTHOR

Chef was written by Adam Jacob adam@ospcode.com of Opscode (http://www.opscode.com), with contributions from the community. This manual page was written by Joshua Timberman joshua@opscode.com with help2man. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.

On Debian systems, the complete text of the Apache 2.0 License can be found in /usr/share/common-licenses/Apache-2.0.

1. Chef 10.24.0
2. February 2013
3. chef-server(8)