Plone Installation Requirements¶
Requirements for installing Plone. Details the tools and libraries (dependencies) required to install Plone.
To run a Plone based web site on your own server you need:
- A server machine connected to Internet (public sites) or your intranet (company intranet sites);
- Remote console, like SSH access, for installing Plone. FTP is not enough.
Plone requires several system libraries. These need to be installed by a user with root access.
Plone has been successfully installed on:
- Nearly every popular Linux distribution;
- Nearly every popular BSD distribution
- OS X (using our OS X installer or XCode)
- Solaris and several other proprietery *nix systems
To install on Windows, it is strongly recommended to use the Plone Windows Installer. Otherwise, you will need Cygwin to provide a *nix build environment.
The hardware requirements below give a rough estimation of the minimum hardware setup needed for a Plone server.
Add-on products and caching solutions may increase RAM requirements.
One Zope application server is able to run several Plone sites with the same software configuration. This lowers the requirements when hosting multiple sites on the same server.
- Minimum 256 MB RAM and 512 MB of swap space per Plone site
- Minimum 512 MB hard disk space
A complete GNU build kit including GCC including gcc, gmake, patch, tar, gunzip, bunzip2, wget.
Most required libraries listed below must be installed as development versions (dev).
Tools and libraries marked with "*" are either included with the Unified Installer or automatically downloaded.
If you use your system Python, you should use Python's virtualenv to create an isolated virtual Python. System Pythons may use site libraries that will otherwise interfere with Zope/Plone.
Python 2.7 (dev), built with support for expat (xml.parsers.expat), zlib and ssl. (Python XML support may be a separate package on some platforms.)*
- libz (dev)
- libjpeg (dev)*
- readline (dev)*
- libexpat (dev)
- libssl or openssl (dev)
- libxml2 >= 2.7.8 (dev)*
- libxslt >= 1.1.26 (dev)*
You may also need to install dependencies needed by Pillow a fork of the Python Image Libary. For further information please read: https://pillow.readthedocs.org/en/latest/installation.html
With complete requirements in place, a barebones Plone install may be created with a few steps.
~/$ is a system prompt.
~/$ mkdir Plone-5 ~/$ cd Plone-5 ~/Plone-5$ virtualenv-2.7 zinstance ~/Plone-5$ cd zinstance ~/Plone-5/zinstance$ bin/pip install zc.buildout ~/Plone-5/zinstance$ echo """ [buildout] extends = http://dist.plone.org/release/5-latest/versions.cfg parts = instance [instance] recipe = plone.recipe.zope2instance user = admin:admin http-address = 8080 eggs = Plone Pillow """ > buildout.cfg ~/Plone-5/zinstance$ bin/buildout
This will start a long download and build process ...
Errors like "SyntaxError: ("'return' outside function"..."" may be ignored.
After it finished you can start Plone in foreground-mode with:
~/Plone-5/zinstance$ bin/instance fg
You can stop it with
ctrl + c.
Start and stop this Plone-instance in production-mode like this;
~/Plone-5/zinstance$ bin/instance start ~/Plone-5/zinstance$ bin/instance stop
Plone will run on port 8080 and can be accessed via http://localhost:8080. Use login id "admin" and password "admin" for initial login so you can create a site.
This build would be adequate for a quick evaluation installation. For a production or development installation, use one of Plone's installers.