trashposs/docs/migrate.md
2024-04-06 22:38:19 +02:00

57 lines
2.2 KiB
Markdown

# 🚚 Migrating from Misskey/FoundKey/Firefish/Iceshrimp to TrashPoss
All the guides below assume you're starting in the root of the repo directory.
### Before proceeding
- **Ensure you have stopped all master and worker processes of TrashPoss.**
- **Ensure you have backups of the database before performing any commands.**
## Misskey v12.119 and before
```sh
git remote set-url origin https://iceshrimp.dev/Crimekillz/trashposs.git
git fetch
git checkout v2023.11.4 # or any other tag or dev
# build and run migrations using preferred method
```
> **Note**
> Migrating from Misskey v13 and its forks (Sharkey et al) is unsupported due to database schema changes.
## FoundKey
```sh
wget -O fk.patch https://iceshrimp.dev/Crimekillz/trashposs/raw/branch/dev/docs/fk.patch
git apply fk.patch
cd packages/backend
```
Run `npx typeorm migration:revert -d ormconfig.js` for every migration until you see that `uniformThemecolor1652859567549` has been reverted. Command will not terminate properly after reverting, so you'll have to Ctrl-C
```
git remote set-url origin https://iceshrimp.dev/Crimekillz/trashposs.git
git fetch
git checkout v2023.11.4 # or any other tag or dev
# build and migrate using preferred method
```
## Firefish
Run `docker exec -it firefish_web /bin/sh` if using docker, before doing reverts.
Go to `packages/backend`, revert migrations manually using `pnpm run revertmigration:typeorm` for every migration, until `FirefishRepo1689957674000` has been reverted. Command will not terminate properly after reverting, so you'll have to Ctrl-C.
If you are migrating from versions newer than 1.0.3, you'll also have to run `pnpm run revertmigration:cargo` for every migration, until `m20230806_170616_fix_antenna_stream_ids` has been reverted.
Build and run migrations using your preferred method.
### Troubleshooting
If migration `IncreaseHostCharLimit1692374635734` failed to revert, please run `DELETE FROM "migrations" WHERE "name" = 'IncreaseHostCharLimit1692374635734';`
## Reverse
You ***cannot*** migrate back to Misskey from TrashPoss due to re-hashing passwords on signin with argon2, however theoretically you should be able to migrate from TrashPoss to Iceshrimp.