Upgrading to 1.57

Upcoming release — Zylon 1.58These docs are published ahead of release so you can prepare your API integrations. The release image is not yet available. For installations running 1.57, use the 1.57 documentation.

Before you start: identify the 1.57 models

Check ai.preset in /etc/zylon/zylon-conf.yaml on the machine you are upgrading. Find that preset in the 1.57 AI Presets Reference; its Models column lists the model IDs you need, including the embedding model. For a custom preset, use the model IDs in your preset configuration. Replace <model_id> throughout this guide with one of those IDs. Repeat each model download command for every model required by your preset. For a full-airgap installation, use the same IDs on the online and offline machines. This guide upgrades to 1.57, so use the linked 1.57 reference even if you are reading it from the upcoming documentation.

Step 1: Download the model and upgrade

Follow the steps for your installation type.

Online
Semi-Airgap
Full Airgap

Update the CLI (required)

sudo zylon-cli self-update

If the command fails or the version does not change, run the fallback installer:

curl -sL get.zylon.ai | sudo -E bash

sudo zylon-cli version

Download the model

Use the model IDs identified before these steps; download each required model.

sudo zylon-cli models download <model_id>

Install 1.57

sudo zylon-cli list-versions
sudo zylon-cli install 1.57.X

For full environment details and troubleshooting, see the Online update guide.

Update the CLI (required)

sudo zylon-cli self-update

If the command fails or the version does not change, run the fallback installer:

curl -sL get.zylon.ai | sudo -E bash

sudo zylon-cli version

Re-enable internet access

Temporarily allow online operations in your config, then apply it:

airgap:
  offlineOperation: false

sudo zylon-cli sync

Verify connectivity

sudo zylon-cli preflight --network -v

Download the model

sudo zylon-cli models download <model_id>

Install 1.57

sudo zylon-cli list-versions
sudo zylon-cli install 1.57.X

Re-enable offline mode

airgap:
  offlineOperation: true

sudo zylon-cli sync

For networking and proxy guidance, see the Semi-airgap update guide.

These steps run across two machines: an internet-connected machine for downloading, and the offline target machine.

Online machine: update the CLI (required)

sudo zylon-cli self-update

If the command fails or the version does not change, run the fallback installer:

curl -sL get.zylon.ai | sudo -E bash

sudo zylon-cli version

Online machine: download and export the model

sudo zylon-cli models download --no-install <model_id>
sudo zylon-cli models export

Online machine: prepare the CLI transfer package

sudo tar -czf zylon-update.tar.gz \
  /usr/local/bin/zylon-cli \
  /usr/local/bin/zylon-forge-cli

Online machine: export the 1.57 platform bundle

sudo zylon-cli list-versions

# Use --from if your current version is known (smaller bundle)
sudo zylon-cli export 1.57.X --from CURRENT_VERSION

# Otherwise export a full bundle
sudo zylon-cli export 1.57.X

Transfer artifacts to the offline machine

Move the required files across your transfer medium:

zylon-models-*.tar
zylon-*.tar
zylon-update.tar.gz

Offline machine: extract CLI transfer package

cd /tmp
sudo tar -xzf zylon-update.tar.gz -C /
sudo chmod +x /usr/local/bin/zylon-cli /usr/local/bin/zylon-forge-cli
sudo zylon-cli version  # It should show 2.6.3 or later

Offline machine: import and install

# Import the model, then install the model
sudo zylon-cli models import zylon-models-*.tar
sudo zylon-cli models download --offline <model_id>

# Import the Zylon bundle, check the new version is available, then install it
sudo zylon-cli import zylon-*.tar
sudo zylon-cli list-versions --offline
sudo zylon-cli install 1.57.X --airgap

For differential bundle details and transfer guidance, see the Full-airgap update guide.

​Before you start: identify the 1.57 models

​Step 1: Download the model and upgrade

Before you start: identify the 1.57 models

Step 1: Download the model and upgrade