I am trying to upgrade from an older version to v8.0 my deployment used docker standalone. I am not quite clear on the documentation instructions. v8.0 upgrade is going to break things and I need to perform data migration. The instructions go like this (https://signoz.io/docs/operate/upgrade/):

First upgrade to 0.8.0
Follow the platform specific instructions to upgrade to 0.8.0 and above.

Note that the past data will not be visible on the new application until you run the migration script.

Docker
- git clone -b main <https://github.com/SigNoz/signoz.git> && cd signoz/deploy/
- git checkout v0.8.0
- ./install.sh

Steps to run migration script:
Docker
docker run --name signoz_migrate --network clickhouse-setup_default \
  -it -d signoz/migrate:0.8 -host=clickhouse -port=9000
Steps to check logs:

docker logs -f signoz_migrate
In case of failure and have to run again, make sure to cleanup the container before running the migration script again.

docker stop signoz_migrate

docker rm signoz_migrate

My question is, what is the first thing to do? • I have signoz v6 running • I want to preserve the historical data I have • I already have the repo (I could just git pull for new changes and checkout the v8.0) • Should I stop the running docker-compose first before I clone? • Will the over-written changes to the repo erase my data? I know these could be newbies question but I would appreciate the clarity so I can do this successfully

@Vishal Sharma can you help here?

@Farisology We recommend to upgrade to v0.7.5 before upgrading to v0.8.0. After you have upgraded to v0.7.5 follow the steps mentioned in docs. Yes you can git pull and checkout

I already have the repo (I could just git pull for new changes and checkout the v8.0)

No you don’t need to stop running docker-compose first.

Should I stop the running docker-compose first before I clone?

No, none of the data will be erased, but you have to migrate your old data by running migration script.

Will the over-written changes to the repo erase my data?

cc: @Prashant Shahi

@Farisology you should be able to run the following to upgrade:

git checkout v0.7.5
cd deploy
./install.sh

git checkout v0.8.0
cd deploy
./install.sh