nadekobot/docs/guides/migration-guide.md

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
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

Manual

⚠ NOT RECOMMENDED
⚠ NadekoBot v3 requires .net 5

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.