Installing Zope with virtualenv

This document describes how to install Zope into a virtualenv.

Create a Virtual Environment

$ virtualenv --python=python2.7 zope
New python executable in zope/bin/python2.7
Installing setuptools, pip, wheel...done.
$ cd zope

Install the Zope2 Software Packages

Look for the release you want to install on https://github.com/zopefoundation/Zope/releases. Than use the specific version in the URL, replacing 4.0a5 in the example below:

$ bin/pip install \
-r https://raw.githubusercontent.com/zopefoundation/Zope/4.0a5/requirements-full.txt
Obtaining Zope2
...
Successfully installed ...

Creating a Zope instance

Once you’ve installed Zope, you will need to create an “instance home”. This is a directory that contains configuration and data for a Zope server process. The instance home is created using the mkwsgiinstance script:

$ bin/mkwsgiinstance -d .

You will be asked to provide a user name and password for an administrator’s account during mkwsgiinstance. To see the available command-line options, run the script with the --help option:

$ bin/mkwsgiinstance --help

The -d . specifies the directory to create the instance home in. If you follow the example and choose the current directory, you’ll find the instances files in the subdirectories of the virtualenv:

  • etc/ will hold the configuration files.
  • var/ will hold the database files.