To upgrade your FleekDash server from an older version, you should use the FleekDash migration tool after you have installed the new version. The migration tool will adjust your FleekDash data to the new version's structure to make sure your FleekDash data is compatible with any internal changes.
As of version 0.14, FleekDash requires Docker Compose Version 2. To upgrade FleekDash, make sure your Docker installation is updated to support Composer V2.
A note about migration
You can migrate to versions that require a migration path and are higher than your current version, such as from 1.5.0 to 1.5.11.
If you're trying to migrate to a next major version such as from 1.5.0 to 1.6.0, you will first need to migrate to the latest patch version 1.5.11, then to 1.6.0.
It is highly recommended to backup your server data before running the migration. It is recommended to run the migration process on a dev instance and make sure your application is working well and that you have checked for any breaking changes in the new version changelog.
The first step is to install the latest version of FleekDash. Head to the directory where you ran your previous FleekDash install command.
parent_directory <= you run the command in this directory
└── fleekdash
└── docker-compose.yml
This is the parent directory where you will find the fleekdash directory, inside which there are docker-compose.yml and .env files.
Installing the next version
Parent directory naming
Your FleekDash installation's parent directory name is expected to be fleekdash. Changing the directory name will result in a miss-matched docker project names.
Unix
docker run -it --rm \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume "$(pwd)"/fleekdash:/usr/src/code/fleekdash:rw \
--entrypoint="upgrade" \
fleekdash/fleekdash:1.7.4
CMD
docker run -it --rm ^
--volume //var/run/docker.sock:/var/run/docker.sock ^
--volume "%cd%"/fleekdash:/usr/src/code/fleekdash:rw ^
--entrypoint="upgrade" ^
fleekdash/fleekdash:1.7.4
PowerShell
docker run -it --rm `
--volume /var/run/docker.sock:/var/run/docker.sock `
--volume ${pwd}/fleekdash:/usr/src/code/fleekdash:rw `
--entrypoint="upgrade" `
fleekdash/fleekdash:1.7.4
This will pull the docker-compose.yml file for the new version and perform the installation. Once the setup completes, verify that you have the latest version of FleekDash.
docker ps | grep fleekdash/fleekdash
Verify that the STATUS doesn't have any errors and all the fleekdash/fleekdash containers have the same version.
Running the Migration
We can now start the migration. Navigate to the fleekdash directory where your docker-compose.yml is present and run the following command.
cd fleekdash/
docker compose exec fleekdash migrate
The data migration can take longer depending on the amount of data your FleekDash instance contains. The FleekDash migration command uses multi-threading to speed up the process, meaning that adding more CPU cores can help speed up the process.
Once the migration process has been completed successfully, you're all set to use the latest version of FleekDash!