Skip to content


Subversion checkout URL

You can clone with
Download ZIP

Release procedure

Stefan edited this page · 13 revisions



For Developers

How to's

Set up

Advanced steps

Integrating Etherpad in your web app

for Developers

Clone this wiki locally
  1. Consider, which changes (aka commits) you want to release into master (This commit comparison view is quite useful)
  2. Determine the new version number, following semantic versioning spec.
  3. Move the relevant commits into a new branch release/x.x.x using this git flow technique
  4. Ensure, all version numbers are up-to-date
    1. Be sure the API version is correct (new endpoints shouldn't be added to already existing API versions)
    2. Update the version number in package.json (and elsewhere?)
  5. Create a new entry in the changelog, documenting all changes.
  6. Push release/x.x.x to github
  7. Open a pull request from release/x.x.x to master
  8. Once the pull request is merged into master, tag the the merge commit with x.x.x
  9. Create a new windows build
    1. Run bin/
    2. Name the resulting zip file: etherpad-lite-win-x.x.x-<git-sha>.zip
    3. Add the file here for the website:
  10. Update the docs
    1. Build the docs with make docs
    2. Put the contents of out/doc/ into a new directory doc/vX.X.X/ inside
  11. Adjust all links on
    1. Update the version numbers on all download buttons
    2. Update the documentation link (version number in url and text) on the website
  12. Push to github
  13. Update links in this wiki also
  14. Put up some notices on relevant sites, announcing the new release as well as possibly critical changes it introduces.
  15. Pull master branch over develop
  16. Update the instance using git pull

Note that step 15 is for Etherpad Site Admins

Something went wrong with that request. Please try again.