# Migration guide

**URL:** https://forum.yunohost.org/t/migration-guide/18509
**Category:** Support
**Tags:** migration, english
**Created:** [January 17, 2022, 10:53am UTC](https://forum.yunohost.org/t/migration-guide/18509 "2022-01-17T10:53:58Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![tommi](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tommi/32/4537_2.png) [@tommi](https://forum.yunohost.org/u/tommi)
#### Post date: [January 17, 2022, 10:53am UTC](https://forum.yunohost.org/t/migration-guide/18509/1 "2022-01-17T10:53:59Z")

</div>

### My YunoHost server

**Hardware:** VPS bought online  
**YunoHost version:** 4.3.6  
**I have access to my server :** Through SSH  
**Are you in a special context or did you perform some particular tweaking on your YunoHost instance ?** : no

### Description of my issue

I would like to migrate from the current server to a more powerful one. Is there a simple and straightforward way to do so via YuhoHost?

Furthermore, is there any thorough step-by-step guide?

What concerns me:

- pushing IP address changes to Gandi registrar automatically
- migrating configurations and saved data
- seamless transition from one server to another via YunoHost

Thanks a lot in advance for your help!

T

---

<div class="post-metadata">

### Author: ![Aleks](https://forum.yunohost.org/user_avatar/forum.yunohost.org/aleks/32/1704_2.png) [@Aleks](https://forum.yunohost.org/u/Aleks)
#### Post date: [January 17, 2022, 11:43am UTC](https://forum.yunohost.org/t/migration-guide/18509/2 "2022-01-17T11:43:50Z")

</div>

People have had good experiences with backing up the server on one side, and restoring the backup on the new server (either directly after the postinstall, or you can also run `yunohost backup restore /path/to/archive` _as a replacement for postinstall_)

---

<div class="post-metadata">

### Author: ![tommi](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tommi/32/4537_2.png) [@tommi](https://forum.yunohost.org/u/tommi)
#### Post date: [January 19, 2022, 8:58am UTC](https://forum.yunohost.org/t/migration-guide/18509/3 "2022-01-19T08:58:20Z")

</div>

Thank you very much, but unfortunately your explanation is not detailed enough for my limited technical skills… how should I backup? What does postinstall mean? The path of the backup I want to restore leads to a directory that I can move from a server to another with a simple `scp` command?

Sorry for the many questions.

---

<div class="post-metadata">

### Author: ![tituspijean](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tituspijean/32/3584_2.png) [@tituspijean](https://forum.yunohost.org/u/tituspijean)
#### Post date: [January 19, 2022, 10:06am UTC](https://forum.yunohost.org/t/migration-guide/18509/4 "2022-01-19T10:06:15Z")

</div>

No worries, it’s the occasion to sum it up and refine the documentation.

1. [Perform a full backup (system and apps)](https://yunohost.org/en/backup#creating-backups)
2. [Install your new server](https://yunohost.org/en/install), but do _not_ perform the postinstallation step. ~~That one is either performed with the browser-based form or the `yunohost tools postinstall` command.~~ Do _not_ do it.
3. [Download the backup](https://yunohost.org/en/backup#downloading-backups) (yes, `scp` is a solution, most likely better than trying to download a huge archive from the browser as shown first in the doc. You can `scp` directly from the command line of the new server, and put the archive back into `/home/yunohost.backup/archives/<archivename>.tar`)
4. Restore your backup from the command line: `yunohost backup restore <archivename>`
5. Change your DNS configuration at your registrar. That way, since DNS propagation varies widely, you have two servers offering the same content available at the same time, very useful for you not to lose visitors. Be careful if you have users generating content meanwhile, they have to check they are connecting to the new server (a ping to check the IP address should be enough).
6. Delete your old server the next day, it should be long enough time for the new DNS records to propagate, and for you to make sure everything is working on the new one.

Side note for documentation editors, myself included: [this antediluvian page has to be updated](https://yunohost.org/en/backup/migrate_or_merge_servers).

---

<div class="post-metadata">

### Author: ![tommi](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tommi/32/4537_2.png) [@tommi](https://forum.yunohost.org/u/tommi)
#### Post date: [February 8, 2022, 11:48am UTC](https://forum.yunohost.org/t/migration-guide/18509/5 "2022-02-08T11:48:05Z")

</div>

This is very useful. Thank you _very_ much!

Best,  
T

---

<div class="post-metadata">

### Author: ![system](https://forum.yunohost.org/uploads/default/original/2X/f/f59fe8e3ee6b100b4f574d30d6e30479c68b89f0.png) [@system](https://forum.yunohost.org/u/system)
#### Post date: [March 10, 2022, 11:48am UTC](https://forum.yunohost.org/t/migration-guide/18509/6 "2022-03-10T11:48:22Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
