Skip to content

Migrate Zoraxy to another Server

Toby Chui edited this page Apr 1, 2025 · 1 revision

Migration Guide for Zoraxy

Zoraxy is possibly the world most easiest reverse proxy in terms of migration.

Notes: This guide only cover the native deployment of Zoraxy. It is a bit more complex if you are using docker.

Move Zoraxy to new Linux server

  1. Stop the Zoraxy service using sudo systemctl stop zoraxy
  2. Use scp to download the whole Zoraxy directory from your old server to your local computer
  3. Upload the Zoraxy directory from your local computer to your new Linux server
  4. Setup systemd following the guide on this wiki page
  5. Start the Zoraxy service using sudo systemctl start zoraxy

Move Zoraxy to a new Windows server

  1. Stop the running Zoraxy instance by sending Ctrl + C into the terminal / cmd window that is running Zoraxy
  2. Copy the whole Zoraxy folder into an external USB drive, or other alternative methods which you can send the whole Zoraxy folder to your new Windows server
  3. Paste the whole Zoraxy folder from your external USB drive or other network storage into your final installation destination
  4. (Optional) Add the start.bat file to the startup folder of your Windows server
  5. Double click the start.bat file to start your Zoraxy

Move Zoraxy to servers with different OS (e.g. Windows to Linux) or CPU architecture (e.g. x86 to ARM)

  1. Follow the stop procedures mentioned in the above sections
  2. Check your Zoraxy version by using ./zoraxy --version or .\zoraxy.exe --version
  3. Follow the restore procedures mentioned in the above sections (Backup / Copy and Paste the Zoraxy folder into your new server)
  4. After file structures are restored, visit the release page of Zoraxy and find the exact same version of Zoraxy that your old system is using. Proceed to download the matching OS / architecture binary executable that your new server is using
  5. Replace the original binary executable with the new one that matches your new server CPU architecture and OS
  6. (Optional) set a correct permission for your newly donwloaded executable chmod +x ./zoraxy
  7. Follow the restart procedures mentioned in the above sections