Migration commit; fresh start

This commit is contained in:
muppeth 2021-03-14 17:53:38 +01:00
parent db1882bb8d
commit 8d371ce31b
Signed by: muppeth
GPG Key ID: 0EBC7B9848D04031
17 changed files with 963 additions and 2 deletions

3
.gitignore vendored Normal file
View File

@ -0,0 +1,3 @@
.vagrant
.vagrant/*
*log

9
Playbooks/etherpad.yml Normal file
View File

@ -0,0 +1,9 @@
---
- hosts: etherpad
roles:
- mariadb
- etherpad
vars_files:
- ../defaults/main.yml

26
README.MD Normal file
View File

@ -0,0 +1,26 @@
# Etherpad - Ansible role
This role covers deployment, configuration and software updates of etheprad-lite. This role is released under MIT Licence and we give no warranty for this piece of software. Currently supported OS - Debian.
The role allows to install/uninstall etherpad's plugins.
You can deploy test instance using `Vagrantfile` attached to the role.
`vagrant up`
`ansible-playbook -b Playbooks/etherpad.yml`
Then you can access etherpad from your computer on http://192.168.33.8:9001
## CHANGELOG
- **04.03.2021** - Bumped version to 1.8.11 and adjusted readme file
- **21.11.2020** - Make it ready for public release
- Bump to 1.8.6
- Added new plugins
- Corrected few things
- **04.11.2019** - First stable production (**1.0**)
- Added update and release change via git
- Few minor changes to the config
- added skin choice in the config
- **19.12.2019** - Small fix at user.yml
- **09.02.2020** - Add Vagrantfile + Playbooks

View File

@ -1,2 +0,0 @@
# etherpad

20
Vagrantfile vendored Normal file
View File

@ -0,0 +1,20 @@
# -*- mode: ruby -*-
# vi: set ft=ruby :
# All Vagrant configuration is done below. The "2" in Vagrant.configure
# configures the configuration version (we support older styles for
# backwards compatibility). Please don't change it unless you know what
# you're doing.
Vagrant.configure("2") do |config|
#config.ssh.insert_key = false
config.vm.define "etherpad" do |etherpad|
etherpad.vm.box = "generic/debian10"
etherpad.vm.provider :libvirt do |libvirt|
libvirt.memory = 256
end
etherpad.vm.network "forwarded_port", guest: 80, host: 8884, host_ip: "192.168.33.8"
etherpad.vm.network "forwarded_port", guest: 443, host: 4444, host_ip: "192.168.33.8"
etherpad.vm.network "forwarded_port", guest: 8080, host: 8081, host_ip: "192.168.33.8"
etherpad.vm.network "private_network", ip: "192.168.33.8"
end
end

111
defaults/main.yml Normal file
View File

@ -0,0 +1,111 @@
---
etherpad_version: '1.8.12'
etherpad_skin: 'colibris'
etherpad_skinVariants: 'super-light-toolbar super-light-editor light-background'
etherpad_username: 'etherpad'
etherpad_group: 'etherpad'
etherpad_app_dir: '/var/www/etherpad-lite'
etherpad_instance_name: 'pads'
etherpad_listen_ip: '0.0.0.0'
etherpad_listen_port: '9001'
etherpad_db_type: '0' #an integer. 0 or unset for mysql, 1 for postgres
etherpad_db_user: 'etherpad'
etherpad_db_host: 'localhost'
etherpad_db_passwd: 'changeme'
etherpad_db_name: 'etherpad'
etherpad_db_port: '3306'
etherpad_welcome_text: 'Welcome to Etherpad!\n\nThis pad text is synchronized as you type, so that everyone viewing this page sees the same text. This allows you to collaborate seamlessly on documents!\n\nGet involved with Etherpad at http:\/\/etherpad.org\n'
etherpad_group_only: 'false'
etherpad_editonly: 'false'
etherpad_minify: 'true'
etherpad_showSettingsInAdminPage: 'true'
etherpad_suppressErrorsInPadText: 'false'
etherpad_allowUnknownFileEnds: 'true'
etherpad_automaticReconnectionTimeout: '0'
etherpad_indentationOnNewLine: 'false'
etherpad_importExportRateLimitingwindowMs: '90000'
etherpad_importExportRateLimitingMax: '10'
etherpad_importMaxFileSize: '52428800' # 50 MB -> 50 * 1024 * 1024
etherpad_exposeVersion: 'false'
etherpad_js_maxage: '21600'
etherpad_max_log_size: '1024'
etherpad_abiword: '/usr/bin/abiword'
etherpad_auth: 'false'
etherpad_authorization: 'false'
etherpad_proxy: 'false'
etherpad_ip_logging: 'false'
etherpad_maxHttpBufferSize: '10000'
etherpad_enableAdminUITests: 'false'
etherpad_admin_pwd: 'changeme'
etherpad_ratelimit_duration: '1'
etherpad_ratelimit_points: '100'
etherpad_loglevel: 'INFO'
etherpad_logfile: '/var/log/etherpad-lite.log'
etherpad_error_log_recipient: 'support@example.com'
etherpad_smtp_host: 'localhost'
etherpad_smtp_port: '587'
etherpad_smtp_user: 'support'
etherpad_smtp_pass: 'changeme'
etherpad_nodejs_version: '14'
etherpad_apt:
- curl
- nodejs
- git
etherpad_plugins:
- name: ep_adminpads
install: false
- name: ep_adminpads2
install: false
- name: ep_comments_page
install: true
- name: ep_desktop_notifications
install: true
- name: ep_font_color
install: true
- name: ep_headings2
install: true
- name: ep_markdown
install: true
- name: ep_previewimages
install: true
- name: ep_spellcheck
install: true
- name: ep_real_time_chat
install: true
- name: ep_delete_after_delay
install: true
- name: ep_align
install: true
- name: ep_font_size
install: true
- name: ep_table_of_contents
install: true
- name: ep_author_follow
install: true
- name: ep_cursortrace
install: true
- name: ep_prompt_for_name
install: true
- name: ep_user_fontsize_version_2
install: true
# ep_delete_after_delay
# Etherpad-Lite plugin that deletes your pads after a configured delay
delay: '7776000' # one day, in seconds Default is 86400
loopdeletion: 'true'
loopDelay: '86400' # one hour, in seconds Default is 3600
deleteAtStart: 'true'
text: "The content of this pad has been deleted since it was older than the configured delay."
# MARIADB CONFIG
mariadb_databases:
- name: '{{ etherpad_db_name }}'
collation: 'utf8mb4_unicode_ci'
encoding: 'utf8mb4'
mariadb_users:
- name: '{{ etherpad_db_user }}'
host: '{{ etherpad_db_host }}'
password: '{{ etherpad_db_passwd }}'
priv: '{{ etherpad_db_name }}.*:ALL'

6
handlers/main.yml Normal file
View File

@ -0,0 +1,6 @@
---
- name: restart etherpad
systemd:
name: etherpad
state: restarted

7
tasks/abiword.yml Normal file
View File

@ -0,0 +1,7 @@
---
- name: '[LIBRE-OFFICE] - Install Abiword'
apt:
name: abiword
state: present
update_cache: yes

19
tasks/configure.yml Normal file
View File

@ -0,0 +1,19 @@
---
- name: '[CONFIGURE] - Create log file'
file:
path: "{{ etherpad_logfile }}"
state: touch
owner: "{{ etherpad_username }}"
group: "{{ etherpad_group }}"
mode: 0755
- name: '[CONFIGURE] - Deploy config'
template:
src: var/www/etherpad-lite/settings.json.j2
dest: "{{ etherpad_app_dir }}/settings.json"
owner: "{{ etherpad_username }}"
group: "{{ etherpad_group }}"
mode: 0644
notify:
restart etherpad

10
tasks/git.yml Normal file
View File

@ -0,0 +1,10 @@
---
- name: '[GIT] - Deploy source'
git:
repo: https://github.com/ether/etherpad-lite.git
dest: "{{ etherpad_app_dir }}"
force: yes
update: yes
version: "{{ etherpad_version }}"
notify: restart etherpad

18
tasks/installdeps.yml Normal file
View File

@ -0,0 +1,18 @@
---
- name: '[INSTALLDEPS] - Add Nodesource apt key.'
apt_key:
url: https://keyserver.ubuntu.com/pks/lookup?op=get&fingerprint=on&search=0x1655A0AB68576280
id: "68576280"
state: present
- name: '[INSTALLDEPS] - Add repository for nodejs'
apt_repository:
repo: deb https://deb.nodesource.com/node_{{ etherpad_nodejs_version }}.x {{ ansible_distribution_release }} main
state: present
filename: 'nodesource'
- name: '[INSTALLDEPS] - Install dependencies'
apt:
name: "{{ etherpad_apt }}"
update_cache: yes

23
tasks/main.yml Normal file
View File

@ -0,0 +1,23 @@
---
- name: Install dependencies
include: installdeps.yml
- name: Clone / Update GIT
include: git.yml
- name: Add user
include: user.yml
- name: Deploy configuration
include: configure.yml
- name: Install Modules
include: modules.yml
- name: Use abiword
include: abiword.yml
when: etherpad_abiword != 'null'
- name: Systemd
include: systemd.yml

21
tasks/modules.yml Normal file
View File

@ -0,0 +1,21 @@
---
- name: '[Modules] - Install modules'
npm:
name: "{{ item.name }}"
path: "{{ etherpad_app_dir }}"
state: latest
with_items: "{{ etherpad_plugins }}"
when: item.install|lower == 'true'
notify:
restart etherpad
- name: '[Modules] - Uninstall modules'
npm:
name: "{{ item.name }}"
path: "{{ etherpad_app_dir }}"
state: absent
with_items: "{{ etherpad_plugins }}"
when: item.install|lower == 'false'
notify:
restart etherpad

19
tasks/systemd.yml Normal file
View File

@ -0,0 +1,19 @@
---
- name: '[SYSTEMD] - Deploy Systemd config'
template:
src: etc/systemd/system/etherpad.service.j2
dest: /etc/systemd/system/etherpad.service
owner: root
group: root
mode: 0644
register: etherpad_systemd
- name: '[SYSTEMD] - Enable systemd'
systemd:
name: etherpad
enabled: yes
state: started
daemon_reload: yes
notify:
restart etherpad

22
tasks/user.yml Normal file
View File

@ -0,0 +1,22 @@
---
- name: '[USER] - Add group'
group:
name: '{{ etherpad_group }}'
state: present
- name: '[USER] - Add user'
user:
name: '{{ etherpad_username }}'
shell: /bin/bash
group: '{{ etherpad_group }}'
home: '{{ etherpad_app_dir }}'
state: present
- name: '[USER] - Change ownership to etherpad user'
file:
path: '{{ etherpad_app_dir }}'
owner: '{{ etherpad_username }}'
group: '{{ etherpad_group }}'
state: directory
recurse: yes

View File

@ -0,0 +1,17 @@
[Unit]
Description=Etherpad Server
After=syslog.target network.target
[Service]
Type=simple
User={{ etherpad_username }}
Group={{ etherpad_group }}
WorkingDirectory={{ etherpad_app_dir }}
Environment=NODE_ENV=production
ExecStart={{ etherpad_app_dir }}/bin/run.sh
StandardOutput=file:{{ etherpad_logfile }}
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target

View File

@ -0,0 +1,632 @@
/*
* This file must be valid JSON. But comments are allowed
*
* Please edit settings.json, not settings.json.template
*
* Please note that starting from Etherpad 1.6.0 you can store DB credentials in
* a separate file (credentials.json).
*
*
* ENVIRONMENT VARIABLE SUBSTITUTION
* =================================
*
* All the configuration values can be read from environment variables using the
* syntax "${ENV_VAR}" or "${ENV_VAR:default_value}".
*
* This is useful, for example, when running in a Docker container.
*
* EXAMPLE:
* "port": "${PORT:9001}"
* "minify": "${MINIFY}"
* "skinName": "${SKIN_NAME:colibris}"
*
* Would read the configuration values for those items from the environment
* variables PORT, MINIFY and SKIN_NAME.
*
* If PORT and SKIN_NAME variables were not defined, the default values 9001 and
* "colibris" would be used.
* The configuration value "minify", on the other hand, does not have a
* designated default value. Thus, if the environment variable MINIFY were
* undefined, "minify" would be null.
*
* REMARKS:
* 1) please note that variable substitution always needs to be quoted.
*
* "port": 9001, <-- Literal values. When not using
* "minify": false substitution, only strings must be
* "skinName": "colibris" quoted. Booleans and numbers must not.
*
* "port": "${PORT:9001}" <-- CORRECT: if you want to use a variable
* "minify": "${MINIFY:true}" substitution, put quotes around its name,
* "skinName": "${SKIN_NAME}" even if the required value is a number or
* a boolean.
* Etherpad will take care of rewriting it
* to the proper type if necessary.
*
* "port": ${PORT:9001} <-- ERROR: this is not valid json. Quotes
* "minify": ${MINIFY} around variable names are missing.
* "skinName": ${SKIN_NAME}
*
* 2) Beware of undefined variables and default values: nulls and empty strings
* are different!
*
* This is particularly important for user's passwords (see the relevant
* section):
*
* "password": "${PASSW}" // if PASSW is not defined would result in password === null
* "password": "${PASSW:}" // if PASSW is not defined would result in password === ''
*
* If you want to use an empty value (null) as default value for a variable,
* simply do not set it, without putting any colons: "${ABIWORD}".
*
* 3) if you want to use newlines in the default value of a string parameter,
* use "\n" as usual.
*
* "defaultPadText" : "${DEFAULT_PAD_TEXT}Line 1\nLine 2"
*/
{
/*
* Name your instance!
*/
"title": "{{ etherpad_instance_name }}",
/*
* favicon default name
* alternatively, set up a fully specified Url to your own favicon
*/
"favicon": "favicon.ico",
/*
* Skin name.
*
* Its value has to be an existing directory under src/static/skins.
* You can write your own, or use one of the included ones:
*
* - "no-skin": an empty skin (default). This yields the unmodified,
* traditional Etherpad theme.
* - "colibris": the new experimental skin (since Etherpad 1.8), candidate to
* become the default in Etherpad 2.0
*/
"skinName": "{{ etherpad_skin }}",
/*
* Skin Variants
*
* Use the UI skin variants builder at /p/test#skinvariantsbuilder
*
* For the colibris skin only, you can choose how to render the three main
* containers:
* - toolbar (top menu with icons)
* - editor (containing the text of the pad)
* - background (area outside of editor, mostly visible when using page style)
*
* For each of the 3 containers you can choose 4 color combinations:
* super-light, light, dark, super-dark.
*
* For example, to make the toolbar dark, you will include "dark-toolbar" into
* skinVariants.
*
* You can provide multiple skin variants separated by spaces. Default
* skinVariant is "super-light-toolbar super-light-editor light-background".
*
* For the editor container, you can also make it full width by adding
* "full-width-editor" variant (by default editor is rendered as a page, with
* a max-width of 900px).
*/
"skinVariants": "{{ etherpad_skinVariants }}",
/*
* IP and port which Etherpad should bind at.
*
* Binding to a Unix socket is also supported: just use an empty string for
* the ip, and put the full path to the socket in the port parameter.
*
* EXAMPLE USING UNIX SOCKET:
* "ip": "", // <-- has to be an empty string
* "port" : "/somepath/etherpad.socket", // <-- path to a Unix socket
*/
"ip": "{{ etherpad_listen_ip }}",
"port": {{ etherpad_listen_port }},
/*
* Option to hide/show the settings.json in admin page.
*
* Default option is set to true
*/
"showSettingsInAdminPage": {{ etherpad_showSettingsInAdminPage }},
/*
* Node native SSL support
*
* This is disabled by default.
* Make sure to have the minimum and correct file access permissions set so
* that the Etherpad server can access them
*/
/*
"ssl" : {
"key" : "/path-to-your/epl-server.key",
"cert" : "/path-to-your/epl-server.crt",
"ca": ["/path-to-your/epl-intermediate-cert1.crt", "/path-to-your/epl-intermediate-cert2.crt"]
},
*/
/*
* The type of the database.
*
* You can choose between many DB drivers, for example: dirty, postgres,
* sqlite, mysql.
*
* You shouldn't use "dirty" for for anything else than testing or
* development.
*
*
* Database specific settings are dependent on dbType, and go in dbSettings.
* Remember that since Etherpad 1.6.0 you can also store these informations in
* credentials.json.
*
* For a complete list of the supported drivers, please refer to:
* https://www.npmjs.com/package/ueberdb2
"dbType": "dirty",
"dbSettings": {
"filename": "var/dirty.db"
},
*/
/*
* An Example of MySQL Configuration (commented out).
*
* See: https://github.com/ether/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-MySQL
*/
"dbType" : "mysql",
"dbSettings" : {
"user": "{{ etherpad_db_user }}",
"host": "{{ etherpad_db_host }}",
"port": {{ etherpad_db_port }},
"password": "{{ etherpad_db_passwd }}",
"database": "{{ etherpad_db_name }}",
"charset": "utf8mb4"
},
/*
* The default text of a pad
*/
"defaultPadText" : "{{ etherpad_welcome_text }}",
/*
* Default Pad behavior.
*
* Change them if you want to override.
*/
"padOptions": {
"noColors": false,
"showControls": true,
"showChat": true,
"showLineNumbers": true,
"useMonospaceFont": false,
"userName": false,
"userColor": false,
"rtl": false,
"alwaysShowChat": false,
"chatAndUsers": false,
"lang": "en-gb"
},
/*
* Pad Shortcut Keys
*/
"padShortcutEnabled" : {
"altF9": true, /* focus on the File Menu and/or editbar */
"altC": true, /* focus on the Chat window */
"cmdShift2": true, /* shows a gritter popup showing a line author */
"delete": true,
"return": true,
"esc": true, /* in mozilla versions 14-19 avoid reconnecting pad */
"cmdS": true, /* save a revision */
"tab": true, /* indent */
"cmdZ": true, /* undo/redo */
"cmdY": true, /* redo */
"cmdI": true, /* italic */
"cmdB": true, /* bold */
"cmdU": true, /* underline */
"cmd5": true, /* strike through */
"cmdShiftL": true, /* unordered list */
"cmdShiftN": true, /* ordered list */
"cmdShift1": true, /* ordered list */
"cmdShiftC": true, /* clear authorship */
"cmdH": true, /* backspace */
"ctrlHome": true, /* scroll to top of pad */
"pageUp": true,
"pageDown": true
},
/*
* Should we suppress errors from being visible in the default Pad Text?
*/
"suppressErrorsInPadText": {{ etherpad_suppressErrorsInPadText }},
/*
* If this option is enabled, a user must have a session to access pads.
* This effectively allows only group pads to be accessed.
*/
"requireSession": {{ etherpad_group_only }},
/*
* Users may edit pads but not create new ones.
*
* Pad creation is only via the API.
* This applies both to group pads and regular pads.
*/
"editOnly": {{ etherpad_editonly }},
/*
* If true, all css & js will be minified before sending to the client.
*
* This will improve the loading performance massively, but makes it difficult
* to debug the javascript/css
*/
"minify": {{ etherpad_minify }},
/*
* How long may clients use served javascript code (in seconds)?
*
* Not setting this may cause problems during deployment.
* Set to 0 to disable caching.
*/
"maxAge": {{ etherpad_js_maxage }}, // 60 * 60 * 6 = 6 hours
/*
* Absolute path to the Abiword executable.
*
* Abiword is needed to get advanced import/export features of pads. Setting
* it to null disables Abiword and will only allow plain text and HTML
* import/exports.
*/
"abiword": "{{ etherpad_abiword }}",
/*
* This is the absolute path to the soffice executable.
*
* LibreOffice can be used in lieu of Abiword to export pads.
* Setting it to null disables LibreOffice exporting.
*/
"soffice": null,
/*
* Path to the Tidy executable.
*
* Tidy is used to improve the quality of exported pads.
* Setting it to null disables Tidy.
*/
"tidyHtml": null,
/*
* Allow import of file types other than the supported ones:
* txt, doc, docx, rtf, odt, html & htm
*/
"allowUnknownFileEnds": {{ etherpad_allowUnknownFileEnds }},
/*
* This setting is used if you require authentication of all users.
*
* Note: "/admin" always requires authentication.
*/
"requireAuthentication": {{ etherpad_auth }},
/*
* Require authorization by a module, or a user with is_admin set, see below.
*/
"requireAuthorization": {{ etherpad_authorization }},
/*
* When you use NGINX or another proxy/load-balancer set this to true.
*
* This is especially necessary when the reverse proxy performs SSL
* termination, otherwise the cookies will not have the "secure" flag.
*
* The other effect will be that the logs will contain the real client's IP,
* instead of the reverse proxy's IP.
*/
"trustProxy": {{ etherpad_proxy }},
/*
* Settings controlling the session cookie issued by Etherpad.
*/
"cookie": {
/*
* Value of the SameSite cookie property. "Lax" is recommended unless
* Etherpad will be embedded in an iframe from another site, in which case
* this must be set to "None". Note: "None" will not work (the browser will
* not send the cookie to Etherpad) unless https is used to access Etherpad
* (either directly or via a reverse proxy with "trustProxy" set to true).
*
* "Strict" is not recommended because it has few security benefits but
* significant usability drawbacks vs. "Lax". See
* https://stackoverflow.com/q/41841880 for discussion.
*/
"sameSite": "Lax"
},
/*
* Privacy: disable IP logging
*/
"disableIPlogging": {{ etherpad_ip_logging }},
/*
* Time (in seconds) to automatically reconnect pad when a "Force reconnect"
* message is shown to user.
*
* Set to 0 to disable automatic reconnection.
*/
"automaticReconnectionTimeout": {{ etherpad_automaticReconnectionTimeout }},
/*
* By default, when caret is moved out of viewport, it scrolls the minimum
* height needed to make this line visible.
*/
"scrollWhenFocusLineIsOutOfViewport": {
/*
* Percentage of viewport height to be additionally scrolled.
*
* E.g.: use "percentage.editionAboveViewport": 0.5, to place caret line in
* the middle of viewport, when user edits a line above of the
* viewport
*
* Set to 0 to disable extra scrolling
*/
"percentage": {
"editionAboveViewport": 0,
"editionBelowViewport": 0
},
/*
* Time (in milliseconds) used to animate the scroll transition.
* Set to 0 to disable animation
*/
"duration": 0,
/*
* Flag to control if it should scroll when user places the caret in the
* last line of the viewport
*/
"scrollWhenCaretIsInTheLastLineOfViewport": false,
/*
* Percentage of viewport height to be additionally scrolled when user
* presses arrow up in the line of the top of the viewport.
*
* Set to 0 to let the scroll to be handled as default by Etherpad
*/
"percentageToScrollWhenUserPressesArrowUp": 0
},
/*
* User accounts. These accounts are used by:
* - default HTTP basic authentication if no plugin handles authentication
* - some but not all authentication plugins
* - some but not all authorization plugins
*
* User properties:
* - password: The user's password. Some authentication plugins will ignore
* this.
* - is_admin: true gives access to /admin. Defaults to false. If you do not
* uncomment this, /admin will not be available!
* - readOnly: If true, this user will not be able to create new pads or
* modify existing pads. Defaults to false.
* - canCreate: If this is true and readOnly is false, this user can create
* new pads. Defaults to true.
*
* Authentication and authorization plugins may define additional properties.
*
* WARNING: passwords should not be stored in plaintext in this file.
* If you want to mitigate this, please install ep_hash_auth and
* follow the section "secure your installation" in README.md
*/
"users": {
"admin": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "{{ etherpad_admin_pwd }}",
"is_admin": true
}
/* ,
"user": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "changeme1",
"is_admin": false
}
*/
},
{% for item in etherpad_plugins %}
{% if item.name == 'ep_delete_after_delay' and item.install %}
/* This adds delete_after_delay config vars
*/
"ep_delete_after_delay": {
"delay": {{ delay }}, // one day, in seconds
"loop": {{ loopdeletion }},
"loopDelay": {{ loopDelay }}, // one hour, in seconds
"deleteAtStart": {{ deleteAtStart }},
"text": "{{ text }}"
},
{% endif %}
{% endfor %}
/*
* Restrict socket.io transport methods
*/
"socketTransportProtocols" : ["xhr-polling", "jsonp-polling", "htmlfile"],
"socketIo": {
/*
* Maximum permitted client message size (in bytes). All messages from
* clients that are larger than this will be rejected. Large values make it
* possible to paste large amounts of text, and plugins may require a larger
* value to work properly, but increasing the value increases susceptibility
* to denial of service attacks (malicious clients can exhaust memory).
*/
"maxHttpBufferSize": {{ etherpad_maxHttpBufferSize }}
},
/*
* Allow Load Testing tools to hit the Etherpad Instance.
*
* WARNING: this will disable security on the instance.
*/
"loadTest": false,
/*
* Disable indentation on new line when previous line ends with some special
* chars (':', '[', '(', '{')
*/
/*
"indentationOnNewLine": {{ etherpad_indentationOnNewLine }},
*/
/*
* From Etherpad 1.8.3 onwards, import and export of pads is always rate
* limited.
*
* The default is to allow at most 10 requests per IP in a 90 seconds window.
* After that the import/export request is rejected.
*
* See https://github.com/nfriedly/express-rate-limit for more options
*/
"importExportRateLimiting": {
// duration of the rate limit window (milliseconds)
"windowMs": {{ etherpad_importExportRateLimitingwindowMs }},
// maximum number of requests per IP to allow during the rate limit window
"max": {{ etherpad_importExportRateLimitingMax }}
},
/*
* From Etherpad 1.8.3 onwards, the maximum allowed size for a single imported
* file is always bounded.
*
* File size is specified in bytes. Default is 50 MB.
*/
"importMaxFileSize": {{ etherpad_importMaxFileSize }}, // 50 * 1024 * 1024
/*
* From Etherpad 1.8.5 onwards, when Etherpad is in production mode commits from individual users are rate limited
*
* The default is to allow at most 10 changes per IP in a 1 second window.
* After that the change is rejected.
*
* See https://github.com/animir/node-rate-limiter-flexible/wiki/Overall-example#websocket-single-connection-prevent-flooding for more options
*/
"commitRateLimiting": {
// duration of the rate limit window (seconds)
"duration": {{ etherpad_ratelimit_duration }},
// maximum number of chanes per IP to allow during the rate limit window
"points": {{ etherpad_ratelimit_points }}
},
/*
* Toolbar buttons configuration.
*
* Uncomment to customize.
*/
/*
"toolbar": {
"left": [
["bold", "italic", "underline", "strikethrough"],
["orderedlist", "unorderedlist", "indent", "outdent"],
["undo", "redo"],
["clearauthorship"]
],
"right": [
["importexport", "timeslider", "savedrevision"],
["settings", "embed"],
["showusers"]
],
"timeslider": [
["timeslider_export", "timeslider_returnToPad"]
]
},
*/
/*
* Expose Etherpad version in the web interface and in the Server http header.
*
* Do not enable on production machines.
*/
"exposeVersion": {{ etherpad_exposeVersion }},
/*
* The log level we are using.
*
* Valid values: DEBUG, INFO, WARN, ERROR
*/
"loglevel": "{{ etherpad_loglevel }}",
/*
* Logging configuration. See log4js documentation for further information:
* https://github.com/nomiddlename/log4js-node
*
* You can add as many appenders as you want here.
*/
"logconfig" :
{ "appenders": [
{ "type": "console"
//, "category": "access"// only logs pad access
}
/*
, { "type": "file"
, "filename": "{{ etherpad_logfile }}"
, "maxLogSize": 1024
, "backups": 3 // how many log files there're gonna be at max
//, "category": "test" // only log a specific category
}
*/
/*
, { "type": "logLevelFilter"
, "level": "warn" // filters out all log messages that have a lower level than "error"
, "appender":
{ Use whatever appender you want here }
}
*/
/*
, { "type": "logLevelFilter"
, "level": "error" // filters out all log messages that have a lower level than "error"
, "appender":
{ "type": "smtp"
, "subject": "An error occurred in your EPL instance!"
, "recipients": "{{ etherpad_error_log_recipient }}"
, "sendInterval": 300 // 60 * 5 = 5 minutes -- will buffer log messages; set to 0 to send a mail for every message
, "transport": "SMTP", "SMTP": { // see https://github.com/andris9/Nodemailer#possible-transport-methods
"host": "{{ etherpad_smtp_host }}", "port": {{ etherpad_smtp_port }},
"secureConnection": true,
"auth": {
"user": "{{ etherpad_smtp_user }}",
"pass": "{{ etherpad_smtp_pass }}"
}
}
}
}
*/
]
}, // logconfig
/* Override any strings found in locale directories */
"customLocaleStrings": {},
/* Disable Admin UI tests */
"enableAdminUITests": {{ etherpad_enableAdminUITests }}
}