This is a wrapper of etherpad-lite for Heroku, incorporating the official release from upstream as a submodule. (This will hopefully make it easier to keep current.)
- Set up a Heroku account and configure an app with DB of your choice (default MySQL)
- Clone this repo into a directory of your choice
- Set two Heroku config vars:
heroku config:add DATABASE_URL=urlfromDBprovider
heroku config:add ETHERPAD_SETTINGS=settingsJSONinroot.json
- Copy
settings.json.template
to the filename you gave forETHERPAD_SETTINGS
and tweak as needed - Add your Heroku app as a remote
git push heroku master
Just add the plugin to package.json as a dependency.
preparse.rb will copy all ep-starting packages to the etherpad plugins. Using the admin/plugins UI adds the plugin but it will reset in dyno restart
Etherpad will complain if you run it as root. If you wish to allow it to run as root, set an additional config variable:
heroku config:add ETHERPAD_ALLOW_ROOT=1
- node_modules versioning/locating
- Launch script cleanup
(I welcome pull requests for any of these.)
I had to rewrite the launch script on my own, but once I started to understand it, I incorporated lines from a previous repository.
I got the idea to deconfigure IP/port binding from the cloudfoundry etherapp repo, which was giving me headache for a little while.