Breaking updates

Introduction

This page is dedicated to describe breaking updates and guide you through the process of updating your instance to the newer versions.

Update from 3.x.x to 4.0.0 (Beta)

In the version 4.0.0 we introduced a major new feature: multi app-store support. This feature requires you to update your folder structure to support multiple app-stores. In previous versions, the folder structure was like this:

• runtipi
  • app-data
    • nextcloud
  • apps
    • nextcloud

From now on, the folder structure will include a new sub-folder for each app-store. The new folder structure will look like this:

• runtipi
  • app-data
    • <my-store>
      • nextcloud
  • apps
    • <my-store>
      • nextcloud

We have prepared a script that will automatically update your folder structure to the new format. You can run it by executing the following command in your runtipi directory:

Inside the runtipi directory, download the script:

curl -sSL https://raw.githubusercontent.com/runtipi/runtipi/release/4.0.0/scripts/temp-update-3.0.0-to-4.0.0-beta.sh -o update_script.sh

Make the script executable:

chmod +x update_script.sh

Run the script:

sudo ./update_script.sh

Or you can follow all the manual steps below:

./runtipi-cli stop

mkdir -p migration-backups

mv app-data migration-backups/app-data
mv apps migration-backups/apps
mv user-config migration-backups/user-config
mv backups migration-backups/backups

mkdir -p app-data/migrated apps/migrated user-config/migrated backups/migrated

mv migration-backups/apps/* apps/migrated/
mv migration-backups/app-data/* app-data/migrated/
mv migration-backups/user-config/* user-config/migrated/
mv migration-backups/backups/* backups/migrated/

mv migration-backups/user-config/tipi-compose.yml user-config/tipi-compose.yml

ls -la migration-backups/apps
ls -la migration-backups/app-data
ls -la migration-backups/user-config
ls -la migration-backups/backups

uname -m

curl -sSL https://github.com/runtipi/runtipi/releases/download/v4.0.0-beta.5/<asset-name> | tar -xz

rm runtipi-cli

mv runtipi-cli-linux-<arch> runtipi-cli

chmod +x ./runtipi-cli

sudo ./runtipi-cli start

rm -rf migration-backups

Update from 2.x.x to 3.0.0

In the version 3.0.0 we completely re-wrote the runtipi-cli tool. The new CLI is written in Rust and it is much more stable, faster and smaller than the previous version. You won’t be able to update to the version 3.0.0 using the old node CLI. In order to update to the version 3.0.0 you will need to manually download the new CLI and replace the old one.

We have prepared a script that will do the update for you. You can run it by executing the following command in your runtipi directory:

curl -sSL https://raw.githubusercontent.com/runtipi/runtipi/master/scripts/update-2.0.0-to-3.0.0.sh | bash

Or you can do it manually by following these steps:

cd /path/to/runtipi
./runtipi-cli stop

uname -m

curl -sSL https://github.com/runtipi/runtipi/releases/download/v3.0.0/<asset-name> | tar -xz

rm runtipi-cli

mv runtipi-cli-linux-<arch> runtipi-cli

chmod +x ./runtipi-cli

./runtipi-cli start

Update from 1.x.x to 2.0.0

In the previous release (v1.6.0) we introduced the new rootless mode. After some reports from our users, we realized that the rootless mode is not working as expected. This version messes up the permissions of the files and folders in the runtipi directory.

Updating to 2.0.0 requires you to manually run the update script with sudo privileges in order to fix the permissions.

sudo ./runtipi-cli update v2.0.0

Update from 0.x.x to 1.0.0

In the version 1.0.0 we officially dropped support for 32-bit systems. If you are running 32-bit system, you will need to upgrade to 64-bit system. If you are running 64-bit system, you can safely upgrade to the version 1.0.0 without any manual steps

sudo ./scripts/system.sh update