Setup SENAITE with the unified installer

This guide describes the steps how to install SENAITE LIMS on a Debian based Linux system.

Install dependencies

sudo apt install build-essential
sudo apt install python2.7 python2.7-dev
sudo apt install libxml2 libxml2-dev libxslt1.1 libxslt1-dev
sudo apt install libffi-dev libcairo2 libpango-1.0-0 libgdk-pixbuf2.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0

Download the Plone unified installer

wget --no-check-certificate
tar xzf Plone-4.3.18-UnifiedInstaller.tgz
cd Plone-4.3.18-UnifiedInstaller

Install Plone

./ standalone --target=/home/senaite --instance=senaitelims --password=admin


To install SENAITE we need to modify the generated buildout.cfg config file:

cd /home/senaite
vim buildout.cfg

Add senaite.lims to the eggs section of the file:

eggs =
zcml =

Re-run the buildout script:


Also see here:

Setup SENAITE for development

This guide describes the steps how to prepare your system for SENAITE development.

SENAITE Dependencies

SENAITE depends on the following systems:


Most UNIX based operating system (Linux/Mac OSX) ship already with a Python interpreter installed. However, it is not recommended to use the system interpreter to setup and install SENAITE on the local system.

Besides the required super-user permissions for installing additional Python libraries is that it might get upgraded by the system and get incompatible.

Therefore, it is better to setup a virtual Python environment with one of the following tools:

In this manual we will use Miniconda.


Please use your terminal to run the commands listed below.

  1. Download the Python 2.7 version for your operating system
  2. Create a virtual environment with conda create --name senaite
  3. Activate the environment with conda activate senaite

The command which python can be used to check if the right Python interpreter is active in the current shell:

$ which python
$ python
Python 2.7.16 |Anaconda, Inc.| (default, May  1 2018, 18:37:05)
[GCC 4.2.1 Compatible Clang 4.0.1 (tags/RELEASE_401/final)] on darwin
Type "help", "copyright", "credits" or "license" for more information.