> ## 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.

# Upgrading to 1.57

> Steps to upgrade your Zylon installation to version 1.57.

### Step 1: Download the model and upgrade

Follow the steps for your installation type.

<Tabs>
  <Tab title="Online">
    <Steps>
      <Step title="Update the CLI (required)">
        ```bash theme={null}
        sudo zylon-cli self-update
        ```

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

        ```bash theme={null}
        curl -sL get.zylon.ai | sudo -E bash
        ```

        ```bash theme={null}
        sudo zylon-cli version
        ```
      </Step>

      <Step title="Download the model">
        Replace `<model_id>` with the value from the table above.

        ```bash theme={null}
        sudo zylon-cli models download <model_id>
        ```
      </Step>

      <Step title="Install 1.57">
        ```bash theme={null}
        sudo zylon-cli list-versions
        sudo zylon-cli install 1.57.X
        ```
      </Step>
    </Steps>

    For full environment details and troubleshooting, see the [Online update guide](/en/operator-manual/installation/online#updating-zylon).
  </Tab>

  <Tab title="Semi-Airgap">
    <Steps>
      <Step title="Update the CLI (required)">
        ```bash theme={null}
        sudo zylon-cli self-update
        ```

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

        ```bash theme={null}
        curl -sL get.zylon.ai | sudo -E bash
        ```

        ```bash theme={null}
        sudo zylon-cli version
        ```
      </Step>

      <Step title="Re-enable internet access">
        Temporarily allow online operations in your config, then apply it:

        ```yaml theme={null}
        airgap:
          offlineOperation: false
        ```

        ```bash theme={null}
        sudo zylon-cli sync
        ```
      </Step>

      <Step title="Verify connectivity">
        ```bash theme={null}
        sudo zylon-cli preflight --network -v
        ```
      </Step>

      <Step title="Download the model">
        ```bash theme={null}
        sudo zylon-cli models download <model_id>
        ```
      </Step>

      <Step title="Install 1.57">
        ```bash theme={null}
        sudo zylon-cli list-versions
        sudo zylon-cli install 1.57.X
        ```
      </Step>

      <Step title="Re-enable offline mode">
        ```yaml theme={null}
        airgap:
          offlineOperation: true
        ```

        ```bash theme={null}
        sudo zylon-cli sync
        ```
      </Step>
    </Steps>

    For networking and proxy guidance, see the [Semi-airgap update guide](/en/operator-manual/installation/semi-airgap#updating-zylon).
  </Tab>

  <Tab title="Full Airgap">
    These steps run across two machines: an internet-connected machine for downloading, and the offline target machine.

    <Steps>
      <Step title="Online machine: update the CLI (required)">
        ```bash theme={null}
        sudo zylon-cli self-update
        ```

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

        ```bash theme={null}
        curl -sL get.zylon.ai | sudo -E bash
        ```

        ```bash theme={null}
        sudo zylon-cli version
        ```
      </Step>

      <Step title="Online machine: download and export the model">
        ```bash theme={null}
        sudo zylon-cli models download --no-install <model_id>
        sudo zylon-cli models export
        ```
      </Step>

      <Step title="Online machine: prepare the CLI transfer package">
        ```bash theme={null}
        sudo tar -czf zylon-update.tar.gz \
          /usr/local/bin/zylon-cli \
          /usr/local/bin/zylon-forge-cli
        ```
      </Step>

      <Step title="Online machine: export the 1.57 platform bundle">
        ```bash theme={null}
        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
        ```
      </Step>

      <Step title="Transfer artifacts to the offline machine">
        Move the required files across your transfer medium:

        * `zylon-models-*.tar`
        * `zylon-*.tar`
        * `zylon-update.tar.gz`
      </Step>

      <Step title="Offline machine: extract CLI transfer package">
        ```bash theme={null}
        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
        ```
      </Step>

      <Step title="Offline machine: import and install">
        ```bash theme={null}
        # 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
        ```
      </Step>
    </Steps>

    For differential bundle details and transfer guidance, see the [Full-airgap update guide](/en/operator-manual/installation/airgap#updating-zylon).
  </Tab>
</Tabs>