Install documentation needs improvement

[anonymous]

I installed trac behind nginx. I wanted to have it a mysite/trac

I had two major show stoppers:

The option tracd --base-path needs to be documented more prominently.

I suggest that option should actually be part of the ini file. It's somehow crazy that this option can not be configured in the ini, but has to be part of the tracd invocation.

This was really driving me nuts, trying all the url options documented for ini. It was really unexpected to me, that there is still another url option, not being documented or even mentioned there (and in fact, this is the most important one).

The other thing driving me nuts was authentication. I tried tracd, I tried nginx. Nothing would work.

There's obviously an option needed to enable http_auth but this is seriously badly documented.

I suggest to improve the install documentation by trying a fresh install of trac from a naive minded perspective:

I suggest to try to install for a standard scenario:

• run tracd behind a proxy (either apache or ngnix)
• map tracd to the url /trac (instead of making a new host address for trac)
• configure authentication as basic auth provided by the front server

I failed to do that simple setup with the install documentation provided

Regression: A simple minded admin should be able to install trac for the setup as outline above just by following the advices in the INSTALL file.

[Jun Omae]

The INSTALL file currently navigates TracInstall.

You should also read the trac/wiki/default-pages/TracInstall documentation file present in the source distribution.

Also, the TracInstall#RunningTraconaWebServer links TracNginxRecipe page. Anonymous users can improve the page.