Installing OMERO from source¶
Starting from OMERO 5.5, many components have been moved to their own repositories e.g. OMERO.py, to modernize the application and allow more flexibility.
This page is currently under review.
Using the source code¶
The source code of each release of OMERO is available for download from the Source code section of the OMERO download page.
At the moment, this source code bundle does not contain the version of
Bio-Formats. To include this version information, you will need to manually
ant/gitversion.xml file included in the source code bundle
of Bio-Formats for the same release under
Using the Git source repository¶
To use the Git source repository, you will need to install Git on your system. See the Using Git section of the Contributing documentation for more information on how to install and configure Git.
The main repository for OMERO is available from https://github.com/ome/openmicroscopy. Most OME development is currently happening on GitHub, therefore it is highly suggested that you become familiar with how it works, if not create an account for yourself.
Start by cloning the official repository:
git clone https://github.com/ome/openmicroscopy.git
Since the openmicroscopy repository now makes use of submodules, you first need to initialize all the submodules:
cd openmicroscopy git submodule update --init
Alternatively, with version 1.6.5 of git and later, you can pass the
--recursive option to git clone and initialize all submodules:
git clone --recursive https://github.com/ome/openmicroscopy.git
- Using Git
Section of the contributing documentation explaining how to use Git for contributing to the source code.
To install the dependencies required to run the OMERO.server on Linux or Mac OS X, take a look at the OMERO.server installation page where you will also find links to walk-throughs for specific platforms.
Some environment variables may need to be set up before building the server:
If the system slice files cannot be found you must set
SLICEPATHto point to the
slicedirectory of the Ice installation.
Once all the dependencies and environment variables are set up, you can build the server using:
or the clients using:
python build.py release-clients
- Build System
Section of the developer documentation detailing the build system