Page Contents


Feature List

Previous topic

OMERO.web framework

Next topic

Creating an app

This Page


This documentation is for the new OMERO 5.3 version. See the latest OMERO 5.2.x version or the previous versions page to find documentation for the OMERO version you are using if you have not upgraded yet.

OMERO.web deployment for developers

Getting set up

You will need to have an OMERO server running that you can connect to. This will typically be on your own machine, although you can also connect to an external OMERO server. You can add the server to the omero.web.server_list and choose that server when you log in. You should enable omero.web.debug and start a lightweight development Web server on your local machine.


Since OMERO 5.2, the OMERO.web framework no longer bundles a copy of the Django package, instead manual installation of the Django dependency is required. It is highly recommended to use Django 1.8 (LTS) which requires Python 2.7. For more information see Python on the Version requirements page.

Using the lightweight development server

All that is required to use the Django lightweight development server is to set the omero.web.application_server configuration option, turn omero.web.debug on and start the server up:

$ bin/omero config set omero.web.application_server development
$ bin/omero config set omero.web.debug True
$ bin/omero web start
INFO:__main__:Application Starting...
INFO:root:Processing custom settings for module omeroweb.settings
Validating models...

0 errors found
Django version 1.8, using settings 'omeroweb.settings'
Starting development server at
Quit the server with CONTROL-C.

Using WSGI

For convenience you may wish to run a web server under your local user account instead of using a system server for testing. Install Nginx and Gunicorn (See Setting up OMERO.web) but generate a configuration file using the following commands:

$ bin/omero config set omero.web.application_server 'wsgi-tcp'
$ bin/omero web config nginx-development > nginx-development.conf

Start Nginx and the Gunicorn worker processes running one thread listening on that will autoreload on source change:

$ nginx -c $PWD/nginx-development.conf
$ bin/omero config set omero.web.application_server.max_requests 1
$ bin/omero config set omero.web.wsgi_args -- "--reload"
$ bin/omero web start

Next: Get started by Creating an app....