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

# Updating guide for installation before to 1.53

> Breaking changes and migration steps for upgrading to newer versions of Zylon starting with 1.53.0

<Warning>
  This guide is **required** before upgrading to Zylon 1.53.0 or any later version. Skipping these steps will cause Triton to fail to boot.
</Warning>

## What changed

Zylon 1.53.0 introduces two major platform changes that affect how you install and update your instance:

**All dependencies are bundled as part of the version**: Starting with 1.53.0, each Zylon version includes its own bundled dependencies, including the Apt packages, binaries, and drivers required to run that version. This means that when you install a specific Zylon version, you get the exact dependencies needed for that version without relying on the system's global state.

**New version, new requirements**: Zylon 1.53.0 requires CUDA 13.0, which is a significant change from previous versions. During the upgrade process, the CLI will automatically handle the CUDA update. This will be required to newer versions, so we decided to make this breaking change now to avoid a more disruptive upgrade later on.

***

## Before you begin

* Take a [backup of your instance](/en/operator-manual/operations/backup) before starting.
* Plan for approximately **45–60 minutes** of total upgrade time.
* Expect **\~35 minutes of GPU downtime** during which inference will not be available.
* Notify your users before starting — the system will be partially unavailable.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I still use 'sudo zylon-cli update'?">
    The command still exists but no longer manages version upgrades as of 1.53.0. Always use `sudo zylon-cli install <version>` to install or upgrade Zylon going forward. Now, this will act as `sudo zylon-cli sync`.
  </Accordion>

  <Accordion title="Will my data be affected?">
    No. The upgrade only affects the platform layer and drivers. Your knowledge base, chats, AI Documents, and configuration are not touched. We still recommend taking a [backup](/en/operator-manual/operations/backup) as a precaution.
  </Accordion>

  <Accordion title="What happens if I skip the CLI self-update?">
    **If Triton fails to boot after updating**, the most likely cause is that the CLI was not updated before running the install. You can confirm this by checking the CLI version:

    ```bash theme={null}
    sudo zylon-cli version
    ```

    And verifying if Triton is running:

    ```bash theme={null}
    sudo kubectl get pods -A | grep triton
    ```

    If the CLI is older than 2.0.0 and Triton is not showing 1/1 READY, then you likely ran into this issue. To recover your installation, simply follow the below guide.
  </Accordion>

  <Accordion title="My install is stuck">
    Installation can get stuck in a few scenarios:

    **`1. Stuck on an apt library (e.g. libc-bin)`**

    Stop the current install command, manually reinstall the problematic package, then retry:

    ```bash theme={null}
    sudo apt-get install --reinstall libc-bin
    sudo zylon-cli install <version>
    ```

    **`2. Stuck uninstalling NVIDIA drivers (e.g. nvidia-container-toolkit)`**

    Reboot the machine and retry. If the issue persists, please contact with Zylon. You can run the following command to do a faster check:

    ```bash theme={null}
    sudo zylon-cli install <version> --no-packages --no-binaries
    ```
  </Accordion>
</AccordionGroup>

***

## Migration steps

<Steps>
  <Step title="Upgrade the CLI">
    Run the CLI self-update to get Zylon CLI 2.0.0:

    ```bash theme={null}
    sudo zylon-cli self-update
    ```

    Verify the version before continuing:

    ```bash theme={null}
    sudo zylon-cli version
    # Expected: 2.0.0 or higher
    ```

    <Warning>
      Do not proceed to the next step until the CLI is on version 2.0.0. Installing >=1.53.0 with an older CLI will result in a broken installation.
    </Warning>
  </Step>

  <Step title="Reconfigure your instance">
    The new version will require you to regenerate your config file. You can do it in two ways:

    1. **Using the new wizard**: Run `sudo zylon-cli config init` and follow the prompts to set up your instance configuration again.
    2. **Just regenerate the config file**: If you don't want to go through the wizard, you can simply run `sudo zylon-cli config init -y` to regenerate the config file.
  </Step>

  <Step title="Install the new version">
    Use the new `install` command to upgrade Zylon:

    ```bash theme={null}
    sudo zylon-cli list-versions
    sudo zylon-cli install <version>
    ```

    This will automatically install the whole Zylon platform, including dependencies, and the new version. In future versions, the CLI will also handle its own updates, so you won't have to run `self-update` separately anymore.

    <Warning>
      The installation will stop with an error message after uninstalling the existing NVIDIA drivers:

      ```text theme={null}
      The current drivers were uninstalled successfully, please REBOOT the system 
      and re-run the installation to complete the NVIDIA driver installation
      ```

      **This is expected behavior.** Proceed to the next step to reboot your system, then re-run the installation command.
    </Warning>
  </Step>

  <Step title="Reboot the system">
    After seeing the uninstall message, reboot your system:

    ```bash theme={null}
    sudo reboot
    ```

    This is necessary before the new CUDA 13.0 drivers can be installed.
  </Step>

  <Step title="Complete the installation">
    After the system reboots, run the install command again:

    ```bash theme={null}
    sudo zylon-cli list-versions
    sudo zylon-cli install <version>
    ```

    This time, the installation will complete successfully with the new CUDA 13.0 drivers.
  </Step>
</Steps>