/etherpad-lite-sandstorm

Primary LanguageShellApache License 2.0Apache-2.0

Status

Vagrant-spk packaging:

There's a specific hack to get this to work for vagrant-spk that's significant enough to mention here. There is a problem installing with npm into a "synced folder". The workaround involves using a bind mount. See the long comment about this in .sandstorm/build.sh.

Raw packaging:

WARNING: Don't do this on your normal computer. This package was designed to work with both spk (raw) packaging and vagrant-spk packaging. As such, the raw packaging version involves installing things, maybe changing important things on your system, etc. No promises here about what it won't do. This is intended for people who prefer raw spk because they run QubesOS or something like that, where on the one hand VirtualBox is difficult to run, but on the other hand you can make throwaway VMs in which to safely do raw packaging. Most people likely should use the vagrant-spk option.

Setup

  1. this repo needs to be checked out at /opt/app. Not as a symlink or anything like that, the real path has to be there. It affects how the app behaves at least in some ways.

  2. your user should have write access (without requiring sudo) to /var/.

  3. make sure your user isn't for some reason called "vagrant". A couple commands are vagrant-specific, and you may not want those commands to be run here.

Building

  • sudo .sandstorm/setup.sh
  • .sandstorm/build.sh

Run within Sandstorm

cd .sandstorm
spk dev

Run outside of Sandstorm

This could be useful in some cases for debugging and development. If we ever start saving the minified cache as part of the app, this may even become necessary.

  • .sandstorm/launcher.sh

License

Apache License v2 for Etherpad Creative Commons Attribution-Sharealike 3.0 for the Etherpad logo (by Marcel Klehr) used for the app icon

Attributions

Many of the Sandstorm-specific edits have been taken from Kenton's previous versions of: