# Plone

Plone is a free and open source content management system built on top of the Zope application server written in Python. Plone can be used for all kinds of websites, including blogs, internet sites, webshops and intranets. The strengths of Plone are its flexible and adaptable workflow, very good security, extensibility, high usability and flexibility.

## Installation

Install package ploneAUR[broken link: archived in aur-mirror] from the AUR. Please be aware, that the AUR package copies the Plone Unified Installer to `/opt/plone`, which is then run by Pacman upon initial install. The Unified Installer compiles and installs Plone in `/opt/plone`. The package provides a convenient way to quickly install and get up and running with Plone, as it handles the dependencies and bundles a systemd unit file.

Note, that Plone site version upgrades are not handled by Pacman using the AUR package, because the files in `/opt/plone` are not managed by Pacman directly. Re-running the installer is not the recommended way to upgrade Plone (see below for instructions on how to upgrade a Plone site).

### Manual Installation

The official way to install Plone is by using the Unified Installer, which is also used by the ploneAUR[broken link: archived in aur-mirror] package. Doing a manual install will give you additional options.

The following prerequisites need to be installed:

- Required: base-devel
- Recommended:libxml2 libxslt libjpeg-turbo openssl sudo
- Optional: wv poppler for Word and PDF document indexing

Download the latest installer from here and follow the Plone Install Docs and some Arch Linux specific Server Preparations

For example to install Plone for production use, using a ZEO server configuration do the following as root:

    pacman -S base-devel libxml2 libxslt libjpeg-turbo openssl sudo
    pver=4.3.2 # replace this with the latest version
    wget http://launchpad.net/plone/${pver:0:3}/$pver/+download/Plone-$pver-UnifiedInstaller.tgz
    tar -xzf *UnifiedInstaller.tgz
    ./Plone-$pver-UnifiedInstaller/install.sh --target=/opt/plone zeo

The installer provides informative messages as well as saving an `install.log` to help analyse potential problems.

## Starting Plone

Manually start the service with:

    sudo -u plone_daemon /opt/plone/zeocluster/bin/plonectl start

Then try the site on `http://yoursite:8080`

Use the displayed login password, which can also be found in `/opt/Plone/zeocluster/adminPassword.txt` The start page allows you to create an initial site, by filling in the name of the new site and choosing optional add-ons.

Stop the service with:

    sudo -u plone_daemon /opt/plone/zeocluster/bin/plonectl stop

#### Automatically using Systemd

To enable the Plone service by default at start-up, run:

    systemctl enable plone

## Customizing

To change ports, or to install add-ons and themes edit the file `buildout.cfg` at `/opt/plone/zeocluster`.

Apply the new settings by running:

    cd /opt/plone/zeocluster
    sudo -u plone_buildout bin/buildout

## Upgrades

Upgrades are done in a similar way using buildout. This should be fairly straightforward, from one minor version to another. For example to upgrade to Plone 4.3.x do the following: In your `buildout.cfg`, comment out `versions.cfg` and uncomment the line pointing to dist.plone.org, so it looks like this:

    extends =
    base.cfg
    # versions.cfg
    http://dist.plone.org/release/4.3-latest/versions.cfg

Then stop Plone and re-run buildout:

    cd /opt/plone/zeocluster
    sudo -u plone_buildout bin/buildout

Restart Plone and visit the Management Interface at (http://yoursite:8080). You will likely see a message prompting you to run Plone's migration script. Click the Upgrade button next to the site and the upgrade script will run.

For more information on upgrades, especially between major versions of Plone read the Upgrade Guide

## See Also

- Plone Official Site
- Official Documentation
- Plone Wikipedia Article

Category:

- Web server

Hidden category:

- Pages with broken package links