Upgrading to 1.55

Download the new model before upgrading. Automatic model pull is disabled by default in 1.55. If you run the platform update first, AI services will fail to start.

What changed

1.55 ships with a new default AI model family. Here’s what that means for your installation:

Qwen 3 is deprecated. All baseline presets now use Qwen 3.5.
Automatic model pull is disabled. The new model will not download on its own, so you must pull it manually before upgrading.
Vision presets are deprecated. Qwen 3.5 includes native image support, so alternatives.baseline-48g-vision and alternatives.baseline-96g-vision no longer exist. They are replaced by their standard baseline equivalents.
Monitoring infrastructure now enabled by default: monitoring: true is now the default. This deploys the monitoring stack (Prometheus, Grafana, node-exporter, k8s-monitoring) even if you previously opted out of metrics. No metrics are scraped or sent unless explicitly enabled, but the infrastructure will be deployed on your next update. If you want to avoid this, set the following in your values file:
observability: monitoring: false
See the Observability configuration for the full reference.

How to upgrade

If you need help, open a support ticket and our engineering team will assist you.

Step 1: Check your current preset

sudo cat /etc/zylon/zylon-conf.yaml | grep preset

Step 2: Find your new model

Use the table below to identify the model you need to download before upgrading. Standard presets

Current preset	Model to download
`baseline-24g`	`cyankiwi/qwen3.5-9b-awq-4bit`
`baseline-32g`	`cyankiwi/qwen3.5-9b-awq-4bit`
`baseline-48g`	`txn545/qwen3.5-35b-a3b-nvfp4`
`baseline-96g`	`cyankiwi/qwen3.5-27b-awq-4bit`

Vision presets (deprecated)

If you are on a vision preset, update your zylon-conf.yaml to the new preset before downloading the model.

Current preset	Change to	Model to download
`alternatives.baseline-48g-vision`	`baseline-48g`	`txn545/qwen3.5-35b-a3b-nvfp4`
`alternatives.baseline-96g-vision`	`baseline-96g`	`cyankiwi/qwen3.5-27b-awq-4bit`

Not sure what a preset means? See the AI Presets documentation.

Step 3: 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
sudo zylon-cli version

Download the model

Replace <model_id> with the value from the table above.

sudo zylon-cli models download <model_id>

Install 1.55

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

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

Update the CLI (required)

sudo zylon-cli self-update
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.55

sudo zylon-cli list-versions
sudo zylon-cli install 1.55.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
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.55 platform bundle

sudo zylon-cli list-versions

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

# Otherwise export a full bundle
sudo zylon-cli export 1.55.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.3.0 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.55.X --airgap

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

​What changed

​How to upgrade

​Step 1: Check your current preset

​Step 2: Find your new model

​Step 3: Download the model and upgrade

What changed

How to upgrade

Step 1: Check your current preset

Step 2: Find your new model

Step 3: Download the model and upgrade