mirror of
https://gitlab.com/Kwoth/nadekobot.git
synced 2025-09-10 09:18:27 -04:00
67 lines
3.7 KiB
Markdown
67 lines
3.7 KiB
Markdown
# Migration instructions (2.x to v3)
|
||
|
||
## Windows
|
||
|
||
1. Run your NadekoBot Updater first, and **make sure your bot is updated to at least 2.46.5**
|
||
- **Run your 2.46.5 Bot** and make sure it works, and then **stop it**
|
||
- Close your old NadekoBot Updater
|
||
2. Get the new NadekoBot v3 Updater [here](https://dl.nadeko.bot/v3)
|
||
3. Click on the + icon to add a new bot
|
||
4. Next to the path, click on the folder icon and select the folder where your 2.46.5 bot is
|
||
- ℹ In case you're not sure where it's located, you can open your old updater and see it
|
||
5. If you've selected the correct path, you should have an **Update** button available, click it
|
||
6. You're done; you can now run your bot, and you can uninstall your old updater if you no longer have 2.x bots
|
||
7. 🎉
|
||
|
||
## Linux
|
||
|
||
1. In order to migrate a bot hosted on **Linux**, first update your current version to the latest 2.x version using the 2.x installer, run the bot, and make sure it works. Then:
|
||
- Run the **old** installer with `cd ~ && wget -N https://github.com/Kwoth/NadekoBot-BashScript/raw/1.9/linuxAIO.sh && bash linuxAIO.sh`
|
||
- Run option **1** again
|
||
- You **MUST** Run the bot now to ensure database is ready for migration
|
||
- Type `.stats` and ensure the version is `2.46.5` or later
|
||
- Stop the bot
|
||
2. Make sure your bot's folder is called `NadekoBot`
|
||
- Run `cd ~ && ls`
|
||
- Confirm there is a folder called NadekoBot (not nadekobot, in all lowercase)
|
||
3. Migrate your bot's data using the new installer:
|
||
- Run the **new** installer `cd ~ && wget -N https://gitlab.com/Kwoth/nadeko-bash-installer/-/raw/master/linuxAIO.sh && bash linuxAIO.sh`
|
||
- The installer should notify you that your data is ready for migration in a message above the menu.
|
||
- Install prerequisites (type `1` and press enter), and make sure it is successful
|
||
- Download NadekoBot v3 (type `2` and press enter)
|
||
- Run the bot (type `3` and press enter)
|
||
4. Make sure your permissions, custom reactions, credentials, and other data is preserved
|
||
- `.stats` to ensure owner id (credentials) is correct
|
||
- `.lcr` to see custom reactions
|
||
- `.lp` to list permissions
|
||
5. 🎉 Enjoy. If you want to learn how to update the bot, click [here](../linux-guide/#update-instructions)
|
||
|
||
## Manual
|
||
|
||
⚠ NOT RECOMMENDED
|
||
⚠ NadekoBot v3 requires [.net 5](https://dotnet.microsoft.com/download/dotnet/5.0)
|
||
|
||
1. In order to migrate a bot hosted **on Linux or from source on Windows**
|
||
- First update your current version to the latest 2.x version using the 2.x installer
|
||
- Then you **must** run the bot to prepare the database for the migration, and make sure the bot works prior to upgrade.
|
||
Then:
|
||
2. Rename your old nadeko bot folder to `nadekobot_2x`
|
||
- `mv NadekoBot nadekobot_2x`
|
||
3. Build the new version and move old data to the output folder
|
||
1. Clone the v3 branch to a separate folder
|
||
- `git clone https://gitlab.com/kwoth/nadekobot -b v3 --depth 1`
|
||
2. Build the bot
|
||
- `dotnet publish -c Release -o output/ src/NadekoBot/`
|
||
3. Copy old data
|
||
- ⚠ Be sure you copy the correct command for your system!
|
||
- **Windows:** `cp -r -fo nadekobot_2x/src/NadekoBot/data nadekobot/src/NadekoBot/data`
|
||
- **Linux:** `cp -rf nadekobot_2x/src/NadekoBot/data nadekobot/src/NadekoBot/data`
|
||
4. Copy the database
|
||
- `cp nadekobot_2x/src/NadekoBot/bin/Release/netcoreapp2.1/data/NadekoBot.db nadekobot/output/data`
|
||
5. Copy your credentials
|
||
- `cp nadekobot_2x/src/NadekoBot/credentials.json nadekobot/output/`
|
||
4. Run the bot
|
||
- `cd nadekobot/output`
|
||
- `dotnet NadekoBot.dll`
|
||
5. That's it. Just make sure that when you're updating the bot, you're properly backing up your old data.
|