#
1.9.0 Migration Guide
#
How to migrate to a new branch if I use main/dev?
It is recommended to do a fresh install. However, if you wish to use an existing copy of SillyTavern, please follow the instructions below.
IMPORTANT! Before doing anything, make a complete backup of your installation. You may lose your data in the process, so don't ignore this warning.
Not sure of which files to back up? See the list here: How to Update SillyTavern
#
git installs
Open a terminal prompt (cmd, PowerShell, Termux, etc) in your SillyTavern installation folder.
Type
git fetch
and thengit pull
to pull the updates.You may lose your settings. Have you made a backup?
git switch release
orgit switch staging
will change your branch, respectivelySkip to next item if you have no errors. You may have something like:
error: Your local changes to the following files would be overwritten by checkout: config.conf public/css/bg_load.css public/settings.json
You will see a list of files affected. If you do not care about those settings files being replaced
git switch -f release
orgit switch -f staging
will set your branch. If you do care to save those changes restore from backup.Type
npm install
and thennpm run start
to test that everything behaves correctly.Enjoy! Restore your data from a backup if needed.
#
fatal: invalid reference: release
This may happen if you cloned just a single branch from an old remote (before migration to the organization repo). To fix this, you need to add and fetch a branch from a new remote:
git remote add st https://github.com/SillyTavern/SillyTavern
git fetch st
git checkout -t st/release
Then proceed from step 5.
#
ZIP installs
Nothing changes for you. Just download the branch/release ZIP like usual.