On this page:
Where does the installation documentation, if any, live?
ViewVC's installation how-to documentation lives in the INSTALL file located in the root of the ViewVC source code distribution. The most recent version of this document (which may cover unreleased ViewVC versions) can be found at http://viewvc.tigris.org/source/browse/*checkout*/viewvc/trunk/INSTALL. If you are upgrading an existing ViewVC instance, you'll also want to read the upgrade documentation, found at http://viewvc.tigris.org/source/browse/*checkout*/viewvc/trunk/docs/upgrading-howto.html.
How can I expose ViewVC at the root of a virtual host on my webserver?
If you want to dedicate a virtual host on your server just to
ViewVC, such the root directory of that host maps to ViewVC's root
display, you can do so by placing the following lines inside
Alias /docroot /usr/local/viewvc/templates/docroot ScriptAlias / /usr/local/viewvc/bin/cgi/viewvc.cgi/
The trick appears to be the presence of the trailing slash
character on the
Does ViewVC support path-based authorization, such as Subversion's authz-file mechanism?
Yes, ViewVC 1.1.0 introduced this feature, and did so in a way that allows folks with Python programming skills to (relatively) easily drop in their own custom path-based authorization implementation modules.
What causes "Error: OSError: [Errno 2] No such file or directory: '/tmp/tmpGc-Ztj'"?
This is tracked in issue
#282. While we haven't figured out how to make the error
message more graceful or helpful, the basic problem seems to
generally boil down to a misconfiguration of ViewVC. Make sure
your helper applications are in the program search path
Why does SOME-FEATURE work under standalone.py, but not under Apache (or IIS or …)?
Most of the time folks run standalone.py, they do so as a regular
system user, from a shell running with any and all the
environmental customizations present in their shell startup
scripts. But most web server packages (like Apache) run as a
different, often underprivileged, user, whose environment is
stripped down to just the system-wide default state. This can
cause problems for ViewVC's various helper applications, which
might reside in a location that's included as part of your (and
How do I enable ViewVC's RSS feed capabilities?
ViewVC generates its RSS feeds from repository data mirrored in a
database as part of its MySQL integration. Follow the steps in
When I try to download a Microsoft Word 2007 (.docx) document, ViewVC tells me that it is a .zip file. How can I make files such as this open in Word?
As it turns out,
First, you'll want to make sure that ViewVC is configured to
consult a MIME types mapping file. You do this via the
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet xlsx application/vnd.openxmlformats-officedocument.spreadsheetml.template xltx application/vnd.openxmlformats-officedocument.presentationml.presentation pptx application/vnd.openxmlformats-officedocument.presentationml.slideshow ppsx application/vnd.openxmlformats-officedocument.presentationml.template potx application/vnd.openxmlformats-officedocument.wordprocessingml.document docx application/vnd.openxmlformats-officedocument.wordprocessingml.template dotx
How does ViewVC determine a versioned file's MIME content type?
A file's MIME type is determined by consulting various sources of information. Here are those sources, ordered from highest to lowest priority:
Why can I navigate only those CVS directories that have no files in them?
ViewVC can generally display CVS directories without the use of any
external tools. But unless configured to use the incomplete,
experimental rcsparse module (via the
What causes "Error: Rlog output ended early. Expected RCS file "/opt/cvs/project/file,v""?
This is another symptom of the basic problem described here.
What causes "Error: COMalformedOutput: Unable to find filename in co output stream"?
This is another symptom of the basic problem described here.
What causes "Error: error during rlog: 0x100"?
### TODO ###
Why do my directories have no files in them?
There are a few reasons why this can happen. Here are some of the most common ones:
ViewVC doesn't show files I'm looking for, and instead displays the message "NOTE: There are N files, but none match the current selection criteria". How can I fix this?
From time to time, CVS and CVSNT add support for new keywords to the RCS backend used to house repository data. If you're running a version of ViewVC or ViewCVS that hasn't yet learned to handle those new keywords, you might get the error you're seeing. The solution is to try to get versions of CVS/CVSNT and ViewVC which are better aligned, which generally means upgrading ViewVC (which is probably less disruptive than downgrading your version control system).
Why am I getting a stack trace with a "CreateProcess" error of "The system cannot find the file specified"?
The stack trace which ends with
What causes "Error: ImportError: No module named svn"?
ViewVC uses Subversion's Python bindings to interact with and pull information out of your Subversion repositories. The error you see is Python being asked to import the Subversion Python bindings and being unable to do so. This is a common situation. These bindings are not generally provided as part of the ViewVC distribution — you have to install them yourself some other way.
In general, using the search term "python" with either "svn" or "subversion" in your system's package management tool will very likely point you to the package you require. For example, on Ubuntu Linux use the following command to install the Subversion Python bindings via the system's package management tool:
$ sudo apt-get python-svn
For more information, contact the Subversion community.
Can I use ViewVC with remote Subversion repositories?
ViewVC prefers to have direct access to the repository (and in
fact, must have that for CVS repositories), but there does
exist experimental support for remote Subversion repositories.
Enabling this is a fairly simple — just use the URL of the
repository where you would use its path in the
What you should expect: