Updating Zoraxy

Update Zoraxy

If you install Zoraxy natively on your host OS, here are the steps to update your Zoraxy to the latest version

Linux

Download and overwrite the binary file with the following command

# Stop the service if running
sudo systemctl stop zoraxy 

# Navigate to the zoraxy installation path. If you build from source, it is usually under ~/zoraxy/src/
cd ~/zoraxy/src
mv ./zoraxy ./zoraxy.backup

# Download the new zoraxy release. Change the filename to a suitable architecture based on your hardware.
wget https://github.com/tobychui/zoraxy/releases/latest/download/zoraxy_linux_amd64
mv ./zoraxy_linux_amd64 ./zoraxy
chmod +x ./zoraxy

# Restart the zoraxy service
sudo systemctl start zoraxy

Windows

If you are running Zoraxy on Windows, you can easily download and overwrite the executable.

1. Rename the current version of zoraxy.exe to zoraxy_backup.exe
2. Download zoraxy from release page
3. Move the newly downloaded zoraxy_windows_amd64.exe to the original instllation path
4. Rename zoraxy_windows_amd64.exe to zoraxy.exe
5. Start the bat file (if any) or double click the zoraxy exe file.

Updating Zoraxy (Docker)

Updating to v3.0.9

The automatic update system was introduced in v3.0.8 but it has some issue with docker installations. The following guide helps you to manually patch a few files for updating from pre-v3.0.8 versions of Zoraxy

1. Backup all config files under ./conf/
2. Pull the image of zoraxy:latest from docker hub
3. Start the container and stop if after it has started for around 5 minutes. This will give enough time for the upgrader to update the system to the latest config format.
4. Open the volume used by the container. If you are using Portainer, you can find the "Browse" button next to the volume id.

5. Download the config file

6. Open with a text editor like Notepad++. Fill in the missing "OriginIpOrDomain" filed under "ActiveOrigins" (if upgrade failed, this field will be empty string)

7. Save and upload it to the volume to replace the original file.
8. Repeat until all configs are updated.

Post-v3.0.9

For post v3.0.9, the internal update system should support skip version update by default. You can just pull the latest docker image to update your Zoraxy from v3.1.0 onward.

IMPORTANT NOTES

• Note that each version might have some slight startup flag change. See change log and release notes for more information
• Always backup your config before update. Some version might contain breaking change that will alter your config files