Documentation Index
Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
Use this file to discover all available pages before exploring further.
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
How to upgrade
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 |
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 |
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
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
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
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-*.tarzylon-*.tarzylon-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
