pkgs/servers/web-apps/discourse/how_to_update.md

   1 To update discourse, do the following:
   2
   3 1. Switch to and work from the `master` branch and the directory this
   4    file is in.
   5 2. Run `./update.py print-diffs` and update the nginx settings and
   6    backend settings accordingly. If you don't know how to, ask for
   7    help - do not skip this step!
   8 3. Run `./update.py update`.
   9 4. Run `nix build -L -f ../../../../ discourse.tests` to make sure the
  10    update works. Also test manually, if possible.
  11 5. If the update works, commit it. If not, apply necessary fixes and
  12    commit. No manual fixes that would be overwritten by the
  13    `./update.py` script should be committed - the script should be
  14    fixed instead.
  15 6. Run `./update.py update-mail-receiver`. If there's an update, do
  16    step 4 and 5 again.
  17 7. Run `./update.py update-plugins`.
  18 8. Run `nix build -L -f ../../../../ discourseAllPlugins.tests` to
  19    make sure the plugins build and discourse starts with them. Also
  20    test manually, if possible.
  21 9. If the update works, commit it. If not, apply necessary fixes and
  22    commit. No manual fixes that would be overwritten by the
  23    `./update.py` script should be committed - the script should be
  24    fixed instead.