Home

Have a lot of Apache sites to manage? Hate duplicating the same content over and over again between configs? Want to ensure your Rewrites work as you expect them to? apache-config-generator is the tool you need!

Looking for RDoc Documentation?

Quick Start

• gem install apache-config-generator
• cd to where you want to store your configs
• apache-configurator new-configs
• Create a replacement httpd.conf: Include /path/to/new-configs/conf.d
• Create a new config in configs/httpd.rb:

Apache::Config.build('httpd.conf') do
  modules :expires, :headers, :rewrite, :deflate,

  server_root '/var/www'
  server_name 'my.web.server', 'my.other.name'
  document_root '/var/www/my-site'
  directory_index! 'index.html'

  enable_gzip!

  directory '/' do
    allow_from_all
  end
end

• Regenerate your configs: rake apache:create
• Restart your server

Why?

• On large or legacy installations, managing lots of config files with duplicated content becomes unwieldy. Keeping your configs DRY is just as important as keeping code DRY.
• Since there are often very few changes between staging and live server with regards to actual config, you can maintain one master set of files and only have the appropriate sections (access controls, server settings) change based on the environment in which the configs are being generated.
• It beats writing pseudo-XML.

Patches and bug reports

Feel free to fork the project and do whatever you need to do to fix a bug and send me a pull request when you’re done. Use GitHub’s bug tracker to report any problems.