Add simple sync migration steps

This commit is contained in:
Jared Smith
2022-10-26 04:49:39 +11:00
parent 949920cbc9
commit 77fcaafffe
2 changed files with 30 additions and 1 deletions

View File

@@ -1,7 +1,11 @@
---
title: 'Migration Overview'
title: "Migration Overview"
---
:::note
[Click here](simple-sync) if you are looking for the steps to migrate from "full sync" to (the more reliable) "simple sync" method.
:::
Keeping your existing transaction history is important. If you already use a different app, you probably want to migrate it over into Actual.
Right now, only YNAB4 is officially supported. However, the [API](/developers/API/) allows anyone to write a custom importer. We will work with the community to help write other importers soon.

View File

@@ -0,0 +1,25 @@
---
title: "Migration from Full Sync to Simple Sync"
---
The Full Sync method used at the launch of the self-hosted version of Actual had some reliability issues with some users and so a Simple Sync approach has replaced this. If you set up Actual before October 2022, you will be likely using the Full Sync method and upgrading Actual will require you to complete the following steps to migrate your transaction history before using Simple Sync.
## Before upgrading
1. Open your budget
2. [Export your budget](/Backup-Restore/Backups)
3. Upgrade your actual server
:::caution
If you have upgraded your server before completing the above steps, you may still be able to export on a device with your existing budget data cached otherwise you would need to manually download the relevant files directly from your server. This is outside the scope of this guide.
:::
## After upgrading
1. [Restore your budget](/Backup-Restore/Restore) on one device
2. Select your newly restored budget to load
3. On your other devices, close the existing budget (if already open) and then open the restored file
:::warning
Once you have upgraded, you will be unable to load your older budget files from the "Files" list.
:::