In this secion we will mostly use Ubuntu as reference system.
The installation on other Linux distributions, MacOS or Windows is not covered here.
A note about Versions
The current codebase of SENAITE is at the moment only compatible with the latest version 4 of Plone. This version of Plone works only with Python 2.x.
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.
- Download the
Python 2.7version for your operating system
- Create a virtual environment with
conda create --name senaite
- Activate the environment with
conda activate senaite
which python can be used to check if the right Python interpreter
is active in the current shell:
which python ~/miniconda2/envs/senaite/bin/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. >>
Install the required dependencies for SENAITE:
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
The Plone Unified Installer installs Plone and its dependencies from source on most Unix-like platforms.
$ wget --no-check-certificate https://launchpad.net/plone/4.3/4.3.18/+download/Plone-4.3.18-UnifiedInstaller.tgz $ tar xzf Plone-4.3.18-UnifiedInstaller.tgz $ cd Plone-4.3.18-UnifiedInstaller
Next step is to install Plone with the provided
install.sh shell script:
./install.sh standalone --target=/home/senaite --instance=senaitelims --password=admin
We install SENAITE in the directory
/home/senaite and we have set the admin
To install SENAITE we need to modify the generated
buildout.cfg config file.
Buildout is an automation tool written in and extended with Python:
cd /home/senaite vim buildout.cfg
You can use
nano or any other text editor you feel comfortable with instead of
senaite.lims to the
eggs section of the file:
[buildout] ... eggs = ... senaite.lims zcml = ...
Also see here: https://github.com/senaite/senaite.lims#readme
buildout command of the previous step returned without errors, you
can start SENAITE from the terminal.
To start SENAITE in foreground (debug) mode, use this command:
To stop the server, you can press
CTRL+C on your keyboard.
You can also start SENAITE in the background (production) mode with the command
bin/instance start and stop it again with
This will print several logs to the terminal and notifies when the server is ready with the line:
2019-09-14 09:59:44 INFO Zope Ready to handle requests
Open a browser (Safari/Chrome/FireFox ...) and navigate to the URL http://localhost:8080
Log in with
admin:admin to proceed to the next page.
You can continue with the default settings and press the Install SENAITE LIMS button. After a few moments, SENAITE should be installed and the dashboard view appears.
Congratulations 🙌 you successfully installed SENAITE LIMS on your system!
Please continue with the next sections to learn the first steps in your new system.