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

All commands listed in the article must be run as root.

Checking the version

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

buddy version$

Updating Buddy On-Premises

To update your Buddy instance, follow these steps:

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

    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:

  7. Run this command to update your instance:

    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:

    buddy restore$
  4. Run the update again:

    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.

Last modified on September 8, 2022


Not sure how to configure a pipeline for your process? Reach out on the live-chat or contact support

Get Started

Sign up for free and deploy your project in less than 10 minutes.