Skip to content

Latest commit

 

History

History
71 lines (46 loc) · 2.05 KB

INSTALL-virtualenv.rst

File metadata and controls

71 lines (46 loc) · 2.05 KB
Raw

Installing Zope with virtualenv

bash

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 Zope 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.0b1 in the example below:

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

Creating a Zope instance

Attention

The following steps describe how to install a WSGI based Zope instance. If you want/have to use ZServer instead of WSGI (Python 2 only!) follow the documentation Creating a Zope instance for Zope 2.13, as it has not changed since that version.

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.