I have installed Mac OSX Mavericks Server and I would like to add some features to the Apache Server (gitolite, redmine, etc.) I've started with updating the httpd_server_app.conf file in /Library/Server/Web/Config/apache2 but unfortunately it has been overwritten by the server to its default. Maybe because I've updated something in the UI, or an update occurred... Anyway, I would like to know how can I update the configuration file in a permanent and persistent way, and still benefit the OSX Server UI and/or updates...

I've probably missed the big : "Put your own things here:" label...

PS: By the way, I wish to modify some of the current configuration, not only adding things...

4 Answers 4


In the Mavericks Server, setup a new site. Mavericks will set this up as virtualhost under /Library/Server/Web/Config/apache2/sites. The conf file is named by IP, port, and host. You can edit this file and it will not be overwritten... to an extent. I've added directory permissions, wsgiAlias paths, daemon processes, and necessary tools for basic django install.

A caveat being that I've not tried to update the host name, port, or IP, from Server app, after editing the conf. This may generate some entirely new conf from a default template - unsure.

Server app will also provide you with a small permissions battle. Future settings updates via Server app tend to override your own write permissions. Server updates from Apple may also move your existing conf files to a previous directory.

I am sure there are long term solutions for these problems. But I suck at permissions.

  • I have manually edited the files in /Library/Server/Web/Config/apache2/sites and I can attest to the fact that you will probably break permissions from editing/adding new sites via this method. If you decide to manually edit your config, be prepared to have to deal with the possibility of manually editing the files forever (until you fix the permissions at least, which I still haven't quite figured out yet).
    – Caleb Xu
    Sep 12, 2014 at 3:00
  • Looks like a Software Update came through and moved my conf hacks to apache2.previous.
    – Nathan
    Jan 12, 2015 at 17:54
  • mine were moved to apache2.sites-previous-unusable?!? ouch!
    – Paul E
    Jan 16, 2015 at 1:26

i know this is an old question, but in Yosemite (assuming the same in Mavericks and earlier) in /library/server/web/config/apache2/httpd_server_app.conf it references:

IncludeOptional /Library/Server/Web/Config/apache2/other/*.conf

I have created a custom new .conf file there /Library/Server/Web/Config/apache2/other/custom.conf with the directives I needed and can confirm that they are picked up and used.

I would think that this folder isn't touched when doing a server upgrade as well as the IncludeOptional line mentioned above. Now you don't have to touch any of the server.app conf files and worry about permissions, etc. Hope this helps someone.


The apache config stuff on my mbp is located in


that includes httpd.conf

  • 2
    Unfortunately this config file is used on not-server config. As soon as you install OSX Server the new config files are in /Library/Server/Web/Config/apache2
    – Zaphod
    Dec 22, 2013 at 15:42
  • Yes, that's what I said, I do not want to start another Apache server, as I am using the one configured with Mac OSX Server (itunes.apple.com/app/os-x-server/id714547929?mt=12) which configuration is located in /Library/Server/Web/Config/apache2
    – Zaphod
    Dec 22, 2013 at 23:13
  • Here what is said: # When Server App is installed, this file is used instead of /etc/apache2/httpd.conf # At Server.app promotion time this file is copied to # /Library/Server/Web/Config/apache2/httpd_server_app.conf and Apache's launchd.plist is # modified to use it as the main config file.
    – Zaphod
    Dec 22, 2013 at 23:15

The files for configuration now live in /Library/Server/Web/Config/apache2 The /etc/apache2/ directory seems to be pretty much a dummy - during configuration only two files were touched there.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.