docs: add migration notice for autumn

README.md

@@ -21,26 +21,6 @@ This repository contains configurations and instructions that can be used for de
 > [!NOTE]
 > amd64 builds are only available for `backend` and `bonfire` images currently, more to come.
 
-> [!IMPORTANT]
-> If you deployed Revolt before [2022-10-29](https://github.com/minio/docs/issues/624#issuecomment-1296608406), you may have to tag the `minio` image release if it's configured in "fs" mode.
->
-> ```yml
-> image: minio/minio:RELEASE.2022-10-24T18-35-07Z
-> ```
-
-> [!IMPORTANT]
-> If you deployed Revolt before [2023-04-21](https://github.com/revoltchat/backend/commit/32542a822e3de0fc8cc7b29af46c54a9284ee2de), you may have to flush your Redis database.
->
-> ```bash
-> # for stock Redis and older KeyDB images:
-> docker compose exec redis redis-cli
-> # ...or for newer KeyDB images:
-> docker compose exec redis keydb-cli
->
-> # then run:
-> FLUSHDB
-> ```
-
 ## Quick Start
 
 This repository provides reasonable defaults, so you can immediately get started with it on your local machine.
@@ -217,3 +197,55 @@ docker compose exec database mongosh
 use revolt
 db.invites.insertOne({ _id: "enter_an_invite_code_here" })
 ```
+
+## Notices
+
+> [!IMPORTANT]
+> If you deployed Revolt before [2022-10-29](https://github.com/minio/docs/issues/624#issuecomment-1296608406), you may have to tag the `minio` image release if it's configured in "fs" mode.
+>
+> ```yml
+> image: minio/minio:RELEASE.2022-10-24T18-35-07Z
+> ```
+
+> [!IMPORTANT]
+> If you deployed Revolt before [2023-04-21](https://github.com/revoltchat/backend/commit/32542a822e3de0fc8cc7b29af46c54a9284ee2de), you may have to flush your Redis database.
+>
+> ```bash
+> # for stock Redis and older KeyDB images:
+> docker compose exec redis redis-cli
+> # ...or for newer KeyDB images:
+> docker compose exec redis keydb-cli
+>
+> # then run:
+> FLUSHDB
+> ```
+
+> [!IMPORTANT]
+> As of 30th September 2024, Autumn has undergone a major refactor which requires a manual migration.
+>
+> To begin, add a temporary container that we can work from:
+>
+> ```yml
+> # compose.override.yml
+> services:
+>   migration:
+>     image: node:21
+>     volumes:
+>       - ./migrations:/cwd
+>     command: "bash -c 'while true; do sleep 86400; done'"
+> ```
+>
+> Then switch to the shell:
+>
+> ```bash
+> docker compose up -d database migration
+> docker compose exec migration bash
+> ```
+>
+> Now we can run the migration:
+>
+> ```bash
+> cd /cwd
+> npm i mongodb
+> node ./20240929-autumn-rewrite.mjs
+> ```

migrations/.gitignore

@@ -0,0 +1,2 @@
+*.json
+node_modules