docs: Update content

This commit is contained in:
Glenn Y. Rolland 2022-05-08 21:26:29 +02:00
parent 53c863d76c
commit e49f063e6b

View file

@ -1,15 +1,7 @@
# Etherpad Lite image for docker # Etherpad Lite image for docker
This is a docker image for [Etherpad Lite](http://etherpad.org/) collaborative
text editor. The Dockerfile for this image has been inspired by the
[official Wordpress](https://registry.hub.docker.com/_/wordpress/) Dockerfile and
[johbo's etherpad-lite](https://registry.hub.docker.com/u/johbo/etherpad-lite/)
image.
This image uses an mysql container for the backend for the pads. It is based This image uses an mysql container for the backend for the pads. It is based
on debian jessie instead of the official node docker image, since the latest on latest nodejs image.
stable version of etherpad-lite does not support npm 2.
## About Etherpad Lite ## About Etherpad Lite
@ -17,7 +9,7 @@ stable version of etherpad-lite does not support npm 2.
Etherpad allows you to edit documents collaboratively in real-time, much like a live multi-player editor that runs in your browser. Write articles, press releases, to-do lists, etc. together with your friends, fellow students or colleagues, all working on the same document at the same time. Etherpad allows you to edit documents collaboratively in real-time, much like a live multi-player editor that runs in your browser. Write articles, press releases, to-do lists, etc. together with your friends, fellow students or colleagues, all working on the same document at the same time.
![alt text](http://i.imgur.com/zYrGkg3.gif "Etherpad in action on PrimaryPad") ![alt text](http://i.imgur.com/zYrGkg3.gif "Etherpad in action")
All instances provide access to all data through a well-documented API and supports import/export to many major data exchange formats. And if the built-in feature set isn't enough for you, there's tons of plugins that allow you to customize your instance to suit your needs. All instances provide access to all data through a well-documented API and supports import/export to many major data exchange formats. And if the built-in feature set isn't enough for you, there's tons of plugins that allow you to customize your instance to suit your needs.
@ -25,26 +17,44 @@ You don't need to set up a server and install Etherpad in order to use it. Just
## Quickstart ## Quickstart
First you need a running mysql container, for example: Copy-paste the following content in a `docker-compose.yml` file
```bash ```yaml
$ docker network create ep_network ---
$ docker run -d --network ep_network -e MYSQL_ROOT_PASSWORD=password --name ep_mysql mysql version: "3.4"
services:
db:
image: mariadb:10.3
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
volumes:
- db_data:/var/lib/mysql
environment:
MARIADB_ROOT_PASSWORD: insecure
MARIADB_DATABASE: etherpad
etherpad:
build:
context: .
dockerfile: Dockerfile
image: glenux/etherpad:latest
environment:
DATABASE_URL: mysql://root:insecure:3306@db/etherpad
ETHERPAD_ADMIN_USER: admin
ETHERPAD_ADMIN_PASSWORD: insecure
NODE_ENV: production
ports:
- 9001:9001
volumes:
db_data:
``` ```
Finally you can start an instance of Etherpad Lite: Then run `docker-compose up`
```bash
$ docker run -d \
--network ep_network \
-e ETHERPAD_DB_HOST=ep_mysql \
-e ETHERPAD_DB_PASSWORD=password \
-p 9001:9001 \
tvelocity/etherpad-lite
```
Etherpad will automatically create an `etherpad` database in the specified mysql Etherpad will automatically create an `etherpad` database in the specified mysql
server if it does not already exist. server if it does not already exist.
You can now access Etherpad Lite from http://localhost:9001/ You can now access Etherpad Lite from http://localhost:9001/
## Environment variables ## Environment variables
@ -53,9 +63,6 @@ This image supports the following environment variables:
* `ETHERPAD_TITLE`: Title of the Etherpad Lite instance. Defaults to "Etherpad". * `ETHERPAD_TITLE`: Title of the Etherpad Lite instance. Defaults to "Etherpad".
* `ETHERPAD_PORT`: Port of the Etherpad Lite instance. Defaults to 9001. * `ETHERPAD_PORT`: Port of the Etherpad Lite instance. Defaults to 9001.
* `ETHERPAD_SESSION_KEY`: Session key for the Etherpad Lite configuraition. You
can set this in case of migrating from another installation. A value is
automatically generated by default.
* `ETHERPAD_ADMIN_PASSWORD`: If set, an admin account is enabled for Etherpad, * `ETHERPAD_ADMIN_PASSWORD`: If set, an admin account is enabled for Etherpad,
and the /admin/ interface is accessible via it. and the /admin/ interface is accessible via it.
@ -65,7 +72,7 @@ Otherwise the user can set it to another username.
* `ETHERPAD_DB_HOST`: Hostname of the mysql databse to use. Defaults to `mysql` * `ETHERPAD_DB_HOST`: Hostname of the mysql databse to use. Defaults to `mysql`
* `ETHERPAD_DB_USER`: By default Etherpad Lite will attempt to connect as root * `ETHERPAD_DB_USER`: By default Etherpad Lite will attempt to connect as root
to the mysql container. to the mysql container.
* `ETHERPAD_DB_PASSWORD`: MySQL password to use, mandatory. If legacy links * `ETHERPAD_DB_PASS`: MySQL password to use, mandatory. If legacy links
are used and ETHERPAD_DB_USER is root, then `MYSQL_ENV_MYSQL_ROOT_PASSWORD` is are used and ETHERPAD_DB_USER is root, then `MYSQL_ENV_MYSQL_ROOT_PASSWORD` is
automatically used. automatically used.
* `ETHERPAD_DB_NAME`: The mysql database to use. Defaults to *etherpad*. If the * `ETHERPAD_DB_NAME`: The mysql database to use. Defaults to *etherpad*. If the
@ -73,3 +80,4 @@ database is not available, it will be created when the container is launched.
The generated settings.json file will be available as a volume under The generated settings.json file will be available as a volume under
*/opt/etherpad-lite/var/*. */opt/etherpad-lite/var/*.