Public | Automated Build

Last pushed: a month ago
Short Description
Short description is empty for this repo.
Full Description

Zope ready to run Docker image

Docker image for Plone with plone.recipe.zope2instance full support
(supports all plone.recipe.zope2instance options as docker environment variables).

This image is generic, thus you can obviously re-use it within
your non-related EEA projects.


For security reasons, latest builds of this image run Zope on port 8080 instead
of 80. Please update your deployment accordingly.

Supported tags and respective Dockerfile links


Base docker image

Source code


Most of the configuration of this image is based on the
recipe package so it is advised that you check it out.

Run with basic configuration

$ docker run eeacms/zope

The image is built using a bare base.cfg file:

recipe = plone.recipe.zope2instance
user = admin:admin
http-address = 8080
effective-user = zope-www
eggs =

zope will therefore run inside the container with the default parameters given
by the recipe, with some little customization, such as effective-user.

Extend configuration through environment variables

Environment variables can be supplied either via an env_file with the --env-file flag

$ docker run --env-file zope.env eeacms/zope

or via the --env flag

$ docker run --env BUILDOUT_HTTP_ADDRESS="8081" eeacms/zope

It is very important to know that the environment variables supplied are translated
into zc.buildout configuration. For each variable with the prefix BUILDOUT_ there will be
a line added to the [instance] configuration. For example, if you want to set the
read-only attribute to the value true, you have to supply an environment variable
in the form BUILDOUT_READ_ONLY="true". When the environment variable is processed,
the prefix is striped, _ turns to - and uppercase turns to lowercase. Also, if the
value is enclosed in quotes or apostrophes, they will be striped. The configuration will
look like

read-only = true

The variables supported are the ones supported by the recipe,
so check out its documentation for a full list. Keep in mind that this option will trigger
a rebuild when the docker container is created and might cause a few seconds of delay.

Use a custom configuration file mounted as a volume

$ docker run -v /path/to/your/configuration/file:/opt/zope/buildout.cfg eeacms/zope:latest

You are able to start a container with your custom buildout configuration with the mention
that it must be mounted at /opt/zope/buildout.cfg inside the container. Keep in mind
that this option will trigger a rebuild at container creation and might cause delay, based on your
configuration. It is unadvised to use this option to install many packages, because they will
have to be reinstalled every time a container is created. To speed up deployment,
you may want to build your custom image. See the next section for examples
on how to accomplish this task.

Extend the image with custom buildout configuration files

For this you have the possibility to override:

  • versions.cfg - provide your custom Zope and Add-ons versions
  • sources.cfg - provide un-released Zope Add-ons
  • base.cfg - customize everything

Bellow is an example of base.cfg and Dockerfile to build a custom version
of Zope with your custom versions of packages based on this image:


extends = zope.cfg

eggs += eea.converter


FROM eeacms/zope
COPY base.cfg /opt/zope/base.cfg

USER root
RUN ./
USER zope-www

and then run

$ docker build -t zope:custom .

In the same way you can provide custom sources.cfg and versions.cfg or all of
them together.

If your egg has system dependencies, you should define these dependencies
within a file called requires.yum inside the egg. For example, eea.converter
requires wkhtmltopdf and ImageMagick, for this:

$ tree /opt/zope/eggs/eea.converter
|_ EGG-INFO/requires.yum
|_ ...

$ cat /opt/zope/eggs/eea.converter/EGG-INFO/requires.yum

In this way, this image will know to install these dependencies before starting

ZEO client

Bellow is an example of docker-compose.yml file for zope used as a ZEO client:

  image: eeacms/zope
  - "8080:8080"
  - zeoserver
  - BUILDOUT_ZEO_ADDRESS=zeoserver:8100

  image: eeacms/zeoserver

RelStorage client

Bellow is an example of docker-compose.yml file for zope used as a RelStorage + PostgreSQL client

  image: eeacms/zope
  - "8080:8080"
  - postgres
  - BUILDOUT_REL-STORAGE=type postgresql \n host postgres \n dbname datafs \n user zope \n password zope
  - BUIDLOUT_EGGS=RelStorage psycopg2

  image: eeacms/postgres
  - POSTGRES_USER=postgres

