Migrate Cloudron Apps to a new server

Migrate Cloudron Apps to a new server

Just a litle guide how to move your existing sites/apps from one to another Cloudron server.

In this case I moved from a bare metal proxmox cloudron on Hetzner to the Hetzner Cloud. Due to the fact that the Storage Box is atached to the server I will try to avoid attaching same backup location to the new server to be sure the backups are still archived after dismanteling the server.

The old Cloudron instance is atttached to the Storage Box and backups are stored in the storage box mounted at the server at

/mnt/cloudronbackup

So starting on the old instance go to the App and create a backup first

Go to My Apps - choose App and click on the gear icon
Go to My Apps - choose App and click on the gear icon
Go to Backups and click on Create Backup
Go to Backups and click on Create Backup
Download Backup Configuration of the created backup to your local disk
Download Backup Configuration of the created backup to your local disk

Stop the App / Service on the OLD Cloudron:

Stop the App on OLD Cloudron
Stop the App on OLD Cloudron
Confirm Stopping the App
Confirm Stopping the App

At this point its up to you how to transfer the backup from the old instance to the new instance. I prefer SFTP to the old server and to the new server, transfering the backup to local disk to have it archived for potential troubleshooting and transfering from the local disk to the server (of course you can simply tranfer directly to the new server also)

Lets go ahead and SFTP into OLD Cloudron:

Transfer the backup from OLD Cloudron to local disk (located in /mnt/cloudronbackup)
Transfer the backup from OLD Cloudron to local disk (located in /mnt/cloudronbackup)

SSH to your new Cloudron instance and create the same folder in /mnt:

mkdir /mnt/cloudronbackup

SFTP in your new instance and upload the backup folder from local disk:

Upload Backup from local disc to new Cloudron´s /mnt/cloudronbackup folder
Upload Backup from local disc to new Cloudron´s /mnt/cloudronbackup folder

change permissions to cloudrons yellowtent user in SFTP or simply in your still open SSH session on the NEW Cloudron:

chown -R yellowtent:yellowtent /mnt/cloudronbackup

Install the same App Service from Cloudrons App Store on your NEW Cloudron with the same location for updating the DNS at Cloudflare (with Proxy on - more later on)

Install same App from Cloudrons App Store on NEW Cloudron
Install same App from Cloudrons App Store on NEW Cloudron
Install the App on NEW Cloudron
Install the App on NEW Cloudron

Choose same location for the App on NEW Cloudron as on the OLD Cloudron:

Choose same location and click install
Choose same location and click install
Confirm to overwrite existing DNS at Cloudflare (or DNS provider of your choice)
Confirm to overwrite existing DNS at Cloudflare (or DNS provider of your choice)
Click on the Gear icon to follow the Installation progress
Click on the Gear icon to follow the Installation progress

As there is a issue with updating ipv6 DNS entrys with proxy enebled on cloudflare you can cancel the task to fix the AAAA entrys first. So you can cancel at: Installing - Waiting for DNS propagation

Edit: seem to be a general issue with updating unproxied DNS entrys to proxied so deleting DNS entrys for A records seem to be also required in some cases

Cancel Task if it stops on Installing - Waiting for DNS propagation
Cancel Task if it stops on Installing - Waiting for DNS propagation

Click on the Task Error to open Cloudrons Troubleshooting

Click on the Task Error
Click on the Task Error

Leave the Task Error Window open and log in to your Cloudflare Dashboard and Navigate to your Domains DNS Settings to check your DNS records and search for the AAAA entry of the label you wanted to install:

The AAAA Entry was created un proxied - go to Edit
The AAAA Entry was created un proxied - go to Edit

While the ipv4 Entryy was updated and Proxy set enabled the ipv6 Entry was created without proxy and that caused the Task error. Simply go to Edit and delete the AAAA Entry of the app location:

delete the AAAA entry of the location in Cloudflare DNS
delete the AAAA entry of the location in Cloudflare DNS

Now you can retry the Install Task on Cloudron:

Retry Install Task on NEW Cloudron
Retry Install Task on NEW Cloudron
Confirm Retry Install on the location
App istalls like charm and is up and running on the NEW Cloudron
App istalls like charm and is up and running on the NEW Cloudron

Now the App is up and running on the NEW Cloudron and we can Import the Backup:

Go to Backups and click on Import Backup
Go to Backups and click on Import Backup
Choose Upload Backup Config and upload the configuration.json from your local disk
Choose Upload Backup Config and upload the configuration.json from your local disk

This will fill out the Backup configuration. As the passwords are not stored in the config file put in the Passwords for cifs or encryption manually.

Fill out the password fields manually and click on Import

Thats all. App is restored and should be up and running on NEW Cloudron.

Keep in mind that if you set a Redirect location afterwards this can also be the issue when DNS update times out.

André Caffell

André Caffell

techaholic
Paderborn