• Get Review Board
  • What's New
  • Products
  • Review Board Code review, image review, and document review
  • Documentation
  • Release Notes
  • Power Pack Enterprise integrations, reports, and enhanced document review
  • Try for 60 Days
  • Purchase
  • RBCommons Review Board as a Service, hosted by us
  • Pricing
  • RBTools Command line tools and Python API for Review Board
  • Documentation
  • Release Notes
  • Review Bot Automated code review, connecting tools you already use
  • Documentation
  • Release Notes
  • RB Gateway Manage Git and Mercurial repositories in your network
  • Documentation
  • Release Notes
  • Learn and Explore
  • What is Code Review?
  • Documentation
  • Frequently Asked Questions
  • Support Options
  • Third-Party Integrations
  • Demo
  • Review Board RBTools Power Pack Review Bot Djblets RB Gateway
    1. Review Board 1.0
    2. Version 7.x
    3. Version 6.x
    4. Version 5.0
    5. Version 4.0
    6. Version 3.0
    7. Version 2.5
    8. Version 2.0
    9. Version 1.7
    10. Version 1.6
    11. Version 1.5
    12. Version 1.0
    13. Administration Guide
    14. Site Maintenance
    15. Creating Sites
  • Home
  • General Index
  • Release Notes
  • This documentation covers Review Board 1.0. You can select a version above or view the latest documentation.

    Creating Sites¶

    Installation is handled by the rb-site install command.

    To begin, decide what the path should be to your site directory. For this example, we’ll use /var/www/reviews.example.com. Make sure first that this directory does not yet exist. rb-site will create it.

    Beginning Installation¶

    Begin installation by running the following command:

    $ rb-site install /var/www/reviews.example.com

    You will now be asked a series of questions about your site setup. It is expected that you will know the answers to these questions. If not, you’ll have to decide what software you want to use for your services and refer to their documentation on how to set them up and configure them.

    We recommend mod_python and memcached

    If you’re using Apache, we highly recommend using mod_python, as fastcgi has been known to have memory leak issues with Review Board.

    We also strongly recommend installing and using memcached. This will drastically improve performance of your Review Board installation. If possible, put this on a server with a lot of RAM.

    Once you have answered all the questions and completed the installation, you’ll need to change some directory permissions and install your web server configuration files.

    Changing Permissions¶

    Review Board expects to be able to write to the htdocs/media/uploaded directory and all subdirectories. Since Review Board is ran by your web server, this directory and all subdirectories and files must be writable by the user your web server runs as.

    This user varies by operating system, distribution and web server, so you may need to look it up. If your web server is currently running, you can look at what user it’s running as.

    Once you’ve figured this out, go ahead and change the permissions on the directories. For example, in Linux/UNIX/MacOS X with a www-data user:

    $ chown -R www-data /var/www/reviews.example.com/htdocs/media/uploaded

    If you’re using SQLite as your database, you will also need to change the ownership of the site’s db directory to match the web server’s user. Otherwise, you may receive an Internal Server Error when accessing the site.

    Web Server Configuration¶

    rb-site provides sample web server configuration files in the newly created conf/ directory under your new site directory. In many installs, these files will work out of the box, but they may require modification depending on the rest of your web server configuration.

    The configuration file will be based on the web server type and Python loader you’ve specified. For example, if you used Apache and mod_python, you would use apache-modpython.conf.

    Installing these files is also dependent on the web server and operating system/distribution.

    Apache¶

    There are two possible Apache configuration files that will be generated, depending on whether you selected mod_python or fastcgi during rb-site install.

    If you selected mod_python, your configuration file will be conf/apache-modpython.conf.

    If you selected fastcgi, your configuration file will be conf/apache-fastcgi.conf.

    Depending on your operating system or Linux distribution, the configuration file can be installed in a couple different ways.

    If you have a sites-available directory in your Apache configuration directory (for example, /etc/apache2/sites-available, then you should rename your configuration file to match your site (e.g., reviews.example.com.conf) and put it in that directory. Then create a symbolic link from that file to the sites-enabled directory. This is the most common setup on Debian or Ubuntu-based distributions. So for example:

    $ cd /etc/apache2/sites-available
    $ cp /var/www/reviews.example.com/conf/apache-modpython.conf reviews.example.com.conf
    $ cd ../sites-enabled
    $ ln -s ../sites-available/reviews.example.com.conf .

    If you do not have a sites-available or sites-enabled directory, you’ll need to embed the configuration file in your global Apache configuration file (usually /etc/httpd/httpd.conf or /etc/httpd/apache2.conf).

    Of course, the configuration file can be placed anywhere so long as it’s at some point included by your main Apache configuration file.

    Once you’ve installed the configuration file, restart Apache and then try going to your site.

    Note

    Some Apache installations (such as the default installs on Debian and Ubuntu) by default define a global virtual host that shares /var/www as the document root. This may lead to problems with your install. If you access your site and see nothing but a directory listing, then you’re affected by this problem.

    The solution is to remove the “default” site from your /etc/apache2/sites-enabled directory. This may be called something like default or 000-default.

    lighttpd¶

    The generated configuration file for lighttpd will be saved as conf/lighttpd.conf.

    You should either add the contents of this file to your /etc/lighttpd/lighttpd.conf, or include it directly from lighttpd.conf using the include directive. See the lighttpd documentation for more information.

    Keep up with the latest Review Board releases, security updates, and helpful information.

    About
    News
    Demo
    RBCommons Hosting
    Integrations
    Happy Users
    Support Options
    Documentation
    FAQ
    User Manual
    RBTools
    Administration Guide
    Power Pack
    Release Notes
    Downloads
    Review Board
    RBTools
    Djblets
    Power Pack
    Package Store
    PGP Signatures
    Contributing
    Bug Tracker
    Submit Patches
    Development Setup
    Wiki
    Follow Us
    Mailing Lists
    Reddit
    Twitter
    Mastodon
    Facebook
    YouTube

    Copyright © 2006-2025 Beanbag, Inc. All rights reserved.

    Terms of Service — Privacy Policy — AI Ethics Policy — Branding

    On this page

    • [Top]
    • Beginning Installation
    • Changing Permissions
    • Web Server Configuration
      • Apache
      • lighttpd