Update Buddy On-Premises regularly to stay up-to-date with new features, bug fixes, and improvements.

Checking the version

To check your version of Buddy and Buddy CLI, run:

sudo buddy version

Updating Buddy On-Premises

To udpate your Buddy instance, follow these steps:

  1. Sign in to the machine where Buddy On-Premises is installed.
  2. Stop the application:

    sudo buddy stop
  3. Run this command to check if an update is available:

    buddy update
  4. If a new version is available, Buddy shows the version number and instructions for getting the update.
  5. Download the new version.
  6. Start Buddy CLI. Run:

    sudo buddy
  7. Run this command to update your instance:

    sudo buddy update

The update can take several minutes. Don't close the terminal until the update is complete.

When you start the update, Buddy creates a backup, saves it into the default location, and removes older backups. You can change this behavior by using flags with the buddy update command. Read this document to learn more about backups.

Running out of space during the update

If the update procedure fails, it's usually because there's not enough disk space to complete the process.

Here's what you can do to successfully resume the installation:

  1. Free up the space on the disk where Buddy On-Premises is installed. Make sure to free at least double the amount your application occupies in ~/.buddy/app/data.
  2. Remove all backups in the ~/.buddy/app/backups directory except the latest file.
  3. Restore the application to the latest backup:

    sudo buddy restore
  4. Run the update again:

    sudo buddy update
If you’re low on space in the default install location, you can move the whole application to another location using Buddy CLI.