The hrm.conf file is used by both the webserver and the queue-manager (back-end).

Copy the sample file#

The sample configuration file $HRM_SAMPLES/etc/hrm.conf.sample must be copied to /etc/hrm.conf and then edited as explained in the following sections.

sudo cp $HRM_SAMPLES/etc/hrm.conf.sample /etc/hrm.conf

Edit the configuration file#

This is the content of the sample configuration file:

# HRM configuration file
# This file is part of the Huygens Remote Manager
# Copyright and license notice: see license.txt

# HRM install directory

# HRM image share

# Source and destination folder names

# User to run the HRM daemon with rights to
# execute /bin/mkdir, /bin/chown, /bin/chmod and
# /bin/rm on HRM_DATA (see above) for user management.

# HRM log directory

# Interaction with OMERO (if switched on in hrm/config).

# Set a custom PHP CLI binary if necessary:
# PHP_CLI="/usr/local/php/bin/php"


  • HRM_HOME points to $WWW_ROOT/hrm (for example: /var/www/html/hrm).

  • HRM_DATA points to the data folder that contains all user subfolders (for example: /data/hrm_data).

  • HRM_SOURCE and HRM_DEST are the source and destination subfolders inside the user directory (for example: src and dst). The source folder for an hypothetical user ‘john’ would then be /data/hrm_data/john/src.

  • SUSER is the Unix user that runs the Queue Manager (for example: hrm).

  • HRM_LOG is the log folder for the HRM (for example: /var/log/hrm)

  • (optional) OMERO_HOSTNAME and OMERO_PORT: see OMERO connector for details.

  • (optional) PHP_CLI is the path tho the php CLI executable if it is not in the path or another one should be used (for example: /usr/local/php/bin/php).