> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/en-us/cherry-studio/installation/v2-to-v1-downgrade.md).
# Downgrade from V2 to V1
Downgrading is suitable for cases where V2 is temporarily affecting critical work and you still have usable V1 data. It will not convert V2 data into V1 format.
{% hint style="danger" %}
New sessions, Agents, settings, and files in V2 will not be brought back to V1. V2 backups also cannot be restored to V1; before downgrading, please keep the latest V2 backup and the original V1 backup or a copy of the data directory separately.
{% endhint %}
## Normal downgrade
{% stepper %}
{% step %}
### Stop tasks and back up V2
End any running conversation, Agent, and file processing tasks. In \[Settings] → \[Data], create a new full V2 backup and save it outside the app data directory.
{% endstep %}
{% step %}
### Confirm that the V1 data is still present
Find the copy of the V1 data directory or V1 backup kept before the upgrade. If you only have a V1 backup, restore it in a compatible V1 version; do not import it into V2.
{% endstep %}
{% step %}
### Download and install V1
Fully exit V2, from [Official V1 download](https://cherryai.com.cn/download/v1) Get the installer package that matches your current system and complete the installation.
{% endstep %}
{% step %}
### Start using the original V1 data
Launch V1 and use the V1 data directory from before the upgrade. Do not overwrite it with the V2 database or a V2 backup.
{% endstep %}
{% step %}
### Check before continuing work
Check your commonly used sessions, model services, knowledge base, and files. Do not delete any V1 or V2 backups until you confirm the V1 data is working properly.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
A normal downgrade does not require deleting the database. Keeping the V2 data can make it easy to return to V2 later and can also help avoid accidentally deleting content that has not been exported yet.
{% endhint %}
{% hint style="danger" %}
In V2.0.2, \[Settings] → \[Data] → \[Re-migrate] is not a downgrade entry. It will permanently delete the current V2 data and then re-import from the original V1 data; unless the earlier V1 migration failed or missed data, do not click it.
{% endhint %}
## When should the V2 database be handled?
Only handle it in the following cases:
* You clearly want to abandon all current V2 data and keep only V1 data;
* You need to perform the V1 → V2 migration again.
This is not a normal downgrade step. The operation affects all V2 sessions, Agents, settings, and other data; it is not just clearing a batch of test records.
### Safe handling method
1. Completely exit V1 and V2, and make sure there are no background tasks.
2. Open V1 1.9.13's \[Settings] → \[Data] → \[App Data] to enter the current app data directory.
3. Move the following items to the desktop or another safe location; do not delete them directly:
* `Data/cherrystudio.sqlite`
* `Data/cherrystudio.sqlite-shm` and `Data/cherrystudio.sqlite-wal`(if present)
* `Data/Agents/.claude`
4. Start V1 and check the original V1 data. If you need to migrate again, then start V2 to complete the migration.
5. Only decide whether to delete the files moved out earlier after confirming that the V1 data is usable and that a V2 backup can also be found.
{% hint style="danger" %}
Do not move the database while the app is running; do not move only `cherrystudio.sqlite` and leave out the `-shm` or `-wal` files in the same directory, and do not replace the V2 database with the V1 database. If you cannot determine the current data directory or the purpose of a file, stop and contact the Cherry Studio support team.
{% endhint %}
## FAQ
Can new conversations in V2 be brought back to V1?
No. Please export the content you want to keep in V2, and continue using only the original V1 data in V1.
Will downloading V1 automatically convert V2 data?
No. The installer only installs the app; it does not convert data or backup formats.
Can I just delete the database and try again?
Not recommended. Move it out and keep it first, then decide whether to delete it after verification; if it is deleted by mistake and there is no usable backup, V2 data may be unrecoverable.
After downgrading and returning to V2 again, which version should I install?
If you want to continue using the previous V2 data, you can install V2.0.2 directly and do not click \[Re-migrate]. If the earlier V1 migration failed or missed data, you can use \[Settings] → \[Data] → \[Re-migrate] after making a full backup of the current V2; this operation will permanently delete the current V2 data and then re-import from V1.
## References
* [Cherry Studio V1 official download](https://cherryai.com.cn/download/v1)
* [Cherry Studio V2 official download](https://cherryai.com.cn/download)
* V2.0.2 release page:[GitCode](https://gitcode.com/CherryHQ/cherry-studio/releases/v2.0.2) · [GitHub](https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.2)
* [Bug reports and feature requests](/docs/en-us/question-contact/suggestions.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cherryai.com.cn/docs/en-us/cherry-studio/installation/v2-to-v1-downgrade.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.