OMERO.web installation and maintenance¶
OMERO.web is a Python 3 client of the OMERO platform that provides a web-based UI and JSON API. This section provides links to detailed step-by-step walkthroughs describing how to install, customize, maintain and run OMERO.web for several systems. OMERO.web is installed separately from the OMERO.server.
OMERO.web can be deployed with:
WSGI using a WSGI capable web server such as NGINX and Gunicorn
the built-in Django lightweight development server. This type of deployment should only be used for testing purpose only; see the Developers Deployment page.
If you need help configuring your firewall rules, see Security for more details.
Depending upon which platform you are using, you may find a more specific walkthrough listed below. The guides use the example of deploying OMERO.web with NGINX and Gunicorn. OMERO can automatically generate a configuration file for your webserver. The location of the file will depend on your system, please refer to your webserver’s manual. See in the section Customizing your OMERO.web installation in the various walkthroughs for more options.
Configuration¶
You will find in the various guides how to create the NGINX OMERO configuration file and the configuration steps for the NGINX and Gunicorn. Advanced Gunicorn setups are also described to enable the download of binary data and to handle multiple clients on a single worker thread switching context as necessary while streaming binary data from OMERO.server. Depending on the traffic and scale of the repository you should configure connections and speed limits on your server to avoid blocking resources.
To set the various OMERO.web properties, check the OMERO.web configuration glossary.
Upgrading¶
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.
Optimizing OMERO as a Data Repository¶
This section explains how to customize the appearance and functionality of OMERO.web to host images for groups or public viewing.
Installation Walkthroughs¶
Recommended:
- OMERO.web installation on CentOS 7 and IcePy 3.6
Instructions for installing OMERO.web from scratch on CentOS 7 with Ice 3.6.
- OMERO.web installation on Ubuntu 20.04 and IcePy 3.6
Instructions for installing OMERO.web from scratch on Ubuntu 20.04 with Ice 3.6.
- OMERO.web installation on Debian 10 and IcePy 3.6
Instructions for installing OMERO.web from scratch on Debian 10 with Ice 3.6.
Others:
- OMERO.web installation on CentOS 8 and IcePy 3.6
Instructions for installing OMERO.web from scratch on CentOS 8 with Ice 3.6.
- OMERO.web installation on Ubuntu 18.04 and IcePy 3.6
Instructions for installing OMERO.web from scratch on Ubuntu 18.04 with Ice 3.6.
- OMERO.web installation on Debian 9 and IcePy 3.6
Instructions for installing OMERO.web from scratch on Debian 9 with Ice 3.6.
Note
Support for Apache deployment has been dropped in 5.3.0.
If your organization’s policies only allow Apache to be used as the external-facing web-server you should configure Apache to proxy connections to an NGINX instance running on your OMERO server i.e. use Apache as a reverse proxy. For more details see Apache mod_proxy documentation.