diff --git a/MIGRATING.md b/MIGRATING.md
new file mode 100644
index 0000000..d923588
--- /dev/null
+++ b/MIGRATING.md
@@ -0,0 +1,16 @@
+# Migrating
+Migrating to any version in the same major version (e.g. `1.0.0` -> `1.1.0`) is a safe operation, nothing additional is required. 
+
+Migrating to a major version (e.g. `1.1.0` -> `2.0.0`) can be done by following the instructions below.
+
+## Migrating to 2.0.0 from 1.x.x
+Version 2.0.0 changes the configuration file and flags considerably, to make it easier to use and allow for more flexibility. An example configuration migration can be found below.
+
+### Migrating the configuration file
+   1. Make a backup of your old `config.json`
+   2. Migrate your configuration file
+      * If running from source, edit the `config.sample.jsonc` file to your liking and save it as `config.jsonc`, the configuration location flag `-c` still works as before.
+      * If running from binary, run the file with `-w` to write a new configuration file `config.jsonc` to the current directory.
+   3. Migrate the runtime flags
+      - `-m` is now `message` in the config.
+      - `-d` is now `directory` in the config.
\ No newline at end of file
diff --git a/README.md b/README.md
index 8cd2066..742b777 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,9 @@ A bot that posts local and booru images to the Fediverse.
 
 Compatible with Mastodon, Misskey and Pleroma!
 
+## MIGRATING MAJOR VERSIONS
+See [MIGRATING.md](./MIGRATING.md)
+
 ## Boorus supported 
 The full list of boorus supported is found [here](https://github.com/AtoraSuunva/booru/blob/master/src/sites.json).
 
diff --git a/package.json b/package.json
index 0c244d0..504f53e 100644
--- a/package.json
+++ b/package.json
@@ -9,7 +9,7 @@
     "typescript": "^4.6.2"
   },
   "name": "fediverse-imagebot",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Image bot for the fediverse (Pleroma, Mastodon, Misskey)",
   "exports": "./dist/index.js",
   "bin": "dist/index.js",