diff --git a/Upgrade-instructions.md b/Upgrade-instructions.md
new file mode 100644
index 0000000..b852eda
--- /dev/null
+++ b/Upgrade-instructions.md
@@ -0,0 +1,22 @@
+## Upgrade from < 3.3 tot 3.3 and higher.
+
+1. Run ``git pull`` on the root of your Firefly III directory.
+2. Run ``composer update``.
+3. Run ``php artisan env`` and remember your environment.
+4. Run ``php artisan migrate --env=xxxx`` where xxxx is your environment.
+5. 
+
+
+
+Upgrading Firefly consists of the following:
+
+1. Run ``git pull`` on the root of your Firefly III directory.
+2. Run ``composer update``.
+3. Run ``php artisan env`` and remember your environment.
+4. Run ``php artisan migrate --env=xxxx`` where xxxx is your environment.
+
+Nine times out of ten this will successfully upgrade your installation to the latest version. Common problems include:
+
+### White screen
+
+Check if ``app/storage/logs`` is writeable. If so, follow the errors in the latest log files and open an issue.
\ No newline at end of file