summaryrefslogtreecommitdiff
path: root/docs/content/guides/migrations-and-breaking-changes.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/guides/migrations-and-breaking-changes.md')
-rw-r--r--docs/content/guides/migrations-and-breaking-changes.md55
1 files changed, 55 insertions, 0 deletions
diff --git a/docs/content/guides/migrations-and-breaking-changes.md b/docs/content/guides/migrations-and-breaking-changes.md
new file mode 100644
index 00000000..bbc320b1
--- /dev/null
+++ b/docs/content/guides/migrations-and-breaking-changes.md
@@ -0,0 +1,55 @@
+# Migrations and Notable Changes
+
+## Migrating to 1.4.0
+
+We dropped support for node 6 with this version. If you have any trouble running this version, please double check that you are running at least node 8!
+
+## Migrating to 1.3.2
+
+This is not a breaking change, but to stay up to date with the community
+repository, you may need to update a few urls. This is not a breaking change.
+
+See more at [issue #10](https://github.com/hedgedoc/hedgedoc/issues/10)
+
+### Native setup using git
+
+Change the upstream remote using `git remote set-url origin https://github.com/hedgedoc/hedgedoc.git`.
+
+### Docker
+
+When you use our [container repository](https://github.com/hedgedoc/container)
+(which was previously `hedgedoc-container`) all you can simply run `git pull` and
+your `docker-compose.yml` will be updated.
+
+When you setup things yourself, make sure you use the new image:
+[`quay.io/hedgedoc/hedgedoc`](https://quay.io/repository/hedgedoc/hedgedoc?tab=tags).
+
+### Heroku
+
+All you need to do is [disconnect GitHub](https://devcenter.heroku.com/articles/github-integration#disconnecting-from-github)
+and [reconnect it](https://devcenter.heroku.com/articles/github-integration#enabling-github-integration)
+with this new repository.
+
+Or you can use our Heroku button and redeploy your instance and link the old
+database again.
+
+## Migrating to 1.1.0
+
+We deprecated the older lower case config style and moved on to camel case style. Please have a look at the current `config.json.example` and check the warnings on startup.
+
+*Notice: This is not a breaking change right now but will be in the future*
+
+## Migrating to 0.5.0
+
+[migration-to-0.5.0 migration tool](https://github.com/hackmdio/migration-to-0.5.0)
+
+We don't use LZString to compress socket.io data and DB data after version 0.5.0.
+Please run the migration tool if you're upgrading from the old version.
+
+## Migrating to 0.4.0
+
+[migration-to-0.4.0 migration tool](https://github.com/hackmdio/migration-to-0.4.0)
+
+We've dropped MongoDB after version 0.4.0.
+So here is the migration tool for you to transfer the old DB data to the new DB.
+This tool is also used for official service.