summaryrefslogtreecommitdiff
path: root/docs/content/guides/migrations-and-breaking-changes.md
diff options
context:
space:
mode:
authorYannick Bungers2021-01-05 17:27:24 +0100
committerGitHub2021-01-05 17:27:24 +0100
commit73d237165ea8fe411b764e5b5d1a2f51a2e02a0b (patch)
tree851df47886b64ac3c37ab6b809f300cd0dd99c0a /docs/content/guides/migrations-and-breaking-changes.md
parentd52d1d255a876fcf937c9df3717f6df9b745ad22 (diff)
parentd39c7deb32044a4a34e9c158f168070181b8ae9f (diff)
Merge pull request #656 from hedgedoc/docs/move-content
Move docs into subdirectory to make structor work
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.