Skip to content
Snippets Groups Projects
user avatar
Marvin Ankert authored
2f997bdd
History

OT-Etherpad

Configured Plugins

This container has some required plugins preconfigured.

ep_auth_session

Allows the controller to generate links that automatically set the user's session-cookie.

ep_read_session

Custom plugin to create read-only sessions.

API key

By default, etherpad looks for an APIKEY.txt in its working directory. When the file is not found, a random apikey is generated. This image requires you to set the api key either via the environment variable EP_APIKEY or by binding the /opt/etherpad-lite/APIKEY.txt file. The entrypoint.sh exits with an error when the api key is not configured.

Preconfigured Settings

This image has the following settings pre-configured in the image, these should not be changed:

REQUIRE_AUTHENTICATION=true
REQUIRE_AUTHORIZATION=true
REQUIRE_SESSION=true
EDIT_ONLY=true
INSTALL_SOFFICE=true
SOFFICE=/usr/bin/soffice

Deployment

Settings that should be configured when deploying etherpad

Variable Description
ADMIN_PASSWORD An optional admin password (no admin user will be created when this is not set)
TRUST_PROXY Should be true if etherpad is run behind a reverse proxy
EP_APIKEY Shared secret between etherpad and deployed controllers (See APIKEY)

An extensive list of possible options can be found here. Make sure the preconfigured settings are not overwritten.

PDF export

The image contains a libreoffice installation, enabling exports to DOC/PDF/ODT formats.

Consent

On this website, we use the web analytics service Matomo to analyze and review the use of our website. Through the collected statistics, we can improve our offerings and make them more appealing for you. Here, you can decide whether to allow us to process your data and set corresponding cookies for these purposes, in addition to technically necessary cookies. Further information on data protection—especially regarding "cookies" and "Matomo"—can be found in our privacy policy. You can withdraw your consent at any time.