Developing Zope Add-ons

Add the following code within docker-compose.yml to develop eea.converter add-on:

  image: eeacms/zope
  - "8080:8080"
  - DEBUG=on
  - BUILDOUT_EGGS=eea.converter
  - ./src:/opt/zope/src


$ mkdir -p src
$ docker-compose up -d

This will git pull eea.converter source code within src directory located on host
relatively to docker-compose.yml file, re-run buildout within container
to include your add-on (in this case eea.converter) and start Zope instance.

Now you can start developing your add-on within src/eea.converter using your favorite editor/ide.

To reload add-on changes just restart Zope container using docker stop/start/restart commands:

$ docker-compose stop
$ docker-compose start
$ docker-compose logs


$ docker-compose restart
$ docker-compose logs

If you need to re-run buildout before Zope start, then use the docker-compose up command:

$ docker-compose up -d
$ docker-compose logs

Debug mode

In order to start zope in debug mode (fg) you can do:

$ docker run -p 8080:8080 eeacms/zope fg

or you can set DEBUG=on environment variable

$ docker run -e DEBUG=on -p 8080:8080 eeacms/zope

Persistent data as you wish

For production use, in order to avoid data loss we advise you to keep your Data.fs and blobs within
a data-only container.
The data container keeps the persistent data for a production environment and must be backed up.
If you are running in a devel environment, you can skip the backup and delete the container if you want.

If you have a Data.fs file for your application, you can add it to the data container with the following

$ docker run --rm \
  --volumes-from my_data_container \
  --volume /host/path/to/Data.fs:/restore/Data.fs:ro \
  busybox \
    sh -c "cp /restore/Data.fs /opt/zope/var/filestorage && \
    chown -R 500:500 /opt/zope/var/filestorage"

The command above creates a bare busybox container using the persistent volumes of your data container.
The parent directory of the Data.fs file is mounted as a read-only volume in /restore, from where the
Data.fs file is copied to the filestorage directory you are going to use (default /opt/zope/var/filestorage).
The data container must have this directory marked as a volume, so it can be used by the zope container,
with a command like:

$ docker run --volumes-from my_data_container eeacms/zope

The volumes from the data container will overwrite the contents of the directories inside the zope
container, in a similar way in which the mount command works. So, for example, if your data container
has /opt/zope/var/filestorage marked as a volume, running the above command will overwrite the
contents of that folder in the zope with whatever there is in the data container.

The data container can also be easily copied, moved and be reused between different environments.

Docker-compose example

A docker-compose.yml file for zope using a data container:

  image: eeacms/zope
  - data

  image: busybox
  - /opt/zope/var/filestorage
  - /opt/zope/var/blobstorage
  command: chown -R 500:500 /opt/zope/var


$ docker pull eeacms/zope

Supported environment variables

As mentioned above, the supported environment variables are derived from the configuration options
from the recipe. For example, read-only
becomes BUILDOUT_READ_ONLY and http-address becomes BUILDOUT_HTTP_ADDRESS.

For variables that support a list of values (such as eggs, for example), separate them by space, as
in BUILDOUT_EGGS=" eea.googlecharts".

For complex variables (such as event-log-custom, for example), specify new lines with \n, as
in BUILDOUT_EVENT_LOG_CUSTOM="<graylog> \n server \n rabbit True \n </graylog>"

Besides the variables supported by the zope2instance recipe, you can also use the following variables
to extend the [buildout] tag:


Also, to provide [sources] entries, use SOURCE_ prefix, like:


This will result in:

eea.converter = git

To start Zope in debug mode (fg) use DEBUG=on environment variable like:

$ docker run -e DEBUG=on eeacms/zope

Copyright and license

The Initial Owner of the Original Code is European Environment Agency (EEA).
All Rights Reserved.

The Original Code is free software;
you can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later


European Environment Agency (EU)

Docker Pull Command
Source Repository