diff --git a/README.md b/README.md index 37630f5..7b592af 100644 --- a/README.md +++ b/README.md @@ -174,6 +174,29 @@ matching the name of the application. **Note**: Rails logger output does not appear in Pow's logs. You'll want to `tail -f log/development.log` to see those. +## Configuring Pow + +Pow is designed so that most people will never need to configure +it. Sometimes you can't avoid adjusting a setting or two, though. When +Pow boots, it executes the `.powconfig` script in your home directory +if it's present. You can use this script to set environment variables +that will override Pow's default settings. + +For example, this `~/.powconfig` file tells Pow to kill idle +applications after 5 minutes (300,000 ms) and spawn 3 workers per app: + + export POW_TIMEOUT=300000 + export POW_WORKERS=3 + +See the [Configuration class +documentation](http://pow.cx/docs/configuration.html#section-5) for a +full list of settings that you can change. + +**Note**: After modifying a setting in `~/.powconfig`, you'll need to + restart Pow for the change to take effect. You can do this by + finding the `pow` process in OS X's Activity Monitor and clicking + "Quit Process". + ## Contributing Pow is written in [Node.js](http://nodejs.org/) with