{"id":28205108,"url":"https://github.com/ome/ansible-role-omero-server","last_synced_at":"2025-06-14T12:31:32.322Z","repository":{"id":49189773,"uuid":"78220384","full_name":"ome/ansible-role-omero-server","owner":"ome","description":"Installs and configures OMERO.server","archived":false,"fork":false,"pushed_at":"2024-05-22T16:58:21.000Z","size":269,"stargazers_count":4,"open_issues_count":11,"forks_count":12,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-06-05T09:33:21.473Z","etag":null,"topics":["ansible","omero","role","server"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/ome/omero_server/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ome.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-06T16:22:29.000Z","updated_at":"2023-11-05T18:30:53.000Z","dependencies_parsed_at":"2023-12-19T00:31:13.967Z","dependency_job_id":"e607f8b5-469c-4081-9d09-6c3b4b62faae","html_url":"https://github.com/ome/ansible-role-omero-server","commit_stats":{"total_commits":283,"total_committers":12,"mean_commits":"23.583333333333332","dds":0.3533568904593639,"last_synced_commit":"9b21f1ab513f51189e392787f14e14654ac2ef63"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/ome/ansible-role-omero-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ome%2Fansible-role-omero-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ome%2Fansible-role-omero-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ome%2Fansible-role-omero-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ome%2Fansible-role-omero-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ome","download_url":"https://codeload.github.com/ome/ansible-role-omero-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ome%2Fansible-role-omero-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259770411,"owners_count":22908439,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","omero","role","server"],"created_at":"2025-05-17T08:12:40.964Z","updated_at":"2025-06-14T12:31:32.315Z","avatar_url":"https://github.com/ome.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"OMERO Server\n============\n\n[![Actions Status](https://github.com/ome/ansible-role-omero-server/workflows/Molecule/badge.svg)](https://github.com/ome/ansible-role-omero-server/actions)\n[![Ansible Role](https://img.shields.io/badge/ansible--galaxy-omero_server-blue.svg)](https://galaxy.ansible.com/ui/standalone/roles/ome/omero_server/)\n\nInstalls and configures OMERO.server.\n\n**Warning:** Only supports Python 3.\nSee [`CHANGES.md`](./CHANGES.md) for details.\n\n\nDependencies\n------------\n\nA PostgreSQL server is required.\n\n\n\nRole Variables\n--------------\n\nAll variables are optional, see `defaults/main.yml` for the full list\n\nOMERO.server version.\n- `omero_server_release`: The OMERO release, e.g. `5.6.0`.\n  The default is `present` which will install the latest server if no server is installed, but will not modify an existing server.\n  Use `latest` to automatically upgrade when a new version is released.\n\nDatabase connection parameters and initialisation.\n- `omero_server_dbhost`: Database host\n- `omero_server_dbuser`: Database user\n- `omero_server_dbname`: Database name\n- `omero_server_dbpassword`: Database password\n- `omero_server_rootpassword`: OMERO root password, default `omero`.\n  This is only used when initialising a new database.\n\nOMERO.server configuration.\n- `omero_server_config_set`: A dictionary of `config-key: value` which will be used for the initial OMERO.server configuration, default empty.\n  `value` can be a string, or an object (list, dictionary) that will be automatically converted to quoted JSON.\n  Note configuration can also be done pre/post installation using the `server/config` conf.d style directory.\n\nOMERO system user, group, permissions, and data directory.\nYou may need to change these for in-place imports.\n- `omero_server_system_user`: OMERO.server system user, default `omero-server`.\n- `omero_server_system_user_manage`: Create or update the OMERO.server system user if necessary, default `True`.\n- `omero_server_system_uid`: OMERO system user ID (default automatic)\n- `omero_server_system_umask`: OMERO system user umask, may need to be changed for in-place imports\n- `omero_server_system_managedrepo_group`: OMERO system group for the `ManagedRepository`\n- `omero_server_datadir_mode`: Permissions for OMERO data directories apart from `ManagedRepository`\n- `omero_server_datadir_managedrepo_mode`: Permissions for OMERO `ManagedRepository`\n- `omero_server_datadir`: OMERO data directory, default `/OMERO`\n- `omero_server_datadir_managedrepo`: OMERO ManagedRepository directory\n- `omero_server_selfsigned_certificates`: Generate self-signed certificates instead of using anonymous ciphers, default `True`, use this if your system does not support insecure ciphers\n\nOMERO.server systemd configuration.\n- `omero_server_systemd_setup`: Create and start the `omero-server` systemd service, default `True`\n- `omero_server_systemd_limit_nofile`: Systemd limit for number of open files (default ignore)\n- `omero_server_systemd_after`: A list of strings with additional service names to appear in systemd unit file \"After\" statements. Default empty/none.\n- `omero_server_systemd_requires`: A list of strings with additional service names to appear in systemd unit file \"Requires\" statements. Default empty/none.\n- `omero_server_systemd_environment`: Dictionary of additional environment variables.\n\nPython virtualenv\n- `omero_server_python_addons`: List of additional Python packages to be installed into virtualenv.\n  Alternatively you can install packages into `/opt/omero/server/venv3` independently from this role.\n\nBackups\n- `omero_server_database_backupdir`: Dump the OMERO database to this directory before upgrading, default empty (disabled)\n\n\nConfiguring OMERO.server\n------------------------\n\nThis role regenerates the OMERO configuration file using the configuration files and helper script in `/opt/omero/server/config`.\n`omero_server_config_set` can be used for simple configurations, for anything more complex consider creating one or more configuration files under: `/opt/omero/server/config/` with the extension `.omero`.\n\nManual configuration changes (`omero config ...`) will be lost following a restart of `omero-server` with systemd, you can disable this by setting `omero_server_always_reset_config: false`.\nManual configuration changes will never be copied during an upgrade.\n\nSee https://github.com/ome/design/issues/70 for a proposal to add support for a conf.d style directory directly into OMERO.\n\n\nExample Playbooks\n-----------------\n\n    # Install the latest release, including PostgreSQL on the same server\n    - hosts: localhost\n      roles:\n\n      - role: ome.postgresql\n        postgresql_version: \"13\"\n        postgresql_databases:\n          - name: omero\n            owner: omero\n        postgresql_users:\n          - user: omero\n            password: omero\n            databases: [omero]\n\n      - role: ome.omero_server\n\n\n    # Install or upgrade to a particular version, with an external database\n    - hosts: localhost\n      roles:\n      - ome.omero_server\n        omero_server_release: 5.6.0\n        omero_server_dbhost: postgres.example.org\n        omero_server_dbuser: db_user\n        omero_server_dbname: db_name\n        omero_server_dbpassword: db_password\n        # Version required for the psql client\n        postgresql_version: \"13\"\n\n\nAuthor Information\n------------------\n\nome-devel@lists.openmicroscopy.org.uk\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fome%2Fansible-role-omero-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fome%2Fansible-role-omero-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fome%2Fansible-role-omero-server/lists"}