Install Etherpad-lite

From Creative Crowds wiki
Jump to navigation Jump to search

Installation

7 Nov 2025

These are the steps followed to install Etherpad-lite 2.5.3 on CC:

https://github.com/ether/etherpad-lite?tab=readme-ov-file#installation

required: Node.js >= 18.18.2.

nodejs in apt trixie: nodejs/stable 20.19.2+dfsg-1 amd64

apt install nodejs npm
npm install -g pnpm

"pnpm is up to 2x faster than npm" (hmm, oke)

adduser --system --no-create-home etherpad-lite
cd /opt/
git clone -b master https://github.com/ether/etherpad-lite.git
chown -R etherpad-lite:root etherpad-lite/
su -s /bin/bash etherpad-lite
cd etherpad-lite/
pnpm i
pnpm run build:etherpad
pnpm run prod

we should now be able to open etherpad at: http://localhost:9001, but as we are not in the same local network as the CC server... we can open it at:

http://193.170.194.207:9001/

works!

systemd file

now, a systemd file to make it run in the background as a service?

nginx

and changes in the nginx config to make it run at https://cc.practices.tools/pad/

admin access

Admin username and password not set in settings.json. To access admin please uncomment and edit "users" in settings.json

install plugins

migrate database

and then migrate the database from the OVH server here.. (hmm, would the database of the etherpad version there be compatible the with this etherpad version 2.5.3?.... something to check....)

Plugins

For plugins: https://static.etherpad.org/index.html

cd /path/to/etherpad-lite
pnpm run plugins i ep_${plugin_name}

wish list: