System Administrator Documentation

This documentation begins with information aimed at OS-level administrators and moves on to day-to-day management of OMERO for facility managers (who may find it useful to read the Facility Managers walkthrough for an overview first).

Getting started

The OMERO server system provides storage and processing of image data which conforms to the OME Specification. It can be run on commodity hardware to provide your own storage needs, or run site-wide to provide a large-scale collaborative environment.

Although getting started with the server is relatively straightforward, it does require installing several software systems, and more advanced usage including backups and integrated logins, needs a knowledgeable system administrator.


You may find the OMERO clients overview user guide useful before working through the installation and maintenance guides provided in this section of the documentation.


The server system is composed of several components, each of which runs in a separate process but is co-ordinated centrally.

  • OMERO.blitz - the data server provides access to metadata stored in a relational database as well as the binary image data on disk.

  • OMERO.dropbox - a filesystem watcher which notifies the server of newly uploaded or modified files and runs a fully automatic import (designed as the first implementation of OMERO.fs referred to in the architecture diagram).

  • OMERO.processor - a process-launcher for running user-defined scripts.

  • OMERO.tables - provide a way to efficiently store large, tabular results.

  • OMERO.indexer - keeps a full-text search index up-to-date for searching.

If you are interested in building components for the server, modifying an existing component, or just looking for more background information, there is a section about the server within the Developer Documentation; the best starting point is the OMERO.server overview for developers.

Requirements & limitations


This section provides guidance on how to install and set up OMERO.server and OMERO.web on any of the supported UNIX and UNIX-like platforms. Following the installation links below you will find specific walkthroughs provided for several systems, with detailed step-by-step instructions. Reading through the OMERO.server installation and OMERO.web installation and maintenance pages first is recommended as this explains the entire process rather than just being a series of commands.


Starting with OMERO 5.6, OMERO.server and OMERO.web installations are assumed to be separate throughout documentation, each with its own virtualenv. and installation directory.


This section contains instructions for administering, troubleshooting, and backing-up your installation.

Optimizing Server Configuration

This section discusses the options for configuring OMERO.server for optimum performance and security.

Managing OMERO

This section contains details on how to manage users, groups and data access in OMERO. New in OMERO 5.4.0, full administrators can now create restricted administrators to allow facility managers or other trusted users to carry out tasks on behalf of all users.

Data Import and Storage

This section contains details of how OMERO.fs allows you to import and store data with OMERO 5.

Optimizing OMERO as a Data Repository

This section explains how to customize the appearance and functionality of OMERO clients to host images for groups or public viewing.