How to migrate ISPConfig 3 multiserver master from Ubuntu 18.04 to Debian 12 (new server & new IP)?

Discussion in 'Installation/Configuration' started by czdavid, Nov 25, 2025 at 11:14 AM.

  1. czdavid

    czdavid Member

    Hello,

    I need to migrate the master server in my ISPConfig 3 multiserver setup.
    The current master runs on Ubuntu 18.04.6 LTS, and I plan to migrate it to a new server running Debian 12, which will also have a new IP address.

    What is the best way to approach this migration, please?

    My setup is as follows:

    • Master server: email, web, database, DNS

    • Slave server 1: secondary DNS only

    • Slave server 2: web and database only
    I would appreciate any advice or recommended steps for performing this migration safely.

    Thank you!
     
  2. pyte

    pyte Well-Known Member HowtoForge Supporter

  3. czdavid

    czdavid Member

    I want to use the migration tool – is it safe to transfer the master server from Ubuntu to Debian using the migration tool? Can the migration tool migrate the data and, after the migration is finished, update again (re-sync changed files, copy emails that arrive before the DNS change is completed)?
     
  4. pyte

    pyte Well-Known Member HowtoForge Supporter

    You may want to carefully read through the guide and see if that clears things up for you.
    https://www.howtoforge.com/tutorial...-confixx-plesk-to-ispconfig-31-single-server/

    In your case I would deploy the new machines, install ISPConfig and configure everything for the multiserver setup. After that I would set the old instance into maintaince mode so no changes can be made, then run the migration tool, validate the data and change whatever global DNS records you need to change.

    In case of E-Mail in might be a good idea to block traffic from the internet or stop the postfix/dovecot service during the migration to get a consistent state with the maildirs.
     
  5. czdavid

    czdavid Member

    Thank you!
    Since this is a production server, is it possible to perform the migration via the migration tool and then run another data synchronization afterwards (mainly emails)?
     
  6. pyte

    pyte Well-Known Member HowtoForge Supporter

    I think this is possible but I would rather go for the route I suggested. We just migrated ~1TB of maildirs, around 1000 mail users from an old system to a ISPConfig server flawlessly. The mails that got send from external during the migration are delayed, because we stopped the mail services but that was not an issue for us as we did this late on a weekend.
     
    till likes this.

Share This Page