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.
Hardware (or virtual environment) requirements¶
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
- 2 GB or more RAM per Plone site
- 40 GB or more hard disk space
All Plone versions¶
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.
If Plone can find utilities that convert various document formats to text, it will include them in the site index. To get PDFs and common office automation formats indexed, add:
- poppler-utils (PDFs)
- wv (office docs)
These may be added after initial installation.
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.
Create a directory called Plone-5 and enter it:
mkdir Plone-5 cd Plone-5
Run the steps to create a virtual python environment (virtualenv) and install zc.buildout:
virtualenv-2.7 zinstance cd zinstance bin/pip install zc.buildout
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
This will start a long download and build process ...
SyntaxError: ("'return' outside function"..." may be ignored.
After it finished you can start Plone in foreground-mode with:
You can stop it with
ctrl + c.
Start and stop this Plone-instance in production-mode like this;
bin/instance start 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.