Upgrade

Before you upgrade

Read the changelog.
Back up the data directory of the server.

At its first start, the new version changes the data directory. After that, an older version does not start with it, and shows this directory needs a newer Paron version. To go back to the older version, install it again and restore the backup.

Upgrade the server first, then the tunnels.

Upgrade the server

When the server stops, the open terminals close. The tunnels connect again after the server starts.

Run the installer again, then restart the server.

curl -fsSL https://paron.bovolato.dev/install.sh | sh
sudo systemctl restart paron-server

Run the installer again, then restart the server.

curl -fsSL https://paron.bovolato.dev/install.sh | sh
sudo launchctl kickstart -k system/dev.bovolato.paron.server

Windows cannot replace a program while it runs. In PowerShell as administrator, stop the server, run the installer again, then start the server.

Stop-Service paron-server
irm https://paron.bovolato.dev/install.ps1 | iex
Start-Service paron-server

docker compose -f docker-compose.server.yml pull
docker compose -f docker-compose.server.yml up -d

paron-server-init finds the data and stops with no change.

The tag latest is the newest release. To select a version, use its number as the tag, for example ghcr.io/nicolabovolato/paron:0.1.0.

Upgrade a tunnel

On each tunneled machine, do the same steps with the tunnel. The open terminals on the machine close, and the tunnel connects again.

curl -fsSL https://paron.bovolato.dev/install.sh | sh
sudo systemctl restart paron-tunnel

curl -fsSL https://paron.bovolato.dev/install.sh | sh
sudo launchctl kickstart -k system/dev.bovolato.paron.tunnel

Stop-Service paron-tunnel
irm https://paron.bovolato.dev/install.ps1 | iex
Start-Service paron-tunnel

docker compose -f docker-compose.tunnel.yml pull
docker compose -f docker-compose.tunnel.yml up -d

paron --version shows the installed version.