fabianwe/etherpad-lite repository overview

⁠etherpad-lite

A docker image for etherpad-lite using an alpine base image. Current ethperad-lite version: 1.8.6

This image was largely inspired by tvelocity/etherpad-lite⁠ but has some differences:

• Based on alpine Linux (smaller images). The container has at the moment a size of 136 MB.
• SESSIONKEY.txt and APIKEY.txt are stored in the var subdirectory and therefore are consistent when you rebuild your container.
  • Also the APIKEY is not stored in settings.json, newer versions of etherpad-lite don't like this.

⁠Usage

Here is a usage example in docker-compose, if you don't use compose I'm confident you can figure it out:

version: '3'

services:
  mariadb:
      image: mariadb
      volumes:
        - "./mariadb:/var/lib/mysql"
        - "./docker-entrypoint-initdb.d:/docker-entrypoint-initdb.d"
      environment:
        - MYSQL_ROOT_PASSWORD=<YOUR-PASSWORD>

  etherpad:
    image: fabianwe/etherpad-lite
    links:
      - "mariadb:mysql"
    expose:
      - "9001"
    environment:
      - ETHERPAD_DB_PASSWORD=<YOUR-PASSWORD>
    volumes:
      - "./etherpad:/opt/etherpad-lite/var"
    ports:
      - "9001:9001"

You can change the following environment variables:

• ETHERPAD_DB_HOST default "mysql"
• ETHERPAD_DB_USER default "root"
• ETHERPAD_DB_PASSWORD no default, must be set
• ETHERPAD_DB_NAME default "etherpad"
• ETHERPAD_TITLE default "Etherpad"
• ETHERPAD_PORT default 9001
• ETHERPAD_ADMIN_USER does not exist by default
• ETHERPAD_ADMIN_PASSWORD does not exist by default

And of course change the generated settings.json.

Note: In contrast to tvelocity/etherpad-lite⁠ this image will not create the database for you if it does not exist! This would increase the image size because we have to install mysql-client. Instead you have to create the database etherpad by yourself. For mariadb simply place a file "etherpad.sql" in the directory "docker-entrypoint-initdb.d" or somehow execute the command by yourself:

CREATE DATABASE IF NOT EXISTS etherpad CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;