{"id":19331102,"url":"https://github.com/systemli/ansible-role-etherpad","last_synced_at":"2025-07-16T22:32:05.069Z","repository":{"id":36303023,"uuid":"40607624","full_name":"systemli/ansible-role-etherpad","owner":"systemli","description":"Ansible role to install \u0026 maintain Etherpad Lite","archived":false,"fork":false,"pushed_at":"2025-07-12T15:43:42.000Z","size":260,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-07-12T17:48:06.494Z","etag":null,"topics":["ansible","ansible-role","etherpad"],"latest_commit_sha":null,"homepage":null,"language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/systemli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2015-08-12T15:13:31.000Z","updated_at":"2025-07-12T15:42:36.000Z","dependencies_parsed_at":"2024-05-18T18:31:01.605Z","dependency_job_id":"e04a9ebd-1fa9-47c1-8230-16fba67be6e4","html_url":"https://github.com/systemli/ansible-role-etherpad","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/systemli/ansible-role-etherpad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemli%2Fansible-role-etherpad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemli%2Fansible-role-etherpad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemli%2Fansible-role-etherpad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemli%2Fansible-role-etherpad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/systemli","download_url":"https://codeload.github.com/systemli/ansible-role-etherpad/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemli%2Fansible-role-etherpad/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265545914,"owners_count":23785879,"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","ansible-role","etherpad"],"created_at":"2024-11-10T02:39:01.753Z","updated_at":"2025-07-16T22:32:05.055Z","avatar_url":"https://github.com/systemli.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ansible-role-etherpad\n\n[![Build Status](https://github.com/systemli/ansible-role-etherpad/workflows/Integration/badge.svg?branch=main)](https://github.com/systemli/ansible-role-etherpad/actions?query=workflow%3AIntegration)\n[![Ansible Galaxy](http://img.shields.io/badge/ansible--galaxy-etherpad-blue.svg)](https://galaxy.ansible.com/systemli/etherpad/)\n\nRole to install, configure \u0026 maintain Etherpad Lite. You can use this role to configure Etherpad with those storage solutions : MySQL (or MariaDB), Redis and PostgreSQL.\n\nCurrently only MySQL allows to create the user and database. For PostgreSQL those operations should be done by your own (If you want or need to automate those tasks, you can probably use this role : geerlingguy.postgresql).\n\nThis playbook also allows to install some plugins for Etherpad :\n\n- ep_delete_after_delay (To delete some inactive pad after a delay)\n- ep_headerauth (To authenticate users through the HTTP header - Eg usefull when using an SSO portal like LemonLDAP::NG)\n\n## Role Variables\n\nThe playbook requires special configuration. You must set the `etherpad_api_key`!\n\n    etherpad_db_type: dirty\nThis variable allows to define what kind of backend storage we want to use for Etherpad (default is [dirty](https://github.com/felixge/node-dirty), please don't use this value in production environment). This variable must be set to one of those values : dirty, mysql, redis or postgres.\n\n    etherpad_postgres_database_host: localhost\n    etherpad_postgres_database_name: etherpad\n    etherpad_postgres_database_user: etherpad\n    etherpad_postgres_database_password:\n    etherpad_postgres_database_port: 5432\n    etherpad_postgres_database_ssl_policy: \"disabled\"\nThose variables allow to configure Etherpad with PostgreSQL. To be able to use them, you must set the variable `etherpad_db_type` to `postgres`.\n\n    etherpad_headerauth_username_header: x-authenticated-user\n    etherpad_headerauth_displayname_header: x-authenticated-name\nConfiguration values for the [ep_headerauth](https://www.npmjs.com/package/ep_headerauth) plugin (authentication with http header). If you want to use this plugin, `etherpad_trust_proxy` and `etherpad_require_authentication` must be set to True.\n\nFor more information about available variables (and their default values) : see `defaults/main.yml`\n\n## Example Playbook\n\n    - hosts: servers\n      roles:\n         - { role: systemli.etherpad }\n\n## Testing \u0026 Development\n\n### Tests\n\nFor developing and testing the role we use Github Actions, Molecule, and Vagrant. On the local environment you can easily test the role with\n\nRun local tests with:\n\n    ```bash\n    molecule test\n    ```\n\nRequires Molecule, Vagrant and `python-vagrant` to be installed.\n\n## License\n\nGPLv3\n\n## Author Information\n\n\u003chttps://www.systemli.org\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemli%2Fansible-role-etherpad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsystemli%2Fansible-role-etherpad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemli%2Fansible-role-etherpad/lists"}